124-webapp/element-web/README.md
2025-11-10 15:24:10 +01:00

2.1 KiB

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