Kener

Acesso

1. Abra o seu browser e visite: https://<SERVER_IP>
2. É esperado um aviso SSL no browser (certificado autoassinado)
3. Clique em Entrar
4. Crie sua conta de administrador

Ficheiros e diretórios importantes

• Diretório de instalação do Kener: /root/kener
• Ficheiro de ambiente: /root/kener/.env
• Ficheiro Docker Compose: /root/kener/docker-compose.yml
• Volume de dados Redis: /var/lib/docker/volumes/kener_redis/_data
• Volume de dados PostgreSQL: /var/lib/docker/volumes/kener_postgres/_data
• Configuração do site Nginx: /etc/nginx/sites-available/kener
• Site habilitado: /etc/nginx/sites-enabled/kener
• Certificados SSL: /etc/nginx/ssl/fullchain.pem e /etc/nginx/ssl/privkey.pem

Gestão de serviços

# View logs
docker compose -f /root/kener/docker-compose.yml logs -f

# Restart services
docker compose -f /root/kener/docker-compose.yml restart

# Stop services
docker compose -f /root/kener/docker-compose.yml down

# Start again
docker compose -f /root/kener/docker-compose.yml up -d

Ativar SSL com um domínio

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

2. Editar /root/kener/.env para definir seu domínio como ORIGIN: ORIGIN=https://yourdomain.com

3. Recrie os serviços:

cd /root/kener/
docker compose up -d

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

vim /etc/nginx/sites-available/kener

5. Instale o Certbot:

apt install -y certbot python3-certbot-nginx

6. 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

7. Substitua os caminhos SSL na configuração do Nginx:

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

8. Reinicie o Nginx para aplicar as alterações:

systemctl restart nginx

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

10. Após fazer login, vá para Configuração do Site e atualize o campo URL do Site para corresponder ao seu domínio (https://yourdomain.com).

Notas

• Redis é usado para filas e cache
• PostgreSQL armazena todos os dados do aplicativo
• URL público é definido por meio de ORIGIN in .env (necessário para proteção CSRF)
• Nginx lida com HTTPS e proxy reverso
• Depois de configurar um nome de domínio e certificado SSL adequados, atualize o URL do site Kener para corresponder ao seu domínio. Certifique-se de que o domínio e o SSL estejam ativos primeiro, atualizando o URL do site antes que isso possa não funcionar corretamente.