Linkwarden

Dostęp

1. Otwórz http://<SERVER_IP>.
2. Kliknij „Sign Up”.
3. Utwórz pierwsze konto.
4. Pierwsze konto staje się administratorem serwera, ponieważ NEXT_PUBLIC_ADMIN=1 jest włączone.

Rejestracja

Rejestracja jest domyślnie włączona.

Po utworzeniu konta administratora rejestrację można wyłączyć.

Aby ją wyłączyć, edytuj /root/linkwarden/.env i ustaw:

NEXT_PUBLIC_DISABLE_REGISTRATION=true

Następnie zastosuj konfigurację:

cd /root/linkwarden
docker compose up -d

Ważne ścieżki

• Ścieżka instalacji: /root/linkwarden
• Plik Compose: /root/linkwarden/docker-compose.yml
• Plik środowiskowy: /root/linkwarden/.env
• Dane aplikacji: /root/linkwarden/data
• Dane PostgreSQL: /root/linkwarden/pgdata
• Dane Meilisearch: /root/linkwarden/meili_data
• Konfiguracja Nginx: /etc/nginx/sites-available/linkwarden

Zarządzanie Dockerem

Sprawdź kontenery:

cd /root/linkwarden
docker compose ps

Zobacz logi:

cd /root/linkwarden
docker compose logs -f

Wyświetl logi Linkwarden:

cd /root/linkwarden
docker compose logs -f linkwarden

Uruchom ponownie Linkwarden:

cd /root/linkwarden
docker compose restart linkwarden

Zatrzymaj stos:

cd /root/linkwarden
docker compose down

Uruchom stos:

cd /root/linkwarden
docker compose up -d

Zarządzanie NGINX

Sprawdź NGINX:

systemctl status nginx

Przetestuj konfigurację:

nginx -t

Uruchom ponownie NGINX:

systemctl restart nginx

Przeładuj NGINX:

systemctl reload nginx

Domena i HTTPS

1. Utwórz rekord A dla nazwy hosta swojej aplikacji i skieruj go na publiczny adres IP serwera (na przykład app.example.com).

2. Zainstaluj Certbota:

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

3. Edytuj konfigurację NGINX i zamień server_name _; na swoją domenę (na przykład server_name app.example.com;):

vim /etc/nginx/sites-available/linkwarden

4. Przetestuj konfigurację:

nginx -t

5. Przeładuj NGINX:

systemctl reload nginx

6. Wystaw certyfikat TLS:

certbot --nginx -d app.example.com

7. Zaktualizuj zmienne środowiskowe Linkwarden (.env plik):

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

8. Po zmianie zmiennych środowiskowych zrestartuj Linkwarden:

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

9. Otwórz przeglądarkę i odwiedź: https://app.example.com

Uwagi

• Linkwarden jest udostępniany publicznie przez Nginx na porcie 80.
• Sama aplikacja Linkwarden nasłuchuje tylko na 127.0.0.1:3000.
• PostgreSQL i Meilisearch to wewnętrzne usługi Dockera i nie są bezpośrednio wystawione na hoście.
• Konfigurując domenę, pamiętaj, aby zamienić http:// na https:// wszędzie tam, gdzie skonfigurowany jest adres URL aplikacji, w tym NEXTAUTH_URL oraz BASE_URL.
• W całej konfiguracji NGINX i Linkwarden konsekwentnie używaj tej samej domeny HTTPS.
• BASE_URL jest szczególnie przydatne przy funkcjach e-mail, takich jak resetowanie hasła czy wiadomości weryfikacyjne.
• Zmień konfigurację Linkwarden według swoich preferencji.