4.7 KiB
dopbase-docker-binaire
Déploiement de Dopbase en docker-compose à partir du binaire officiel publié dans les releases GitHub. L'image reproduit les étapes de l'installeur officiel https://dopbase.com/install.sh, sans sa télémétrie.
Variante « compilée depuis les sources » : dopbase-docker-src.
Contenu
| Fichier | Rôle |
|---|---|
Dockerfile |
Téléchargement et vérification du binaire, puis image runtime Alpine |
docker-compose.yml |
Service dopbase, volume dopbase-data, healthcheck HTTP |
.env.example |
Variables à copier dans .env |
Installation
git clone git@gitea.vlab.bzh:vLab-BZH/dopbase-docker-binaire.git
cd dopbase-docker-binaire
cp .env.example .env
# éditer .env : DOPBASE_VERSION, DOPBASE_PUBLIC_URL, etc.
docker compose up -d --build
Les tags upstream n'ont pas de préfixe v : DOPBASE_VERSION=0.1.10. La valeur latest résout la dernière release au moment du build. Une version figée reste recommandée pour des builds reproductibles.
Le build prend quelques secondes : seul un téléchargement d'environ 9 Mo est nécessaire.
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_VERSION |
0.1.10 |
Tag de release à installer, ou latest |
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 2 étapes :
┌────────────────────────────────┐ ┌─────────────────────────┐
│ 1. fetch (alpine + curl) │ │ 2. runtime (alpine) │
│ checksums.txt + archive .tar.gz │ ──▶ │ ca-certificates │
│ SHA-256, extraction, --version │ │ user dopbase (10001) │
└────────────────────────────────┘ └─────────────────────────┘
- fetch, équivalent de
install.sh:- choix de l'architecture via
TARGETARCH(buildx) ouuname -m:amd64ouarm64; - résolution de la version (figée, ou
latestvia la redirectionreleases/latest) ; - téléchargement de
checksums.txtpuis dedopbase_<version>_linux_<arch>.tar.gz; - vérification SHA-256 de l'archive ;
- extraction du seul membre
dopbase(tar -xOzf), sans restaurer chemins ni permissions ; - contrôle que
dopbase --versionrenvoie exactementv<version>.
- choix de l'architecture via
- runtime : Alpine avec
ca-certificates(nécessaire pour les appels sortants, OIDC par exemple), binaire dans/usr/local/bin/dopbase, exécution en utilisateur non-rootdopbase(UID 10001, identique à la variante src). Écoute sur0.0.0.0:8840, données dans/data. Commande :dopbase server start.
Le binaire Linux officiel est un exécutable musl statique (static-pie, cible x86_64-unknown-linux-musl) : il n'a aucune dépendance glibc et tourne sur Alpine. L'UI d'admin Vue est embarquée dans le binaire.
Différences avec install.sh : pas de télémétrie Umami, pas d'installation dans ~/.local/bin.
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_VERSION dans .env, puis
docker compose up -d --build