Installa SealRoute sul tuo server

Prerequisiti

• Un host Linux (Ubuntu 22.04+ o qualsiasi distribuzione moderna) con almeno 2 GB di RAM e 10 GB di disco.
• Docker Engine (24+) e il plugin Docker Compose v2. Verifica con:

  docker --version
  docker compose version

• Un dominio pubblico (con HTTPS in front) oppure semplicemente una porta che controlli su localhost. Il docker-compose.yml predefinito include un reverse proxy Caddy che gestisce HTTPS automaticamente quando imposti HOST=your.domain.
• Una licenza Aplindo. Puoi anche acquistarne una direttamente dall'app in esecuzione al passaggio 5 qui sotto.

Passaggio 1 - Scarica il file docker-compose

Crea una directory di lavoro e scarica il file compose di produzione dal repository. Collega già SealRoute, Postgres e Caddy.

mkdir sealroute && cd sealroute
curl -L https://raw.githubusercontent.com/sealroute/sealroute/main/docker-compose.yml -o docker-compose.yml
curl -L https://raw.githubusercontent.com/sealroute/sealroute/main/deploy.sh         -o deploy.sh
chmod +x deploy.sh

Se preferisci clonare l'intero pacchetto di deploy: git clone https://github.com/sealroute/sealroute.git && cd sealroute. In ogni caso, i passaggi successivi sono gli stessi.

Passaggio 2 - Configura il tuo ambiente

SealRoute legge la sua configurazione dalle variabili d'ambiente. Crea un file .env accanto al tuo file compose. Il minimo necessario:

# Where the app is reachable from a browser. Use https://your.domain in
# production or http://localhost:3000 for a local trial.
APP_URL=https://your.domain
HOST=your.domain

# Generate with `openssl rand -hex 64` and keep it secret.
SECRET_KEY_BASE=replace-me-with-a-long-random-string

# --- Aplindo licensing ------------------------------------------------------
APLINDO_LICENSE_API_URL=https://license.aplindo.com
APLINDO_LICENSE_PRODUCT_SLUG=SealRoute
APLINDO_LICENSE_DEFAULT_AMOUNT_IDR=5000000.00
APLINDO_LICENSE_HEARTBEAT_SECONDS=3600

Un esempio più completo con opzioni facoltative si trova in .env.example.

Passaggio 3 - Avvia lo stack

Avvia SealRoute, Postgres e il reverse proxy in background:

docker compose up -d

Osserva i log di avvio finché non vedi Puma in ascolto su tcp://0.0.0.0:3000:

docker compose logs -f app

Il primo avvio esegue anche le migrazioni del database. Su un host da 2 GB questo si completa di solito in meno di un minuto.

Passaggio 4 - Configurazione iniziale

Apri l'app nel browser. Poiché non ci sono ancora utenti, SealRoute ti reindirizza alla pagina /setup. Qui crei il primo account amministratore e i metadati del tuo account.

Compila:

• Nome / Cognome - il tuo nome come primo amministratore.
• E-mail - è l'accesso dell'amministratore e dove verranno inviate le notifiche di firma.
• Nome dell'azienda - mostrato ai firmatari nelle e-mail e sulla pagina di firma.
• Password - almeno 8 caratteri, si consiglia un mix di lettere e numeri.
• URL dell'app - precompilato da APP_URL nel tuo .env. Usato per generare i link di firma nelle e-mail.
• Lingua - lingua dell'interfaccia predefinita per i nuovi firmatari.

Fai clic su Invia. SealRoute crea l'account, ti fa accedere e ti reindirizza alla pagina /license.

Passaggio 5 - Acquista una licenza

Un'istanza SealRoute self-hosted necessita di una licenza attiva per sbloccare le schermate dopo l'accesso. La pagina /license ha due schede: Acquista licenza in alto e Attiva licenza sotto.

Nella scheda Acquista licenza, imposta il numero di postazioni di cui hai bisogno. Il prezzo unitario proviene dalla tua impostazione APLINDO_LICENSE_DEFAULT_AMOUNT_IDR (attualmente IDR 1.499.000 per postazione), e il totale viene ricalcolato automaticamente quando modifichi il numero di postazioni.

Fai clic su Acquista licenza. SealRoute apre una finestra modale con l'iframe di checkout di Aplindo. Completa il pagamento lì. Una volta che la transazione ha esito positivo, Aplindo invia la chiave di licenza via e-mail all'indirizzo che hai inserito, e la stessa chiave viene mostrata anche nella pagina di esito positivo del checkout.

Passaggio 6 - Attiva la tua licenza

Copia la chiave di licenza dalla pagina di esito positivo o dalla tua e-mail, poi incollala nella scheda Attiva licenza su /license:

Fai clic su Attiva. SealRoute contatta il server di licenze Aplindo, vincola la chiave a questa macchina e ricarica. Vedrai la scheda Licenza attuale in alto con stato active, lo slug del prodotto, l'ID licenza, l'ID macchina, la data di scadenza e il timestamp dell'ultimo heartbeat.

SealRoute pianifica un job di heartbeat che ricontrolla la licenza con Aplindo ogni APLINDO_LICENSE_HEARTBEAT_SECONDS secondi (predefinito: ogni ora). Se la licenza viene revocata o scade, il successivo heartbeat lo rifletterà.

Passaggio 7 - Hai finito

SealRoute è ora pienamente operativo. Visita / e arriverai alla dashboard vuota dei Modelli di Documento, pronta per il tuo primo caricamento.