The Lounge — Runbook
User Management
Add a user
ssh -i ~/.ssh/homelab_claude [email protected] \
"pct exec 118 -- docker exec -u node thelounge thelounge add <username> --password <password> --save-logs"
List users
ssh -i ~/.ssh/homelab_claude [email protected] \
"pct exec 118 -- docker exec -u node thelounge thelounge list"
Reset a user password
ssh -i ~/.ssh/homelab_claude [email protected] \
"pct exec 118 -- docker exec -u node thelounge thelounge reset <username>"
Logs
| Log | Contents | Location | Loki query | Format |
|---|---|---|---|---|
| Application | IRC connections, user sessions, network events, errors | Docker (LXC 118) stdout | {job="tools", container="thelounge"} |
Plain text |
| OAuth2 Proxy | Auth events for web UI access | Docker (LXC 119) stdout | {job="infra-apps", container="oauth2-proxy-the-lounge"} |
Plain text |
Notes:
- The container name is thelounge (no hyphen), not the-lounge
- The Lounge produces very little stdout — check the OAuth2 proxy logs for access/auth issues first
- SSH fallback: ssh [email protected] "pct exec 118 -- docker logs thelounge" / ssh [email protected] "pct exec 119 -- docker logs oauth2-proxy-the-lounge"
Troubleshooting
User can't connect to IRC networks
- Check The Lounge logs for connection errors to IRC servers
- Verify IRC network config in the user's profile settings in the web UI