Déployer Outline sur Coolify et VPS Hetzner : tutoriel complet 2026

📍 Article principal du cluster : Outline 2026 : guide complet.

Trente minutes pour transformer un VPS vide en serveur Outline de production. Méthode validée chez plusieurs PME francophones d’Afrique de l’Ouest, avec coût total 4,51 € par mois pour 100 utilisateurs.

Prérequis

• Hetzner CX22 minimum (2 vCPU, 4 GB RAM) sous Ubuntu 22.04 / Debian 12.
• Coolify v4 installé.
• Nom de domaine DNS A : wiki.votre-entreprise.com.
• SMTP (Brevo ou Resend) pour invitations email.
• Niveau attendu : intermédiaire.
• Temps estimé : 30-45 minutes.

Étape 1 — DNS et MinIO

Créer DNS A : wiki.votre-entreprise.com → IP VPS. Vérifier dig +short wiki....

MinIO peut être déployé via Coolify aussi (Resources → MinIO). Bucket outline avec credentials notées.

Étape 2 — Service Outline dans Coolify

Resources → + New → Service → rechercher « Outline ». Coolify déploie le template officiel. Nom : outline-prod.

Étape 3 — Variables d’environnement

NODE_ENV=production
SECRET_KEY=générer-32-octets-hex (openssl rand -hex 32)
UTILS_SECRET=générer-32-octets-hex
URL=https://wiki.votre-entreprise.com
PORT=3000

DATABASE_URL=postgres://outline:password@outline-db:5432/outline
PGSSLMODE=disable
REDIS_URL=redis://outline-redis:6379

# Stockage S3-compatible
AWS_ACCESS_KEY_ID=minio-access-key
AWS_SECRET_ACCESS_KEY=minio-secret-key
AWS_REGION=us-east-1
AWS_S3_UPLOAD_BUCKET_URL=https://minio.votre-entreprise.com
AWS_S3_UPLOAD_BUCKET_NAME=outline
AWS_S3_FORCE_PATH_STYLE=true

# Email
SMTP_HOST=smtp-relay.brevo.com
SMTP_PORT=587
SMTP_USERNAME=login
SMTP_PASSWORD=clé-api
SMTP_FROM_EMAIL=wiki@votre-entreprise.com
SMTP_REPLY_EMAIL=support@votre-entreprise.com

# Authentication (start with email magic link)
EMAIL_LOGIN=true
DEPLOYMENT=production

Étape 4 — Domaine HTTPS

Onglet Domains : https://wiki.votre-entreprise.com. Force HTTPS ON.

Étape 5 — Lancer Deploy

Coolify pull outlinewiki/outline:latest, postgres:16, redis:7. Comptez 3-4 minutes.

Étape 6 — Premier compte

Ouvrir https://wiki.votre-entreprise.com. Page de signup : saisir email admin. Outline envoie un magic link, cliquer pour valider. Premier compte = admin du workspace.

Étape 7 — Créer la première collection

Sidebar → New Collection → nom (ex: « Engineering »), description, icône, couleur. Permissions : Members (équipe entière), Restricted (membres choisis). Créer plusieurs collections : Engineering, Marketing, Onboarding, Legal.

Étape 8 — Inviter les membres

Settings → Members → Invite people. Saisir emails (multiple OK), choisir rôle :

• Admin : full power.
• Member : créer/éditer dans collections accessibles.
• Viewer : lecture seule.

Étape 9 — Configurer SSO (optionnel mais recommandé)

Settings → Authentication → OIDC. Voir tutoriel SSO Authentik.

Étape 10 — Configurer les sauvegardes

# Cron quotidien /srv/scripts/outline-backup.sh
docker exec outline-db pg_dump -U outline outline | gzip > /tmp/outline-pg.gz
mc mirror minio/outline /backup/outline-files/
restic backup /tmp/outline-pg.gz /backup/outline-files
rm -f /tmp/outline-pg.gz

Erreurs fréquentes

Adaptation au contexte ouest-africain

Trois précisions. SMTP fiable : Brevo (300 emails/jour gratuit) ou Resend pour magic links instantanés. Mailgun fonctionne aussi mais plus cher. Stockage MinIO local : éviter S3 AWS pour souveraineté. MinIO sur même VPS Coolify ou Hetzner Storage Box S3-compatible. Backups : 6 heures critique car wiki = mémoire institutionnelle. Test restauration mensuel obligatoire.

Tutoriels frères

• SSO Authentik avec Outline
• Migrer de Notion ou Confluence

FAQ

Capacité CX22 ? 100 utilisateurs + 10k docs confortablement.

Maintenance ? 30 minutes par mois : update Docker image + vérification backups.

Multi-workspace ? Pas dans CE. Une instance = un workspace.

API ? REST documentée. Token via Settings → API.

Mises à jour ? Coolify : Pull image + Redeploy. Migration auto BD.

Pour aller plus loin

• 🔝 Retour au pilier : Guide complet Outline 2026
• Documentation : getoutline.com/developers