75 lines
2.1 KiB
Markdown
75 lines
2.1 KiB
Markdown
|
# Element Web - Matrix Client
|
||
|
|
|
||
|
|
Element Web is a browser-based Matrix client that connects to the studio einszwovier Matrix (Synapse) server.
|
||
|
|
|
||
|
|
## Configuration
|
||
|
|
|
||
|
|
The `config.json` file configures Element Web to connect to the local Synapse homeserver at `http://einszwovier.local:8008`.
|
||
|
|
|
||
|
|
### Key Settings
|
||
|
|
|
||
|
|
- **Homeserver**: Points to local Synapse instance
|
||
|
|
- **Server name**: `einszwovier.local`
|
||
|
|
- **Brand**: "studio einszwovier Chat"
|
||
|
|
- **Default language**: German (DE)
|
||
|
|
- **Default theme**: Light mode
|
||
|
|
- **Guest access**: Enabled (users can preview without account)
|
||
|
|
|
||
|
|
## Access
|
||
|
|
|
||
|
|
- **URL**: `http://einszwovier.local:8082`
|
||
|
|
- **No app required**: Works in any modern web browser
|
||
|
|
- **Mobile friendly**: Responsive design works on phones and tablets
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
1. Navigate to `http://einszwovier.local:8082`
|
||
|
|
2. Click "Sign In" or "Create Account"
|
||
|
|
3. Use existing Matrix credentials or create a new account
|
||
|
|
4. Join rooms (e.g., the print order room)
|
||
|
|
5. Chat, share files, and collaborate!
|
||
|
|
|
||
|
|
## Features
|
||
|
|
|
||
|
|
- ✅ End-to-end encryption
|
||
|
|
- ✅ File sharing and media uploads
|
||
|
|
- ✅ Read receipts and typing indicators
|
||
|
|
- ✅ Markdown formatting
|
||
|
|
- ✅ Voice and video calls (browser-to-browser)
|
||
|
|
- ✅ Room directory browsing
|
||
|
|
- ✅ Cross-device message sync
|
||
|
|
|
||
|
|
## Updates
|
||
|
|
|
||
|
|
Element Web is managed by Watchtower and updates automatically with the rest of the stack.
|
||
|
|
|
||
|
|
## Troubleshooting
|
||
|
|
|
||
|
|
**Can't connect to homeserver:**
|
||
|
|
|
||
|
|
- Ensure Synapse is running: `docker-compose ps synapse`
|
||
|
|
- Check Synapse logs: `docker-compose logs synapse`
|
||
|
|
- Verify hostname resolution: `ping einszwovier.local`
|
||
|
|
|
||
|
|
**Login fails:**
|
||
|
|
|
||
|
|
- Verify credentials with Matrix admin
|
||
|
|
- Check Synapse registration settings in `matrix/data/homeserver.yaml`
|
||
|
|
|
||
|
|
**Performance issues:**
|
||
|
|
|
||
|
|
- Element Web is resource-intensive for large rooms
|
||
|
|
- Consider using Hydrogen (lighter client) for low-end devices
|
||
|
|
- Clear browser cache and reload
|
||
|
|
|
||
|
|
## Security Notes
|
||
|
|
|
||
|
|
- Element Web runs on HTTP in the local network
|
||
|
|
- For production/internet exposure, configure HTTPS via reverse proxy
|
||
|
|
- User sessions are stored in browser local storage
|
||
|
|
- Encryption keys are managed client-side
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
**Maintained by studio einszwovier**
|