Linkwarden

Acesso

1. Abra http://<SERVER_IP>.
2. Clique em "Sign Up".
3. Crie a primeira conta.
4. A primeira conta se torna a administradora do servidor porque NEXT_PUBLIC_ADMIN=1 está habilitado.

Registro

O cadastro vem habilitado por padrão.

Depois de criar a conta de administrador, o cadastro pode ser desativado.

Para desativar, edite /root/linkwarden/.env e defina:

NEXT_PUBLIC_DISABLE_REGISTRATION=true

Depois aplique a configuração:

cd /root/linkwarden
docker compose up -d

Caminhos importantes

• Caminho de instalação: /root/linkwarden
• Arquivo Compose: /root/linkwarden/docker-compose.yml
• Arquivo de ambiente: /root/linkwarden/.env
• Dados do aplicativo: /root/linkwarden/data
• Dados do PostgreSQL: /root/linkwarden/pgdata
• Dados do Meilisearch: /root/linkwarden/meili_data
• Configuração do Nginx: /etc/nginx/sites-available/linkwarden

Gerenciamento do Docker

Verifique os contêineres:

cd /root/linkwarden
docker compose ps

Ver registos:

cd /root/linkwarden
docker compose logs -f

Veja os logs do Linkwarden:

cd /root/linkwarden
docker compose logs -f linkwarden

Reinicie o Linkwarden:

cd /root/linkwarden
docker compose restart linkwarden

Parar o stack:

cd /root/linkwarden
docker compose down

Iniciar o stack:

cd /root/linkwarden
docker compose up -d

Gerenciamento do NGINX

Verifique o NGINX:

systemctl status nginx

Teste a configuração:

nginx -t

Reiniciar o NGINX:

systemctl restart nginx

Recarregar o NGINX:

systemctl reload nginx

Domínio e HTTPS

1. Crie um registro A para o nome de host do seu aplicativo e aponte-o para o IP público do seu servidor (por exemplo, app.example.com).

2. Instale o Certbot:

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

3. Edite a configuração do NGINX e substitua server_name _; pelo seu domínio (por exemplo, server_name app.example.com;):

vim /etc/nginx/sites-available/linkwarden

4. Teste a configuração:

nginx -t

5. Recarregue o NGINX:

systemctl reload nginx

6. Emita um certificado TLS:

certbot --nginx -d app.example.com

7. Atualize as variáveis de ambiente do Linkwarden (.env arquivo):

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

8. Depois de alterar as variáveis de ambiente, reinicie o Linkwarden:

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

9. Abra o seu browser e visite: https://app.example.com

Notas

• O Linkwarden é exposto publicamente pelo Nginx na porta 80.
• A própria aplicação Linkwarden escuta apenas em 127.0.0.1:3000.
• PostgreSQL e Meilisearch são serviços internos do Docker e não ficam expostos diretamente ao host.
• Ao configurar o domínio, lembre-se de substituir http:// por https:// em todos os lugares onde a URL da aplicação é configurada, incluindo NEXTAUTH_URL e BASE_URL.
• Use o mesmo domínio HTTPS de forma consistente em toda a configuração do NGINX e do Linkwarden.
• BASE_URL é especialmente útil ao usar recursos de e-mail, como redefinição de senha ou e-mails de verificação.
• Altere a configuração do Linkwarden conforme suas preferências.