Linkwarden

Доступ

1. Відкрийте http://<SERVER_IP>.
2. Натисніть «Sign Up».
3. Створіть перший акаунт.
4. Перший акаунт стає адміністратором сервера, тому що NEXT_PUBLIC_ADMIN=1 увімкнено.

Реєстрація

Реєстрацію ввімкнено за замовчуванням.

Після створення акаунта адміністратора реєстрацію можна вимкнути.

Щоб вимкнути, відредагуйте /root/linkwarden/.env і задайте:

NEXT_PUBLIC_DISABLE_REGISTRATION=true

Потім застосуйте конфігурацію:

cd /root/linkwarden
docker compose up -d

Важливі шляхи

• Шлях встановлення: /root/linkwarden
• Файл Compose: /root/linkwarden/docker-compose.yml
• Файл середовища: /root/linkwarden/.env
• Дані застосунку: /root/linkwarden/data
• Дані PostgreSQL: /root/linkwarden/pgdata
• Дані Meilisearch: /root/linkwarden/meili_data
• Конфігурація Nginx: /etc/nginx/sites-available/linkwarden

Керування Docker

Перевірте контейнери:

cd /root/linkwarden
docker compose ps

Переглянути логи:

cd /root/linkwarden
docker compose logs -f

Перегляд логів Linkwarden:

cd /root/linkwarden
docker compose logs -f linkwarden

Перезапустіть Linkwarden:

cd /root/linkwarden
docker compose restart linkwarden

Зупинити стек:

cd /root/linkwarden
docker compose down

Запустити стек:

cd /root/linkwarden
docker compose up -d

Управління NGINX

Перевірте NGINX:

systemctl status nginx

Перевірте конфігурацію:

nginx -t

Перезапустіть NGINX:

systemctl restart nginx

Перезавантажте NGINX:

systemctl reload nginx

Домен і HTTPS

1. Створіть запис A для імені хоста вашого застосунку та спрямуйте його на публічну IP-адресу сервера (наприклад, app.example.com).

2. Встановіть Certbot:

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

3. Відредагуйте конфігурацію NGINX і замініть server_name _; на свій домен (наприклад, server_name app.example.com;):

vim /etc/nginx/sites-available/linkwarden

4. Перевірте конфігурацію:

nginx -t

5. Перезавантажте NGINX:

systemctl reload nginx

6. Випустіть TLS-сертифікат:

certbot --nginx -d app.example.com

7. Оновіть змінні середовища Linkwarden (.env файл):

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

8. Після зміни змінних середовища перезапустіть Linkwarden:

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

9. Відкрийте браузер і перейдіть за адресою: https://app.example.com

Примітки

• Linkwarden доступний публічно через Nginx на порту 80.
• Сам застосунок Linkwarden слухає лише 127.0.0.1:3000.
• PostgreSQL і Meilisearch — внутрішні сервіси Docker і безпосередньо на хост не виставляються.
• Під час налаштування домену не забудьте замінити http:// на https:// скрізь, де налаштовано URL застосунку, включно з NEXTAUTH_URL та BASE_URL.
• Використовуйте той самий HTTPS-домен у всій конфігурації NGINX і Linkwarden.
• BASE_URL особливо корисно, якщо ви використовуєте поштові функції: скидання пароля чи листи підтвердження.
• Змініть конфігурацію Linkwarden на свій розсуд.