Compilare dai sorgenti

Perché non trovi i binari su GitHub

Su GitHub Coste360 pubblica il codice sorgente e le istruzioni per compilarlo ed eseguirlo, non binari pronti. Per chi vuole qualcosa di pronto all’uso c’è l’immagine Docker pubblica e gratuita (ghcr.io/coste360/arenile, vedi Installazione con Docker); i pacchetti desktop per Windows, macOS e Linux si scaricano da arenile.app/download.

Il risultato della compilazione è un solo file eseguibile, statico (nessuna dipendenza di sistema, niente CGO), che contiene server, API, pannello e pagina pubblica.

Prerequisiti

Strumento	Versione
Go	1.27 o successiva
Node.js e npm	Node 22 o successivo, npm 10 o successivo
make	qualsiasi versione recente
git	per clonare il repository

In alternativa usa il devcontainer incluso nel repository (VS Code, GitHub Codespaces): ha già tutto.

Compilare

1. Clona il repository:

   git clone https://github.com/coste360/arenile.git
   cd arenile

2. Installa le dipendenze (una volta sola):

   make setup

3. Compila le due applicazioni web e il binario:

   make build

   make build compila il pannello e la pagina pubblica, li copia dentro il binario (internal/http/static) e produce bin/arenile.

4. Verifica:

   ./bin/arenile version

Compilare per un’altra architettura

Il binario è puro Go: puoi compilarlo per un Raspberry Pi o un server arm64 da qualsiasi computer, dopo aver compilato le applicazioni web con make web-build:

make web-build
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -trimpath \
  -ldflags "-s -w -X main.version=dev" -o arenile-arm64 ./cmd/arenile

Costruire l’immagine Docker in locale

make docker   # produce ghcr.io/coste360/arenile:dev

Eseguire il binario

Prova in locale

ARENILE_DEV=true ARENILE_DATA_DIR=./data ./bin/arenile serve

In modalità sviluppo ARENILE_BASE_URL è facoltativa e, se manca ARENILE_SECRET_KEY, una chiave viene generata, salvata in ./data/dev-secret.key e mostrata una volta all’avvio. Mai in produzione.

Produzione (systemd)

/etc/systemd/system/arenile.service

[Unit]
Description=Arenile
After=network-online.target

[Service]
User=arenile
EnvironmentFile=/etc/arenile/arenile.env
ExecStart=/usr/local/bin/arenile serve
Restart=on-failure
NoNewPrivileges=true
ProtectSystem=strict
ReadWritePaths=/var/lib/arenile

[Install]
WantedBy=multi-user.target

Nel file /etc/arenile/arenile.env imposta almeno ARENILE_BASE_URL, ARENILE_SECRET_KEY e ARENILE_DATA_DIR=/var/lib/arenile (permessi 600). Tutte le variabili sono in Configurazione.

Comandi del binario

arenile serve [--dev]                        avvia il server (migrazioni automatiche con ARENILE_AUTO_MIGRATE=true)
arenile migrate up|status                    applica o mostra lo stato delle migrazioni
arenile admin create --email E --name N --org O [--password P]
                                             crea un utente owner (password da ARENILE_ADMIN_PASSWORD o richiesta)
arenile seed demo                            carica lo stabilimento dimostrativo
arenile backup --out FILE                    backup consistente (SQLite)
arenile restore --in FILE                    ripristina un backup (server fermo)
arenile version                              mostra la versione

La configurazione si legge sempre dalle variabili d’ambiente ARENILE_* e DATABASE_URL.

Vuoi contribuire al codice?Ambiente di sviluppo, make check, convenzioni e CLA.