Access
- Open the Web UI:
https://<SERVER-IP>:4747 - gonic uses HTTPS with a self-signed certificate. Your browser will display a certificate warning the first time you connect.
- Log in with the default credentials:
admin/admin - Change the default password immediately after your first login.
Subsonic Clients
Use the following server address in your Subsonic-compatible client: https://<SERVER-IP>:4747
Because the server uses a self-signed certificate, your client must allow or trust the certificate.
The certificate is located at: /root/gonic/tls/cert.pem
You can copy it to another device with:
scp root@<SERVER-IP>:/root/gonic/tls/cert.pem .
Use the appropriate gonic username and password to authenticate with your Subsonic client.
Important Files & Directories
- Install Path:
/root/gonic - Compose File:
/root/gonic/docker-compose.yml - Environment File:
/root/gonic/.env - Database:
/root/gonic/data/gonic.db - Music:
/root/gonic/music - Podcasts:
/root/gonic/podcasts - Playlists:
/root/gonic/playlists - Cache:
/root/gonic/cache - TLS Certificate:
/root/gonic/tls/cert.pem - TLS Key:
/root/gonic/tls/key.pem
Service Management
View running containers:
docker compose -f /root/gonic/docker-compose.yml ps
Restart containers:
docker compose -f /root/gonic/docker-compose.yml restart
View logs:
cd /root/gonic && docker compose logs -f
Stop containers:
docker compose -f /root/gonic/docker-compose.yml stop
Start containers:
docker compose -f /root/gonic/docker-compose.yml start
Recreate containers:
docker compose -f /root/gonic/docker-compose.yml up -d
Notes
- The music directory is mounted read-only inside the container, preventing gonic from modifying your music files.
- The database file
/root/gonic/data/gonic.dbshould be included in your backups. - The cache can be deleted if necessary; it contains regenerated transcodes and cover art.
- Configure gonic and its scanning behavior according to your preferences in
/root/gonic/docker-compose.yml.
