Linkwarden

Acceso

1. Abre http://<SERVER_IP>.
2. Haz clic en «Sign Up».
3. Crea la primera cuenta.
4. La primera cuenta se convierte en administrador del servidor porque NEXT_PUBLIC_ADMIN=1 está habilitado.

Registro

El registro está habilitado de forma predeterminada.

Después de crear la cuenta de administrador, puedes desactivar el registro.

Para desactivarlo, edita /root/linkwarden/.env y define:

NEXT_PUBLIC_DISABLE_REGISTRATION=true

Después aplica la configuración:

cd /root/linkwarden
docker compose up -d

Rutas importantes

• Ruta de instalación: /root/linkwarden
• Archivo Compose: /root/linkwarden/docker-compose.yml
• Archivo de entorno: /root/linkwarden/.env
• Datos de la aplicación: /root/linkwarden/data
• Datos de PostgreSQL: /root/linkwarden/pgdata
• Datos de Meilisearch: /root/linkwarden/meili_data
• Configuración de Nginx: /etc/nginx/sites-available/linkwarden

Gestión de Docker

Comprueba los contenedores:

cd /root/linkwarden
docker compose ps

Ver registros:

cd /root/linkwarden
docker compose logs -f

Consulta los registros de Linkwarden:

cd /root/linkwarden
docker compose logs -f linkwarden

Reiniciar Linkwarden:

cd /root/linkwarden
docker compose restart linkwarden

Detener el stack:

cd /root/linkwarden
docker compose down

Iniciar el stack:

cd /root/linkwarden
docker compose up -d

Gestión de NGINX

Comprueba NGINX:

systemctl status nginx

Prueba la configuración:

nginx -t

Reiniciar NGINX:

systemctl restart nginx

Recargar NGINX:

systemctl reload nginx

Dominio y HTTPS

1. Crea un registro A para el nombre de host de tu aplicación y apúntalo a la dirección IP pública de tu servidor (por ejemplo, app.example.com).

2. Instala Certbot:

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

3. Edita la configuración de NGINX y sustituye server_name _; por tu dominio (por ejemplo, server_name app.example.com;):

vim /etc/nginx/sites-available/linkwarden

4. Prueba la configuración:

nginx -t

5. Recarga NGINX:

systemctl reload nginx

6. Emite un certificado TLS:

certbot --nginx -d app.example.com

7. Actualiza las variables de entorno de Linkwarden (.env archivo):

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

8. Después de cambiar las variables de entorno, reinicia Linkwarden:

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

9. Abre tu navegador y visita: https://app.example.com

Notas

• Linkwarden se expone públicamente a través de Nginx en el puerto 80.
• La propia aplicación Linkwarden solo escucha en 127.0.0.1:3000.
• PostgreSQL y Meilisearch son servicios internos de Docker y no se exponen directamente al host.
• Al configurar el dominio, asegúrate de sustituir http:// por https:// en todos los lugares donde se configure la URL de la aplicación, incluidos NEXTAUTH_URL y BASE_URL.
• Usa el mismo dominio HTTPS de forma coherente en toda la configuración de NGINX y Linkwarden.
• BASE_URL resulta especialmente útil si usas funciones de correo como el restablecimiento de contraseña o los correos de verificación.
• Cambia la configuración de Linkwarden según tus preferencias.