Docmost

Eine Open-Source-Software für kollaborative Wikis und Dokumentationen.

Zugriff auf Docmost

  1. Öffnen Sie Ihren Webbrowser und navigieren Sie zu: https://<SERVER_IP>
  2. Befolgen Sie die Anweisungen auf der Docmost-Einrichtungsseite, um Ihren Arbeitsbereich und Ihr Konto einzurichten.
  3. Nach erfolgreicher Einrichtung werden Sie zum Eigentümer des Arbeitsbereichs. Sie können dann andere Benutzer einladen, Ihrem Arbeitsbereich beizutreten.
  4. Für die Gesundheitsprüfung steht ein spezieller Endpunkt unter https://<SERVER_IP>/api/health.

Wichtige Dateien und Verzeichnisse

  • Anwendungsverzeichnis: /root/docmost
  • Umgebungsvariablen: /root/docmost/.env
  • Docker Compose-Datei: /root/docmost/docker-compose.yaml
  • Nginx-Konfiguration: /etc/nginx/sites-available/docmost.conf
  • Selbstsigniertes SSL-Zertifikat: /etc/nginx/ssl/
  • Persistente Daten: /var/lib/docker/volumes/ (docmost_db_data/, docmost_docmost/, docmost_redis_data/)

Docmost aktualisieren

Um auf die neueste Docmost-Version zu aktualisieren, führen Sie die folgenden Befehle aus:

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

Verwaltung von Docmost

Überprüfen Sie die laufenden Dienste:

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

Protokolle anzeigen:

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

Docmost-Container neu starten:

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

Nginx neu starten:

systemctl restart nginx

SSL mit einer Domain aktivieren

1. Richten Sie Ihre Domain auf die Server-IP aus.

2. Bearbeiten Sie die /root/docmost/.env Datei zum Festlegen Ihres Domainnamens: APP_URL=https://your.domain.com

3. Die Dienste neu erstellen:

cd /root/docmost/
docker compose up -d

4. Bearbeiten Sie die Nginx-Konfiguration und ersetzen Sie beide server_name <IP>; mit Ihrer Domain (<your-domain>) sowohl für HTTP- (Port 80) als auch für HTTPS-Blöcke (Port 443):

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

5. Certbot installieren:

apt install -y certbot python3-certbot-nginx

6. Führen Sie den folgenden Befehl aus, um ein gültiges Lets Encrypt-Zertifikat zu generieren:

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

7. Ersetzen Sie die SSL-Pfade in der Nginx-Konfiguration (TLS-Abschnitt):

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. Starten Sie Nginx neu, um die Änderungen zu übernehmen:

systemctl restart nginx

9. Öffnen Sie Ihren Browser und besuchen Sie: https://yourdomain.com

Anwendungsdetails