Linkwarden

Accesso

1. Apri http://<SERVER_IP>.
2. Clicca su "Sign Up".
3. Crea il primo account.
4. Il primo account diventa l'amministratore del server perché NEXT_PUBLIC_ADMIN=1 è abilitato.

Registrazione

La registrazione è abilitata per impostazione predefinita.

Dopo aver creato l'account amministratore, puoi disattivare la registrazione.

Per disattivarla, modifica /root/linkwarden/.env e imposta:

NEXT_PUBLIC_DISABLE_REGISTRATION=true

Poi applica la configurazione:

cd /root/linkwarden
docker compose up -d

Percorsi importanti

• Percorso di installazione: /root/linkwarden
• File Compose: /root/linkwarden/docker-compose.yml
• File di ambiente: /root/linkwarden/.env
• Dati dell'app: /root/linkwarden/data
• Dati PostgreSQL: /root/linkwarden/pgdata
• Dati Meilisearch: /root/linkwarden/meili_data
• Configurazione Nginx: /etc/nginx/sites-available/linkwarden

Gestione di Docker

Verifica i container:

cd /root/linkwarden
docker compose ps

Visualizza i log:

cd /root/linkwarden
docker compose logs -f

Visualizza i log di Linkwarden:

cd /root/linkwarden
docker compose logs -f linkwarden

Riavvia Linkwarden:

cd /root/linkwarden
docker compose restart linkwarden

Fermare lo stack:

cd /root/linkwarden
docker compose down

Avviare lo stack:

cd /root/linkwarden
docker compose up -d

Gestione NGINX

Verifica NGINX:

systemctl status nginx

Verifica la configurazione:

nginx -t

Riavvia NGINX:

systemctl restart nginx

Ricarica NGINX:

systemctl reload nginx

Dominio e HTTPS

1. Crea un record A per l'hostname della tua app e puntalo all'indirizzo IP pubblico del tuo server (per esempio, app.example.com).

2. Installa Certbot:

apt update
apt install -y certbot python3-certbot-nginx

3. Modifica la configurazione NGINX e sostituisci server_name _; con il tuo dominio (per esempio, server_name app.example.com;):

vim /etc/nginx/sites-available/linkwarden

4. Verifica la configurazione:

nginx -t

5. Ricarica NGINX:

systemctl reload nginx

6. Emetti un certificato TLS:

certbot --nginx -d app.example.com

7. Aggiorna le variabili d'ambiente di Linkwarden (.env file):

NEXTAUTH_URL=https://app.example.com/api/v1/auth
BASE_URL=https://app.example.com

8. Dopo aver modificato le variabili d'ambiente, riavvia Linkwarden:

cd /root/linkwarden
docker compose down
docker compose up -d

9. Apri il browser e vai a: https://app.example.com

Note

• Linkwarden è esposto pubblicamente tramite Nginx sulla porta 80.
• L'applicazione Linkwarden in sé ascolta solo su 127.0.0.1:3000.
• PostgreSQL e Meilisearch sono servizi Docker interni e non vengono esposti direttamente all'host.
• Quando configuri il dominio, assicurati di sostituire http:// con https:// ovunque sia configurato l'URL dell'applicazione, inclusi NEXTAUTH_URL e i piani BASE_URL.
• Usa lo stesso dominio HTTPS in modo coerente in tutta la configurazione di NGINX e Linkwarden.
• BASE_URL è particolarmente utile se usi funzioni email come il reset della password o le email di verifica.
• Modifica la configurazione di Linkwarden secondo le tue preferenze.