dopbase-docker-src
Déploiement de Dopbase en docker-compose. Le dépôt upstream ne fournit pas de Dockerfile de production : l'image est construite ici depuis les sources.
Variante plus légère à partir du binaire officiel : dopbase-docker-binaire.
Testé : build OK et conteneur healthy avec DOPBASE_REF=0.1.10.
(... merci Jarvis :))
Contenu
| Fichier | Rôle |
|---|---|
Dockerfile |
Build multi-stage depuis les sources GitHub |
docker-compose.yml |
Service dopbase, volume dopbase-data, healthcheck |
.env.example |
Variables à copier dans .env |
Installation
git clone git@gitea.vlab.bzh:vLab-BZH/dopbase-docker-src.git
cd dopbase-docker-src
cp .env.example .env
# éditer .env : DOPBASE_REF=0.1.10 (version figée, recommandé), DOPBASE_PUBLIC_URL, etc.
docker compose up -d --build
Les tags upstream n'ont pas de préfixe v : utiliser DOPBASE_REF=0.1.10, pas v0.1.10. main construit la dernière version de développement.
Premier démarrage
docker compose logs dopbase
Au premier démarrage, Dopbase affiche dans les logs un token / lien de setup. L'interface d'admin redirige vers /setup tant que le compte root n'est pas créé.
Alternative : renseigner DOPBASE_ROOT_EMAIL dans .env avant le premier démarrage. Le compte root est alors créé directement, avec un mot de passe généré affiché une seule fois dans les logs.
Vérification
docker compose ps # état healthy attendu
curl http://localhost:8840/api/v1/health
Variables (.env)
| Variable | Défaut | Description |
|---|---|---|
DOPBASE_REF |
main |
Branche ou tag de dopbase/dopbase à construire |
DOPBASE_PORT |
8840 |
Port publié sur l'hôte |
DOPBASE_PUBLIC_URL |
http://localhost:8840 |
URL vue par les clients (lien de setup, CLI). À adapter derrière un reverse proxy |
DOPBASE_ROOT_EMAIL |
vide | Optionnel : crée le root sans passer par le setup web |
DOPBASE_TRUSTED_PROXIES |
vide | IP/CIDR du reverse proxy, pour des logs d'audit corrects |
Architecture du Dockerfile
Build multi-stage en 4 étapes :
┌──────────────┐ ┌──────────────────┐ ┌────────────────────┐ ┌──────────────────────┐
│ 1. src │──▶│ 2. admin-ui │──▶│ 3. builder │──▶│ 4. runtime │
│ alpine/git │ │ oven/bun:1 │ │ rust:1.98-bookworm │ │ debian:bookworm-slim │
│ git clone │ │ bun build:ui │ │ cargo build │ │ binaire seul │
│ DOPBASE_REF │ │ → dist/ (Vite) │ │ UI embarquée │ │ user dopbase (10001) │
└──────────────┘ └──────────────────┘ └────────────────────┘ └──────────────────────┘
- src : clone shallow de
github.com/dopbase/dopbaseà la refDOPBASE_REF. - admin-ui : installation des dépendances (
bun install --frozen-lockfile) et build de l'UI d'admin (Vue/Vite) versdist/. - builder : compilation du binaire Rust en release (
--locked), avecdist/embarqué dans le binaire. Disposition reprise deapp/Dockerfile.testupstream. - runtime : Debian slim avec
ca-certificatesuniquement, binaire copié dans/usr/local/bin/dopbase, exécution en utilisateur non-rootdopbase(UID 10001). Écoute sur0.0.0.0:8840, données dans/data. Commande :dopbase server start.
L'image finale ne contient ni toolchain Rust, ni Bun, ni les sources.
Données et sauvegarde
Le volume dopbase-data (/data) contient la base SQLite, master.key et les sauvegardes .dop. Sauvegarder le volume, et conserver master.key séparément de la base.
Exposition réseau
Par défaut le port est publié sur toutes les interfaces de l'hôte. Pour un accès réseau, placer un reverse proxy TLS devant (recommandé par la doc upstream) et renseigner DOPBASE_PUBLIC_URL et DOPBASE_TRUSTED_PROXIES. Pour limiter à l'hôte local, préfixer le mapping par 127.0.0.1: dans docker-compose.yml.
Mise à jour
# changer DOPBASE_REF dans .env, puis
docker compose up -d --build