To deploy Belcoda, we recommend running it in Docker, using the provider docker-compose.yml.

This comes with a built in Redis, for caching, as well as Caddy, as a reverse proxy, and to manage SSL.

Process:

  1. Install Belcoda on your server, following the installation and configuration instructions above. Make sure the environment variables point to your production database. At startup, Belcoda will automatically run database migrations on your production database.
  2. Create a DNS record pointing to your server.
  3. Edit Caddyfile to ensure the correct domain name is listed. The existing docker-compose.yml is configured to manage DNS via Cloudflare. If you need a different provider, you will need to build Caddy with the correct plugin using xcaddy or pull a different image from Docker Hub and update the provided environment variables.
  4. Run docker compose up --build -d
  5. Belcoda should now be running on your server.