Docmost

Un logiciel wiki et de documentation collaboratif open source.

Accéder à Docmost

  1. Ouvrez votre navigateur Web et rendez-vous à l'adresse suivante : https://<SERVER_IP>
  2. Suivez les instructions de la page de configuration Docmost qui vous permettra de configurer votre espace de travail et votre compte.
  3. Une fois la configuration réussie, vous deviendrez le propriétaire de l'espace de travail. Vous pourrez alors inviter d'autres utilisateurs à rejoindre votre espace de travail.
  4. Pour vérifier l'état de santé, un point de terminaison dédié est disponible à l'adresse https://<SERVER_IP>/api/health.

Fichiers et répertoires importants

  • Répertoire des applications : /root/docmost
  • Variables d'environnement : /root/docmost/.env
  • Fichier Docker Compose : /root/docmost/docker-compose.yaml
  • Configuration Nginx : /etc/nginx/sites-available/docmost.conf
  • Certificat SSL auto-signé : /etc/nginx/ssl/
  • Données persistantes : /var/lib/docker/volumes/ (docmost_db_data/, docmost_docmost/, docmost_redis_data/)

Mise à niveau de Docmost

Pour passer à la dernière version de Docmost, exécutez les commandes suivantes :

cd /root/docmost
docker pull docmost/docmost:latest
docker compose up --force-recreate --build docmost -d

Gestion de Docmost

Vérifier les services en cours d'exécution :

docker compose -f /root/docmost/docker-compose.yaml ps

Afficher les journaux :

docker compose -f /root/docmost/docker-compose.yaml logs -f

Redémarrer les conteneurs Docmost :

docker compose -f /root/docmost/docker-compose.yaml restart

Redémarrer Nginx :

systemctl restart nginx

Activation du protocole SSL avec un domaine

1. Pointez votre domaine vers l'adresse IP du serveur.

2. Modifier le /root/docmost/.env fichier pour définir votre nom de domaine : APP_URL=https://your.domain.com

3. Recréer les services :

cd /root/docmost/
docker compose up -d

4. Modifiez la configuration Nginx et remplacez les deux server_name <IP>; avec votre domaine (<your-domain>) pour les blocs HTTP (port 80) et HTTPS (port 443) :

vim /etc/nginx/sites-available/docmost.conf

5. Installez Certbot :

apt install -y certbot python3-certbot-nginx

6. Exécutez la commande suivante pour générer un certificat Lets Encrypt valide :

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

7. Remplacer les chemins SSL dans la configuration Nginx (section TLS) :

vim /etc/nginx/sites-available/docmost.conf
# Before:
    # ssl_certificate /etc/nginx/ssl/fullchain.pem;
    # ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
    # ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    # ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

8. Redémarrez Nginx pour appliquer les modifications :

systemctl restart nginx

9. Ouvrez votre navigateur et rendez-vous sur : https://yourdomain.com

Détails de la demande