Kutt

Acceso

• Abrir URL: https://<SERVER_IP>
• HTTPS utiliza un certificado autofirmado.
• Es normal que el navegador muestre una advertencia en el primer acceso.
• Acepta la advertencia de certificado del navegador.
• Se te redirigirá a /create-admin en el primer acceso.
• Crea una cuenta de administrador desde la interfaz web.
• Inicia sesión con la cuenta de administrador.

Archivos y directorios importantes

• Ruta de instalación: /root/kutt
• Archivo Compose: /root/kutt/docker-compose.yml
• Archivo de entorno: /root/kutt/.env
• Configuración de Nginx: /etc/nginx/sites-available/kutt
• Certificado SSL: /etc/nginx/ssl/kutt.crt
• Clave privada SSL: /etc/nginx/ssl/kutt.key
• Volumen de datos de PostgreSQL: /var/lib/docker/volumes/kutt_db_data_pg/_data
• Volumen de datos de Redis: /var/lib/docker/volumes/kutt_redis_data/_data
• Volumen de datos personalizado: /var/lib/docker/volumes/kutt_custom/_data

Gestión de Docker

Comprobar el estado:

docker compose -f /root/kutt/docker-compose.yml ps

Ver registros:

docker compose -f /root/kutt/docker-compose.yml logs -f

Reiniciar servicio:

docker compose -f /root/kutt/docker-compose.yml restart

Detener el servicio:

docker compose -f /root/kutt/docker-compose.yml down

Iniciar servicio:

docker compose -f /root/kutt/docker-compose.yml up -d

Gestión de NGINX

Configuración de la prueba:

nginx -t

Reiniciar NGINX:

systemctl restart nginx

Recargar NGINX:

systemctl reload nginx

Comprobar el estado:

systemctl status nginx

Habilitar SSL con un dominio

1. Apunta tu dominio a la IP del servidor.

2. Edita la configuración de Nginx y reemplaza ambos server_name _; con tu dominio (server_name <yourdomain.com>) tanto para los bloques HTTP (puerto 80) como HTTPS (puerto 443):

vim /etc/nginx/sites-available/kutt

3. Instala Certbot:

apt install -y certbot python3-certbot-nginx

4. Ejecute el siguiente comando para generar un certificado Let's Encrypt válido:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Reemplaza las rutas SSL en la configuración de Nginx:

vim /etc/nginx/sites-available/kutt
# Before:
    # ssl_certificate     /etc/nginx/ssl/kutt.crt;
    # ssl_certificate_key /etc/nginx/ssl/kutt.key;
# After:
    # ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    # ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. Recargue Nginx para aplicar los cambios:

systemctl reload nginx

7. Edita el /root/kutt/.env para definir tu nombre de dominio: DEFAULT_DOMAIN=yourdomain.com

8. Recrear los servicios:

cd /root/kutt
docker compose up -d

9. Abre tu navegador y visita: https://yourdomain.com