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.