# 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://124.local:8008`.

### Key Settings

- **Homeserver**: Points to local Synapse instance
- **Server name**: `124.local`
- **Brand**: "studio einszwovier Chat"
- **Default language**: German (DE)
- **Default theme**: Light mode
- **Guest access**: Enabled (users can preview without account)

## Access

- **URL**: `http://124.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://124.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 124.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**
