Linkwarden

Zugriff

1. Öffnen Sie http://<SERVER_IP>.
2. Klicken Sie auf „Sign Up“.
3. Legen Sie das erste Konto an.
4. Das erste Konto wird zum Server-Administrator, weil NEXT_PUBLIC_ADMIN=1 aktiviert ist.

Registrierung

Die Registrierung ist standardmäßig aktiviert.

Nach dem Anlegen des Administratorkontos können Sie die Registrierung deaktivieren.

Zum Deaktivieren bearbeiten Sie /root/linkwarden/.env und setzen Sie:

NEXT_PUBLIC_DISABLE_REGISTRATION=true

Wenden Sie dann die Konfiguration an:

cd /root/linkwarden
docker compose up -d

Wichtige Pfade

• Installationspfad: /root/linkwarden
• Compose-Datei: /root/linkwarden/docker-compose.yml
• Umgebungsdatei: /root/linkwarden/.env
• App-Daten: /root/linkwarden/data
• PostgreSQL-Daten: /root/linkwarden/pgdata
• Meilisearch-Daten: /root/linkwarden/meili_data
• Nginx-Konfiguration: /etc/nginx/sites-available/linkwarden

Docker-Verwaltung

Prüfen Sie die Container:

cd /root/linkwarden
docker compose ps

Logs ansehen:

cd /root/linkwarden
docker compose logs -f

Linkwarden-Logs anzeigen:

cd /root/linkwarden
docker compose logs -f linkwarden

Linkwarden neu starten:

cd /root/linkwarden
docker compose restart linkwarden

Stack stoppen:

cd /root/linkwarden
docker compose down

Stack starten:

cd /root/linkwarden
docker compose up -d

NGINX-Verwaltung

NGINX prüfen:

systemctl status nginx

Konfiguration testen:

nginx -t

NGINX neu starten:

systemctl restart nginx

NGINX neu laden:

systemctl reload nginx

Domain und HTTPS

1. Erstellen Sie einen A Eintrag für den Hostnamen Ihrer App und richten Sie ihn auf die öffentliche IP-Adresse Ihres Servers (z. B. app.example.com).

2. Installiere Certbot:

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

3. Bearbeiten Sie die NGINX-Konfiguration und ersetzen Sie server_name _; durch Ihre Domain (z. B. server_name app.example.com;):

vim /etc/nginx/sites-available/linkwarden

4. Testen Sie die Konfiguration:

nginx -t

5. Laden Sie NGINX neu:

systemctl reload nginx

6. Stellen Sie ein TLS-Zertifikat aus:

certbot --nginx -d app.example.com

7. Aktualisieren Sie die Umgebungsvariablen von Linkwarden (.env Datei):

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

8. Starten Sie Linkwarden nach dem Ändern der Umgebungsvariablen neu:

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

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

Hinweise

• Linkwarden wird über Nginx öffentlich bereitgestellt, auf Port 80.
• Die Linkwarden-Anwendung selbst lauscht nur auf 127.0.0.1:3000.
• PostgreSQL und Meilisearch sind interne Docker-Dienste und werden dem Host nicht direkt zugänglich gemacht.
• Achten Sie beim Einrichten der Domain darauf, zu ersetzen: http:// durch https:// überall dort, wo die Anwendungs-URL konfiguriert ist, einschließlich NEXTAUTH_URL und BASE_URL.
• Verwenden Sie in der gesamten NGINX- und Linkwarden-Konfiguration durchgängig dieselbe HTTPS-Domain.
• BASE_URL ist besonders nützlich, wenn Sie E-Mail-Funktionen wie Passwort-Resets oder Bestätigungsmails nutzen.
• Passen Sie die Linkwarden-Konfiguration nach Ihren Wünschen an.