Menu du guide

Chargement…

Rien ne correspond à «  ».

Installer Obole

Obole est livré en une seule image, ghcr.io/alaibe/obole, qui fait tourner trois conteneurs : le serveur web, une file d’attente et un planificateur. Ils partagent un dossier storage qui contient la base SQLite et les justificatifs que vous déposez.

Créer le dossier

Sur le serveur, créez un dossier pour Obole avec un dossier storage dedans. Les conteneurs tournent avec l’utilisateur d’identifiant 1000 : donnez-lui ce propriétaire, sinon Docker le crée au nom de root et Obole ne peut pas y écrire.

mkdir -p obole/storage
sudo chown 1000:1000 obole/storage
cd obole

Le fichier compose

Enregistrez ceci sous le nom docker-compose.yml. Fixez l’image sur un tag daté, comme 2026.11.17, plutôt que latest : une mise à jour n’a lieu que quand vous la choisissez.

x-obole: &obole
  image: ghcr.io/alaibe/obole:2026.11.17
  restart: unless-stopped
  env_file: .env
  volumes:
    - ./storage:/var/www/html/storage

x-worker: &worker
  <<: *obole
  stop_signal: SIGTERM
  depends_on:
    - web

services:
  web:
    <<: *obole
    environment:
      - AUTORUN_ENABLED=true
    ports:
      - "127.0.0.1:8080:8080"

  queue:
    <<: *worker
    command: ["php", "/var/www/html/artisan", "queue:work"]

  scheduler:
    <<: *worker
    command: ["php", "/var/www/html/artisan", "schedule:work"]

Seul le conteneur web fait les étapes de démarrage : il migre la base de données. La file d’attente et le planificateur démarrent après lui. Faites pointer votre proxy inverse sur le port 8080.

Le fichier .env

Enregistrez ceci sous le nom .env à côté du fichier compose, avec vos propres valeurs :

APP_NAME=Obole
APP_ENV=production
APP_DEBUG=false
APP_URL=https://compta.example.fr
APP_KEY=

OBOLE_LICENSE_KEY=OBL-
OBOLE_VERSION=2026.11.17

MAIL_MAILER=smtp
MAIL_SCHEME=smtp
MAIL_HOST=smtp.example.fr
MAIL_PORT=587
MAIL_USERNAME=
MAIL_PASSWORD=
[email protected]
MAIL_FROM_NAME=Obole

Générez la clé de l’application une fois, et collez la ligne qu’elle affiche après APP_KEY= :

docker run --rm ghcr.io/alaibe/obole:2026.11.17 php artisan key:generate --show

Gardez la clé ailleurs

APP_KEY n’est pas dans le dossier storage, donc pas dans vos sauvegardes. Gardez une copie de .env hors du serveur, dans votre gestionnaire de mots de passe par exemple.

Configuration explique l’e-mail, la synchronisation bancaire et Stripe, qui sont facultatifs.

Le démarrer

docker compose up -d

Ouvrez ensuite votre APP_URL tout de suite et créez votre compte, puis votre entreprise. L’inscription n’est ouverte que tant qu’aucun compte n’existe : le premier compte créé est le vôtre, et personne ne peut en créer un autre après.

Si la clé de licence ne s’est pas activée, Paramètres › Licence dit pourquoi, et vous pouvez aussi y saisir la clé. Votre clé de licence donne les raisons habituelles.