Acessar o Bar Assistant
- Interface web:
https://<SERVER_IP> - API REST:
https://<SERVER_IP>/bar - Meilisearch:
https://<SERVER_IP>/search - É normal surgir um aviso de SSL no browser, uma vez que é usado um certificado autoassinado.
Configuração inicial
1. Abra a seguinte URL no seu navegador: https://<SERVER_IP>
2. Clique em Register.
3. Crie a primeira conta de usuário.
4. Concluído o registro, desative o cadastro público editando:
vim /root/barassistant/docker-compose.yml
Altere ALLOW_REGISTRATION: "true" to ALLOW_REGISTRATION: "false".
Aplique a alteração:
cd /root/barassistant
docker compose up -d
Ficheiros e diretórios importantes
- Caminho de instalação:
/root/barassistant - Arquivo Compose:
/root/barassistant/docker-compose.yml - Arquivo de ambiente:
/root/barassistant/.env - Configuração do Nginx:
/etc/nginx/sites-available/barassistant - Certificado SSL:
/etc/nginx/ssl/barassistant.crt - Chave SSL:
/etc/nginx/ssl/barassistant.key - Diretório de dados do Bar:
/var/lib/docker/volumes/barassistant_bar_data/_data - Diretório de dados do Meilisearch:
/var/lib/docker/volumes/barassistant_meilisearch_data/_data
Gerenciar o Bar Assistant
Ver os contêineres em execução:
docker compose -f /root/barassistant/docker-compose.yml ps
Reiniciar todos os contêineres:
docker compose -f /root/barassistant/docker-compose.yml restart
Acompanhe os registos da aplicação:
docker compose -f /root/barassistant/docker-compose.yml logs -f
Pare a aplicação:
docker compose -f /root/barassistant/docker-compose.yml down
Inicie a aplicação:
docker compose -f /root/barassistant/docker-compose.yml up -d
Gerenciando Nginx
Verificar o status:
systemctl status nginx
Reiniciar o Nginx:
systemctl restart nginx
Recarregar o Nginx:
systemctl reload nginx
Valide a configuração:
nginx -t
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/barassistant
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/barassistant
# Before:
# ssl_certificate /etc/nginx/ssl/barassistant.crt;
# ssl_certificate_key /etc/nginx/ssl/barassistant.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 /root/barassistant/.env e substitua o IP do servidor em API_URL e MEILISEARCH_URL with your domain:
API_URL=https://yourdomain.com/bar
MEILISEARCH_URL=https://yourdomain.com/search
8. Recriar os serviços:
cd /root/barassistant
docker compose up -d
9. Abra o seu browser e visite: https://yourdomain.com
Verificar o proxy reverso
- Abra
https://yourdomain.com/bar. Você deve ver: "This is your Bar Assistant instance." - Abra
https://yourdomain.com/bar/docs. Você deve ver a documentação da API Swagger. - Abra
https://yourdomain.com/bar/api/server/version. Você deve receber uma resposta JSON com a versão do servidor, não um erro "Resource not found".
