Linkwarden

Akses

1. Buka http://<SERVER_IP>.
2. Klik 'Sign Up'.
3. Buat akun pertama.
4. Akun pertama menjadi administrator server karena NEXT_PUBLIC_ADMIN=1 diaktifkan.

Pendaftaran

Pendaftaran aktif secara bawaan.

Setelah akun administrator dibuat, pendaftaran bisa dimatikan.

Untuk mematikannya, sunting /root/linkwarden/.env lalu atur:

NEXT_PUBLIC_DISABLE_REGISTRATION=true

Lalu terapkan konfigurasinya:

cd /root/linkwarden
docker compose up -d

Path Penting

• Jalur instalasi: /root/linkwarden
• File Compose: /root/linkwarden/docker-compose.yml
• File Lingkungan: /root/linkwarden/.env
• Data aplikasi: /root/linkwarden/data
• Data PostgreSQL: /root/linkwarden/pgdata
• Data Meilisearch: /root/linkwarden/meili_data
• Konfigurasi Nginx: /etc/nginx/sites-available/linkwarden

Manajemen Docker

Periksa kontainernya:

cd /root/linkwarden
docker compose ps

Lihat log:

cd /root/linkwarden
docker compose logs -f

Lihat log Linkwarden:

cd /root/linkwarden
docker compose logs -f linkwarden

Mulai ulang Linkwarden:

cd /root/linkwarden
docker compose restart linkwarden

Hentikan stack:

cd /root/linkwarden
docker compose down

Mulai stack:

cd /root/linkwarden
docker compose up -d

Manajemen NGINX

Periksa NGINX:

systemctl status nginx

Uji konfigurasinya:

nginx -t

Mulai ulang NGINX:

systemctl restart nginx

Muat ulang NGINX:

systemctl reload nginx

Domain & HTTPS

1. Buat sebuah data A untuk hostname aplikasi Anda dan arahkan ke alamat IP publik server (misalnya, app.example.com).

2. Instal Certbot:

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

3. Sunting konfigurasi NGINX dan ganti server_name _; dengan domain Anda (misalnya, server_name app.example.com;):

vim /etc/nginx/sites-available/linkwarden

4. Uji konfigurasinya:

nginx -t

5. Muat ulang NGINX:

systemctl reload nginx

6. Terbitkan sertifikat TLS:

certbot --nginx -d app.example.com

7. Perbarui variabel lingkungan Linkwarden (.env berkas):

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

8. Setelah mengubah variabel lingkungan, mulai ulang Linkwarden:

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

9. Buka browser kamu dan kunjungi: https://app.example.com

Catatan

• Linkwarden diekspos ke publik lewat Nginx di port 80.
• Aplikasi Linkwarden sendiri hanya mendengarkan di 127.0.0.1:3000.
• PostgreSQL dan Meilisearch adalah layanan Docker internal dan tidak diekspos langsung ke host.
• Saat mengonfigurasi domain, pastikan Anda mengganti http:// dengan https:// di semua tempat URL aplikasi dikonfigurasi, termasuk NEXTAUTH_URL dan BASE_URL.
• Gunakan domain HTTPS yang sama secara konsisten di seluruh konfigurasi NGINX dan Linkwarden.
• BASE_URL sangat berguna saat memakai fitur email seperti reset kata sandi atau email verifikasi.
• Ubah konfigurasi Linkwarden sesuai preferensi Anda.