So recently I've been workin to simplify my VPS setup, so I've been porting my services to Coolify. So far so good.

Self hosting Nerves Hub with Coolify

This will be very short with the steps needed to self host Nerves Hub with Coolify.

1. Add a new resource -> Choose postgres database

2. Start the database service

3. Create the database and give the user access to it

   • Go into the database service and click terminal, write the following commands
   • psql
   • CREATE DATABASE nerves_hub;
   • GRANT ALL PRIVILEGES ON DATABASE nerves_hub TO postgres;

4. Add a new resource -> Choose Docker Compose Empty

5. Edit Compose Filer -> Add this to the proxy section at Server -> Proxy -> Traefik -> Labels

   services:
     nerves_hub:
       restart: always
       image: ghcr.io/nerves-hub/nerves-hub
       volumes:
         - './nerves_hub_data:/app/uploads' # Saves the data to the hosts disk
       environment:
         - NERVES_HUB_APP=web
         - 'DATABASE_URL=${DATABASE_URL:-postgres://postgres:password@database:5432/nerves_hub}'
         - 'DATABASE_SSL=${DATABASE_SSL:-false}'
         - 'SECRET_KEY_BASE=${SECRET_KEY_BASE}'
         - 'LIVE_VIEW_SIGNING_SALT=${LIVE_VIEW_SIGNING_SALT}'
         - 'WEB_HOST=${WEB_HOST:-hub.example.com}'
         - 'FIRMWARE_UPLOAD_BACKEND=${FIRMWARE_UPLOAD_BACKEND:-local}'
         - 'FIRMWARE_UPLOAD_PATH=${FIRMWARE_UPLOAD_PATH:-/app/uploads}'
         - 'OPEN_FOR_REGISTRATIONS=${OPEN_FOR_REGISTRATIONS:-true}' # Allow users to register, set to false to disable
         - 'SMTP_SERVER=${SMTP_SERVER:-smtp.example.com}'
         - 'SMTP_USERNAME=${SMTP_USERNAME:-username}'
         - 'SMTP_PASSWORD=${SMTP_PASSWORD:-password}'
         - 'SMTP_PORT=${SMTP_PORT:-587}'
         - 'DEVICE_SHARED_SECRETS_ENABLED=${DEVICE_SHARED_SECRETS_ENABLED:-true}' # Allow devices to share secrets
       labels:
         - 'traefik.http.middlewares.sslheader.headers.customrequestheaders.X-Forwarded-Proto=https' # If this is not set, the app will not work
   

6. Update the necessary environment variables

   • Go into the postgres service and copy Postgres URL (internal). replace /postgres database from the end of the uri with /nerves_hub (or whatever you named your database)
   • Paste the uri into the DATABASE_URL environment variable
   • Update WEB_HOST to your domain
   • Update SECRET_KEY_BASE and LIVE_VIEW_SIGNING_SALT to random strings
   • Rest is optional, but recommended

7. Under services, click "Settings" and set your domain under domains.

   • You need to add :4000 to the end of the domain (or whatever port nerves hub is running on)

8. Start the service and you should be able to access the app at your domain.

Congratulations! You have now self hosted Nerves Hub.

You can use almost identical steps to self host barebones on a barebones server. If you have any questions, send me an email (you find my email in the front page of my website)