Aller au contenu principal

Démarrage rapide avec Docker Compose

Cette page lance un sol2flow auto-hébergé avec Docker Compose : l’application et une base de données PostgreSQL. Utilisez-la pour essayer sol2flow sur votre propre matériel. Pour un serveur de production, suivez ensuite Installation, qui ajoute HTTPS, l’e-mail et les sauvegardes.

Aucun serveur nécessaire

Pour utiliser sol2flow sans faire tourner de serveur, créez plutôt un compte cloud.

Ce qu’il vous faut​

  • Une machine avec Docker et le plugin Docker Compose (Linux, macOS ou Windows avec WSL 2).
  • Environ 1 Go de mémoire libre et quelques Go d’espace disque pour la base de données et les fichiers envoyés.
  • openssl (ou tout autre moyen de générer des secrets aléatoires).

1. Créer un dossier avec deux fichiers​

mkdir sol2flow && cd sol2flow

Créez compose.yml :

name: sol2flow
services:
  app:
    image: ghcr.io/sol2flow/sol2flow:${SOL2FLOW_VERSION:-latest}
    restart: unless-stopped
    env_file: .env
    environment:
      DATABASE_URL: postgresql://sol2flow:${POSTGRES_PASSWORD:-sol2flow}@db:5432/sol2flow?schema=public
    ports: ["3000:3000"]
    volumes: [uploads:/data/uploads]
    depends_on: { db: { condition: service_healthy } }
  db:
    image: postgres:18-alpine
    restart: unless-stopped
    environment: { POSTGRES_USER: sol2flow, POSTGRES_PASSWORD: "${POSTGRES_PASSWORD:-sol2flow}", POSTGRES_DB: sol2flow }
    volumes: [pgdata:/var/lib/postgresql] # from PostgreSQL 18 not …/data (data: …/18/docker)
    healthcheck: { test: ["CMD-SHELL", "pg_isready -U sol2flow"], interval: 5s, retries: 20 }
volumes: { pgdata: {}, uploads: {} }

Créez .env avec vos propres secrets et le premier administrateur :

cat > .env <<ENV
APP_URL=http://localhost:3000
AUTH_SECRET=$(openssl rand -base64 32)
APP_ENCRYPTION_KEY=$(openssl rand -base64 32)
POSTGRES_PASSWORD=$(openssl rand -hex 16)
[email protected]
BOOTSTRAP_ADMIN_USERNAME=admin
BOOTSTRAP_ADMIN_PASSWORD=choose-a-long-password
ENV

2. Démarrer​

docker compose up -d
docker compose logs -f app     # wait for "applying migrations", then the server start; Ctrl+C stops following

Le schéma de la base de données est créé automatiquement au premier démarrage.

3. Se connecter​

Ouvrez http://localhost:3000 et connectez-vous avec les valeurs BOOTSTRAP_ADMIN_USERNAME et BOOTSTRAP_ADMIN_PASSWORD de votre .env. Ce compte est le Propriétaire de l’instance. L’instance démarre vide : il n’y a pas d’autres comptes ni de données de démonstration. Ensuite :

  1. Créez votre premier espace et votre premier tableau.
  2. Ouvrez Administration pour consulter les paramètres de l’instance (Administration).
  3. Retirez BOOTSTRAP_ADMIN_PASSWORD de .env. Il n’est lu que tant que l’instance n’a aucun utilisateur.
E-mails

Par défaut, les e-mails (invitations, réinitialisations de mot de passe) sont écrits dans le journal de l’application au lieu d’être envoyés. Configurez SMTP avant d’inviter qui que ce soit.

Étapes suivantes​