Docker on Ubuntu

These commands run on the server, in a terminal (bash).

Install

1. Install Docker by following the official guide: https://docs.docker.com/engine/install/ubuntu/

2. Get Holdall and write your settings:

   git clone https://github.com/Toutourina0110/holdall.git
   cd holdall
   cp .env.example .env
   nano .env

   Set at least APP_URL and APP_SECRET (see Settings).

3. Start it:

   docker compose up -d --build

4. Open http://<server address>:3000. The first visit shows the setup page that creates the admin account.

The image contains Node, ffmpeg and yt-dlp (verified with its official checksum), runs as a non-root user, keeps data in the holdall-data volume mounted on /data, and reports its health on /api/health.

To reach Holdall with a domain name and HTTPS, put it behind a reverse proxy such as Caddy, Nginx or a Cloudflare Tunnel, then read Reverse proxy.

Update

cd holdall
git pull
docker compose up -d --build

Database migrations run automatically when the container starts. yt-dlp and ffmpeg are updated with the image, so update regularly: video websites change often.

Back up

Everything is in the holdall-data volume. To save it to holdall-backup.tgz in the current folder:

docker compose stop
docker run --rm -v holdall_holdall-data:/data -v "$PWD":/backup alpine tar czf /backup/holdall-backup.tgz -C /data .
docker compose start

To restore, stop Holdall, extract the archive into the volume the same way (tar xzf /backup/holdall-backup.tgz -C /data), then start it again.