This project is in public beta. It is not ready to be relied on; data loss and breaking changes are possible. Please do not put a real show on it yet. This document describes the beta as it stands and will change with it.
Plain-language guide for keeping FOSSStudio running. Almost everything lives in the dashboard - https://YOUR-DOMAIN/admin/ for the admin panel, https://YOUR-DOMAIN/host/ for hosts → System tab. This file is for when the dashboard itself is unreachable.
| I want to… | Where |
|---|---|
| Restart the studio | System tab → Restart studio |
| Make a backup right now | System tab → Back up now (runs daily automatically) |
| Restore a backup | System tab → backup list → restore icon, click twice |
| See what the server is doing | System tab → Recent log |
| Download everything I own | System tab → Download everything (zip) |
| Get recordings | Recordings tab → click the file names |
| Change my password / add 2FA | Security tab |
- Wait 5 minutes. It may just be restarting itself.
- SSH to the VPS:
ssh root@YOUR-SERVER - Restart everything:
cd /opt/fossstudio/current && docker compose -p fossstudio restart - Still broken? Look at the logs:
cd /opt/fossstudio/current && docker compose -p fossstudio logs --tail 100 - If it broke right after a deploy, roll back to the previous version
(from the dev machine, in the project folder):
FOSSSTUDIO_HOST=root@YOUR-SERVER ./scripts/rollback.sh
Backups are on the VPS at /opt/fossstudio/data/backups/.
ssh root@YOUR-SERVER
cd /opt/fossstudio/data
tar -xzf backups/backup-<pick-the-date-you-want>.tar.gz -C .
cd /opt/fossstudio/current && docker compose -p fossstudio restart app
Daily, keeping the last 5 by default (set how many under System - Backups): settings, theme, session list, login details, recording index. Not included: the recording media files themselves (they're big) - download the ones you care about from the Recordings tab and keep them somewhere safe.
- app - the studio itself (Node.js). Its data lives in
/opt/fossstudio/data. - caddy - handles the domain and HTTPS certificate. Renews itself. (Only there if you uncommented it; some installs put their own proxy in front instead.)
- coturn - helps guests behind strict firewalls connect.
- Deploys land in
/opt/fossstudio/releases/<timestamp>; the newest 5 are kept, andcurrentpoints at the live one. Rollback just pointscurrentat the previous release. - A restart during a take costs only the seconds nobody had uploaded yet. The server does no work on a recording after the fact, so there is never anything in flight for a deploy to interrupt.
A GitHub Actions job (in this repo, .github/workflows/uptime.yml)
pings the project's own instance every 15 minutes from outside and
emails the maintainer if it does not answer. It runs only on the
upstream repository. To watch your own studio the same way, fork it,
change the address and the repository check, and set your own SMTP
secrets in your repository settings - see the workflow file for the
names.