Docmost

Un software wiki collaborativo open source e di documentazione.

Accesso a Docmost

  1. Apri il browser web e vai all'indirizzo: https://<SERVER_IP>
  2. Segui la pagina di configurazione di Docmost che ti consentirà di configurare il tuo spazio di lavoro e il tuo account.
  3. Dopo aver completato con successo la configurazione, diventerai il proprietario dell'area di lavoro. Potrai quindi invitare altri utenti a unirsi alla tua area di lavoro.
  4. Per il controllo dello stato di salute, è disponibile un endpoint dedicato all'indirizzo https://<SERVER_IP>/api/health.

File e directory importanti

  • Directory dell'applicazione: /root/docmost
  • Variabili d'ambiente: /root/docmost/.env
  • File Docker Compose: /root/docmost/docker-compose.yaml
  • Configurazione Nginx: /etc/nginx/sites-available/docmost.conf
  • Certificato SSL autofirmato: /etc/nginx/ssl/
  • Dati persistenti: /var/lib/docker/volumes/ (docmost_db_data/, docmost_docmost/, docmost_redis_data/)

Aggiornamento di Docmost

Per eseguire l'aggiornamento all'ultima versione di Docmost, eseguire i seguenti comandi:

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

Gestione Docmost

Controllare i servizi in esecuzione:

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

Visualizza registri:

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

Riavvia i container Docmost:

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

Riavvia Nginx:

systemctl restart nginx

Abilitazione SSL con un dominio

1. Indirizza il tuo dominio all'IP del server.

2. Modifica il /root/docmost/.env file per impostare il tuo nome di dominio: APP_URL=https://your.domain.com

3. Ricreare i servizi:

cd /root/docmost/
docker compose up -d

4. Modifica la configurazione di Nginx e sostituisci entrambi server_name <IP>; con il tuo dominio (<your-domain>) sia per i blocchi HTTP (porta 80) che HTTPS (porta 443):

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

5. Installa Certbot:

apt install -y certbot python3-certbot-nginx

6. Esegui il seguente comando per generare un certificato Lets Encrypt valido:

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

7. Sostituire i percorsi SSL nella configurazione Nginx (sezione 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. Riavvia Nginx per applicare le modifiche:

systemctl restart nginx

9. Apri il browser e visita: https://yourdomain.com

Dettagli dell'applicazione