Installez SealRoute sur votre serveur

Prérequis

• Un hôte Linux (Ubuntu 22.04+ ou toute distribution moderne) avec au moins 2 Go de RAM et 10 Go de disque.
• Docker Engine (24+) et le plugin Docker Compose v2. Vérifiez avec :

  docker --version
  docker compose version

• Soit un domaine public (avec HTTPS en façade), soit simplement un port que vous contrôlez sur localhost. Le docker-compose.yml par défaut fournit un reverse proxy Caddy qui gère HTTPS automatiquement lorsque vous définissez HOST=your.domain.
• Une licence Aplindo. Vous pouvez aussi en acheter une directement depuis l'application en cours d'exécution à l'étape 5 ci-dessous.

Étape 1 - Téléchargez le fichier docker-compose

Créez un répertoire de travail et récupérez le fichier compose de production depuis le dépôt. Il câble déjà SealRoute, Postgres et 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

Si vous préférez cloner l'ensemble du paquet de déploiement : git clone https://github.com/sealroute/sealroute.git && cd sealroute. Dans les deux cas, les étapes suivantes sont les mêmes.

Étape 2 - Configurez votre environnement

SealRoute lit sa configuration à partir de variables d'environnement. Créez un fichier .env à côté de votre fichier compose. Le minimum nécessaire :

# 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 exemple plus complet avec des options facultatives se trouve dans .env.example.

Étape 3 - Démarrez la stack

Lancez SealRoute, Postgres et le reverse proxy en arrière-plan :

docker compose up -d

Observez les journaux de démarrage jusqu'à ce que vous voyiez Puma écouter sur tcp://0.0.0.0:3000 :

docker compose logs -f app

Le premier démarrage exécute aussi les migrations de la base de données. Sur un hôte de 2 Go, cela se termine généralement en moins d'une minute.

Étape 4 - Configuration initiale

Ouvrez l'application dans votre navigateur. Comme il n'y a pas encore d'utilisateurs, SealRoute vous redirige vers la page /setup. C'est ici que vous créez le premier compte administrateur et les métadonnées de votre compte.

Renseignez :

• Prénom / Nom - votre nom en tant que premier administrateur.
• E-mail - c'est l'identifiant de connexion de l'administrateur et l'endroit où les notifications de signature seront envoyées.
• Nom de l'entreprise - affiché aux signataires dans les e-mails et sur la page de signature.
• Mot de passe - au moins 8 caractères, un mélange de lettres et de chiffres est recommandé.
• URL de l'application - préremplie à partir de APP_URL dans votre .env. Utilisée pour générer des liens de signature dans les e-mails.
• Langue - langue d'interface par défaut pour les nouveaux soumissionnaires.

Cliquez sur Soumettre. SealRoute crée le compte, vous connecte et vous redirige vers la page /license.

Étape 5 - Achetez une licence

Une instance SealRoute auto-hébergée a besoin d'une licence active pour débloquer les écrans connectés. La page /license comporte deux cartes : Acheter une licence en haut et Activer une licence en dessous.

Dans la carte Acheter une licence, définissez le nombre de sièges dont vous avez besoin. Le prix unitaire provient de votre paramètre APLINDO_LICENSE_DEFAULT_AMOUNT_IDR (actuellement IDR 1.499.000 par siège), et le total se recalcule automatiquement lorsque vous modifiez le nombre de sièges.

Cliquez sur Acheter une licence. SealRoute ouvre une fenêtre modale avec l'iframe de paiement Aplindo. Effectuez le paiement à cet endroit. Une fois la transaction réussie, Aplindo envoie la clé de licence par e-mail à l'adresse que vous avez saisie, et la même clé est également affichée sur la page de succès du paiement.

Étape 6 - Activez votre licence

Copiez la clé de licence depuis la page de succès ou votre e-mail, puis collez-la dans la carte Activer une licence sur /license :

Cliquez sur Activer. SealRoute appelle le serveur de licences Aplindo, lie la clé à cette machine et recharge. Vous verrez la carte Licence actuelle en haut avec le statut active, le slug du produit, l'ID de licence, l'ID de machine, la date d'expiration et l'horodatage du dernier heartbeat.

SealRoute planifie une tâche de heartbeat qui revérifie la licence auprès d'Aplindo toutes les APLINDO_LICENSE_HEARTBEAT_SECONDS secondes (par défaut : toutes les heures). Si la licence est révoquée ou expire, le prochain heartbeat le reflétera.

Étape 7 - Vous avez terminé

SealRoute est maintenant pleinement opérationnel. Visitez / et vous arriverez sur le tableau de bord vide des modèles de documents, prêt pour votre premier téléversement.