Linkwarden

Adgang

1. Åbn http://<SERVER_IP>.
2. Klik på 'Sign Up'.
3. Opret den første konto.
4. Den første konto bliver serveradministrator, fordi NEXT_PUBLIC_ADMIN=1 er aktiveret.

Registrering

Registrering er slået til som standard.

Når administratorkontoen er oprettet, kan registrering slås fra.

Rediger for at slå det fra /root/linkwarden/.env og angiv:

NEXT_PUBLIC_DISABLE_REGISTRATION=true

Anvend derefter konfigurationen:

cd /root/linkwarden
docker compose up -d

Vigtige stier

• Installationssti: /root/linkwarden
• Compose-fil: /root/linkwarden/docker-compose.yml
• Miljøfil: /root/linkwarden/.env
• App-data: /root/linkwarden/data
• PostgreSQL-data: /root/linkwarden/pgdata
• Meilisearch-data: /root/linkwarden/meili_data
• Nginx-konfiguration: /etc/nginx/sites-available/linkwarden

Docker-administration

Kontrollér containerne:

cd /root/linkwarden
docker compose ps

Se logs:

cd /root/linkwarden
docker compose logs -f

Se Linkwarden-logs:

cd /root/linkwarden
docker compose logs -f linkwarden

Genstart Linkwarden:

cd /root/linkwarden
docker compose restart linkwarden

Stop stacken:

cd /root/linkwarden
docker compose down

Start stacken:

cd /root/linkwarden
docker compose up -d

NGINX-administration

Kontrollér NGINX:

systemctl status nginx

Test konfigurationen:

nginx -t

Genstart NGINX:

systemctl restart nginx

Genindlæs NGINX:

systemctl reload nginx

Domæne og HTTPS

1. Opret en A record til din apps hostnavn, og peg den mod serverens offentlige IP-adresse (for eksempel app.example.com).

2. Installer Certbot:

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

3. Rediger NGINX-konfigurationen og erstat server_name _; med dit domæne (for eksempel server_name app.example.com;):

vim /etc/nginx/sites-available/linkwarden

4. Test konfigurationen:

nginx -t

5. Genindlæs NGINX:

systemctl reload nginx

6. Udsted et TLS-certifikat:

certbot --nginx -d app.example.com

7. Opdater Linkwardens miljøvariabler (.env fil):

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

8. Genstart Linkwarden efter ændring af miljøvariablerne:

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

9. Åbn din browser og gå til: https://app.example.com

Bemærkninger

• Linkwarden eksponeres offentligt via Nginx på port 80.
• Selve Linkwarden-applikationen lytter kun på 127.0.0.1:3000.
• PostgreSQL og Meilisearch er interne Docker-tjenester og eksponeres ikke direkte mod hosten.
• Når du konfigurerer domænet, skal du huske at erstatte http:// med https:// alle steder hvor applikationens URL er konfigureret, herunder NEXTAUTH_URL og BASE_URL.
• Brug konsekvent det samme HTTPS-domæne i hele NGINX- og Linkwarden-konfigurationen.
• BASE_URL er især nyttigt, når du bruger e-mailfunktioner som nulstilling af adgangskode eller bekræftelsesmails.
• Ændr Linkwarden-konfigurationen efter dine præferencer.