Linkwarden

Toegang

1. Open http://<SERVER_IP>.
2. Klik op 'Sign Up'.
3. Maak het eerste account aan.
4. Het eerste account wordt de serverbeheerder omdat NEXT_PUBLIC_ADMIN=1 ingeschakeld is.

Registratie

Registratie staat standaard aan.

Nadat het beheerdersaccount is aangemaakt, kunt u registratie uitschakelen.

Bewerk om dit uit te schakelen /root/linkwarden/.env en stel in:

NEXT_PUBLIC_DISABLE_REGISTRATION=true

Pas daarna de configuratie toe:

cd /root/linkwarden
docker compose up -d

Belangrijke paden

• Installatiepad: /root/linkwarden
• Compose-bestand: /root/linkwarden/docker-compose.yml
• Omgevingsbestand: /root/linkwarden/.env
• App-gegevens: /root/linkwarden/data
• PostgreSQL-gegevens: /root/linkwarden/pgdata
• Meilisearch-gegevens: /root/linkwarden/meili_data
• Nginx-configuratie: /etc/nginx/sites-available/linkwarden

Docker-beheer

Controleer de containers:

cd /root/linkwarden
docker compose ps

Logs bekijken:

cd /root/linkwarden
docker compose logs -f

Bekijk de Linkwarden-logs:

cd /root/linkwarden
docker compose logs -f linkwarden

Herstart Linkwarden:

cd /root/linkwarden
docker compose restart linkwarden

Stop de stack:

cd /root/linkwarden
docker compose down

Stack starten:

cd /root/linkwarden
docker compose up -d

NGINX-beheer

Controleer NGINX:

systemctl status nginx

Test de configuratie:

nginx -t

NGINX herstarten:

systemctl restart nginx

NGINX herladen:

systemctl reload nginx

Domein en HTTPS

1. Maak een A record voor de hostnaam van uw app en laat het naar het publieke IP-adres van uw server wijzen (bijvoorbeeld app.example.com).

2. Installeer Certbot:

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

3. Bewerk de NGINX-configuratie en vervang server_name _; door uw domein (bijvoorbeeld server_name app.example.com;):

vim /etc/nginx/sites-available/linkwarden

4. Test de configuratie:

nginx -t

5. Herlaad NGINX:

systemctl reload nginx

6. Geef een TLS-certificaat uit:

certbot --nginx -d app.example.com

7. Werk de omgevingsvariabelen van Linkwarden bij (.env bestand):

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

8. Herstart Linkwarden na het wijzigen van de omgevingsvariabelen:

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

9. Open je browser en bezoek: https://app.example.com

Opmerkingen

• Linkwarden is publiek bereikbaar via Nginx op poort 80.
• De Linkwarden-applicatie zelf luistert alleen op 127.0.0.1:3000.
• PostgreSQL en Meilisearch zijn interne Docker-services en zijn niet rechtstreeks beschikbaar voor de host.
• Zorg er bij het instellen van het domein voor dat u vervangt: http:// door https:// overal waar de applicatie-URL is ingesteld, waaronder NEXTAUTH_URL en BASE_URL.
• Gebruik consequent hetzelfde HTTPS-domein in de hele NGINX- en Linkwarden-configuratie.
• BASE_URL is vooral handig als u e-mailfuncties gebruikt, zoals wachtwoordherstel of verificatiemails.
• Pas de Linkwarden-configuratie aan naar uw voorkeuren.