docs/deploy/dokploy.md
Dokploy
How player.findmalek.engineer runs: a Dokploy compose that pulls the image CI
publishes, redeployed by CI after every merge to main.
1. The compose
In Dokploy: Create Service → Compose, source Raw, and paste:
| 1 | services: |
| 2 | player: |
| 3 | image: ghcr.io/findmalek/keep-player:main # or :latest for releases only |
| 4 | restart: unless-stopped |
| 5 | environment: |
| 6 | NAVIDROME_URL: http://navidrome:4533 # Navidrome's service name on dokploy-network |
| 7 | TRUST_PROXY: "true" # behind Dokploy's Traefik |
| 8 | volumes: |
| 9 | - player-data:/data |
| 10 | read_only: true |
| 11 | tmpfs: [/tmp] |
| 12 | networks: [dokploy-network] |
| 13 | |
| 14 | volumes: |
| 15 | player-data: |
| 16 | |
| 17 | networks: |
| 18 | dokploy-network: |
| 19 | external: true |
Then Domains → Add domain: your host, service player, port 8080, HTTPS on. Deploy.
The GHCR package is public, so no registry login is needed. If you fork and keep yours private, add GHCR under
Settings → Registry with a token that has read:packages.
2. Deploy on every merge
- In the compose: Deployments → Webhook URL, copy it.
- In GitHub: Settings → Secrets and variables → Actions
- secret
DOKPLOY_WEBHOOK_URL: that URL - variable
PLAYER_URL:https://player.findmalek.engineer(optional: CI then waits until/api/healthanswers after each deploy, so a broken deploy turns the run red)
- secret
CI (.github/workflows/ci.yml) then, on every push to main: checks and tests, builds the amd64 + arm64 image,
pushes :main and :sha-…, calls the webhook (Dokploy pulls and restarts the container), and waits for health.
3. Releases
Merging the release PR that release-please keeps open tags vX.Y.Z and publishes :X.Y.Z, :X.Y and :latest.
It needs Settings → Actions → General → Allow GitHub Actions to create and approve pull requests.
Rolling back
Point the compose at an earlier :sha-… tag and redeploy, or redeploy an earlier deployment from Dokploy's list.