Kutt

Acesso

• Abrir URL: https://<SERVER_IP>
• O HTTPS usa um certificado autoassinado.
• É normal surgir um aviso do browser no primeiro acesso.
• Aceite o aviso de certificado do browser.
• Será redirecionado para /create-admin no primeiro acesso.
• Crie uma conta de administrador a partir da interface web.
• Inicie sessão com a conta de administrador.

Ficheiros e diretórios importantes

• Caminho de instalação: /root/kutt
• Arquivo Compose: /root/kutt/docker-compose.yml
• Arquivo de ambiente: /root/kutt/.env
• Configuração do Nginx: /etc/nginx/sites-available/kutt
• Certificado SSL: /etc/nginx/ssl/kutt.crt
• Chave privada SSL: /etc/nginx/ssl/kutt.key
• Volume de dados do PostgreSQL: /var/lib/docker/volumes/kutt_db_data_pg/_data
• Volume de dados do Redis: /var/lib/docker/volumes/kutt_redis_data/_data
• Volume de dados personalizado: /var/lib/docker/volumes/kutt_custom/_data

Gerenciamento do Docker

Verificar o status:

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

Ver registos:

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

Reiniciar o serviço:

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

Parar o serviço:

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

Iniciar o serviço:

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

Gerenciamento do NGINX

Configuração do teste:

nginx -t

Reiniciar o NGINX:

systemctl restart nginx

Recarregar o NGINX:

systemctl reload nginx

Verificar o status:

systemctl status nginx

Ativar SSL com um domínio

1. Aponte o seu domínio para o IP do servidor.

2. Edite a configuração do Nginx e substitua ambos server_name _; com o seu domínio (server_name <yourdomain.com>) para ambos os blocos HTTP (porta 80) e HTTPS (porta 443):

vim /etc/nginx/sites-available/kutt

3. Instalar o Certbot:

apt install -y certbot python3-certbot-nginx

4. Execute o seguinte comando para gerar um certificado Let's Encrypt válido:

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

5. Substitua os caminhos SSL na configuração do 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. Recarregue o Nginx para aplicar as alterações:

systemctl reload nginx

7. Edite o /root/kutt/.env para definir o nome do seu domínio: DEFAULT_DOMAIN=yourdomain.com

8. Recriar os serviços:

cd /root/kutt
docker compose up -d

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