Linkwarden

Accès

1. Ouvrez http://<SERVER_IP>.
2. Cliquez sur « Sign Up ».
3. Créez le premier compte.
4. Le premier compte devient l'administrateur du serveur car NEXT_PUBLIC_ADMIN=1 est activé.

Inscription

L'inscription est activée par défaut.

Une fois le compte administrateur créé, vous pouvez désactiver l'inscription.

Pour la désactiver, modifiez /root/linkwarden/.env et définissez :

NEXT_PUBLIC_DISABLE_REGISTRATION=true

Appliquez ensuite la configuration :

cd /root/linkwarden
docker compose up -d

Chemins importants

• Chemin d'installation : /root/linkwarden
• Fichier Compose : /root/linkwarden/docker-compose.yml
• Fichier d'environnement : /root/linkwarden/.env
• Données de l'application : /root/linkwarden/data
• Données PostgreSQL : /root/linkwarden/pgdata
• Données Meilisearch : /root/linkwarden/meili_data
• Configuration Nginx : /etc/nginx/sites-available/linkwarden

Gestion de Docker

Vérifiez les conteneurs :

cd /root/linkwarden
docker compose ps

Voir les logs :

cd /root/linkwarden
docker compose logs -f

Consultez les journaux de Linkwarden :

cd /root/linkwarden
docker compose logs -f linkwarden

Redémarrer Linkwarden :

cd /root/linkwarden
docker compose restart linkwarden

Arrêtez la pile :

cd /root/linkwarden
docker compose down

Démarrez la pile :

cd /root/linkwarden
docker compose up -d

Gestion NGINX

Vérifiez NGINX :

systemctl status nginx

Testez la configuration :

nginx -t

Redémarrer NGINX :

systemctl restart nginx

Recharger NGINX :

systemctl reload nginx

Domaine et HTTPS

1. Créez un enregistrement A pour le nom d'hôte de votre application et faites-le pointer vers l'adresse IP publique de votre serveur (par exemple, app.example.com).

2. Installez Certbot :

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

3. Modifiez la configuration NGINX et remplacez server_name _; par votre domaine (par exemple, server_name app.example.com;):

vim /etc/nginx/sites-available/linkwarden

4. Testez la configuration :

nginx -t

5. Rechargez NGINX :

systemctl reload nginx

6. Émettez un certificat TLS :

certbot --nginx -d app.example.com

7. Mettez à jour les variables d'environnement de Linkwarden (.env fichier) :

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

8. Après avoir modifié les variables d'environnement, redémarrez Linkwarden :

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

9. Ouvrez votre navigateur et allez sur : https://app.example.com

Remarques

• Linkwarden est exposé publiquement via Nginx sur le port 80.
• L'application Linkwarden elle-même n'écoute que sur 127.0.0.1:3000.
• PostgreSQL et Meilisearch sont des services Docker internes et ne sont pas exposés directement à l'hôte.
• Lors de la configuration du domaine, veillez à remplacer http:// par https:// partout où l'URL de l'application est configurée, y compris NEXTAUTH_URL et BASE_URL.
• Utilisez le même domaine HTTPS de façon cohérente dans toute la configuration NGINX et Linkwarden.
• BASE_URL est particulièrement utile si vous utilisez des fonctions e-mail comme la réinitialisation de mot de passe ou les e-mails de vérification.
• Modifiez la configuration de Linkwarden selon vos préférences.