Gancio Deploy for NU31 Infra

This repository deploys gancio to the existing infra.

It contains:

• docker-stack.yml
• GitHub Actions deployment workflow
• minimal infra integration notes for v1.28.2

Files in this repository

• docker-stack.yml Swarm stack for the application
• .github/workflows/publish.yml build and deployment workflow

Infra dependencies

Before deploying, infra must already be running.

Required external networks:

• infra_reverse-proxy
• infra_postgres-net

Required services:

• caddy
• postgres-1

How to deploy Gancio on infra

1. Deploy infra

infra must already be deployed.

2. Create a PostgreSQL database and user

Create a dedicated PostgreSQL user and database:

CREATE USER gancio WITH PASSWORD 'change-me';
CREATE DATABASE gancio OWNER gancio;
GRANT ALL PRIVILEGES ON DATABASE gancio TO gancio;

Expected deployment parameters:

• DB_HOST=infra-postgres-1
• DB_PORT=5432
• DB_DATABASE=gancio
• DB_USERNAME=gancio
• DB_PASSWORD=<your-password>

3. Choose a domain

This setup uses events.nu31.space.

DNS must point to the server running infra.

4. Add a Caddy route

Add this block to infra/caddy/CaddyFile:

events.nu31.space {
    reverse_proxy * gancio_app:13120
}

Then redeploy infra.

5. Create a GitHub repository for deployment

Push this directory into a separate GitHub repository, for example nu31hackerspace/gancio-deploy.

6. Configure GitHub Secrets

Required secrets:

• HOST
• USERNAME
• ROOT_SSH_PRIVATE_KEY
• DB_HOST
• DB_PORT
• DB_DATABASE
• DB_USERNAME
• DB_PASSWORD

Optional:

• LOG_LEVEL

Example:

• HOST=65.109.28.227
• USERNAME=root
• DB_HOST=infra-postgres-1
• DB_PORT=5432
• LOG_LEVEL=info

7. Configure GitHub Variables

Optional:

• GANCIO_REPOSITORY
• GANCIO_REF

By default the workflow uses:

• repository: https://framagit.org/les/gancio.git
• ref: v1.28.2

If you want to pin a specific version, you can set:

• GANCIO_REF=v1.28.2
• or a commit SHA

8. Run the deployment

Push to main or run the Build and deploy Gancio workflow manually.

9. Verify the result

Checks:

• GitHub Actions status
• docker service ls
• docker service ps gancio_app
• gancio logs
• https://events.nu31.space
• initial setup page /setup/0

Important notes

• this deployment targets gancio v1.28.2
• v1.28.2 uses web setup and writes config.json into persistent storage
• app state is stored in the gancio-data Docker volume
• after the first deploy, open https://events.nu31.space and complete the web setup
• after setup, gancio exits once on purpose and must be restarted by Swarm
• config.json, uploads, logs, and user_locale are stored inside /home/node/data