Acceder a Bar Assistant
- Interfaz web:
https://<SERVER_IP> - API REST:
https://<SERVER_IP>/bar - Meilisearch:
https://<SERVER_IP>/search - Es normal que el navegador muestre una advertencia SSL, ya que se utiliza un certificado autofirmado.
Configuración inicial
1. Abre la siguiente URL en tu navegador: https://<SERVER_IP>
2. Haz clic en Register.
3. Crea la primera cuenta de usuario.
4. Cuando termine el registro, desactiva el registro público editando:
vim /root/barassistant/docker-compose.yml
Cambia ALLOW_REGISTRATION: "true" to ALLOW_REGISTRATION: "false".
Aplica el cambio:
cd /root/barassistant
docker compose up -d
Archivos y directorios importantes
- Ruta de instalación:
/root/barassistant - Archivo Compose:
/root/barassistant/docker-compose.yml - Archivo de entorno:
/root/barassistant/.env - Configuración de Nginx:
/etc/nginx/sites-available/barassistant - Certificado SSL:
/etc/nginx/ssl/barassistant.crt - Clave SSL:
/etc/nginx/ssl/barassistant.key - Directorio de datos de Bar:
/var/lib/docker/volumes/barassistant_bar_data/_data - Directorio de datos de Meilisearch:
/var/lib/docker/volumes/barassistant_meilisearch_data/_data
Gestionar Bar Assistant
Ver los contenedores en ejecución:
docker compose -f /root/barassistant/docker-compose.yml ps
Reiniciar todos los contenedores:
docker compose -f /root/barassistant/docker-compose.yml restart
Sigue los registros de la aplicación:
docker compose -f /root/barassistant/docker-compose.yml logs -f
Detén la aplicación:
docker compose -f /root/barassistant/docker-compose.yml down
Inicia la aplicación:
docker compose -f /root/barassistant/docker-compose.yml up -d
Administrar Nginx
Comprobar el estado:
systemctl status nginx
Reiniciar Nginx:
systemctl restart nginx
Recargar Nginx:
systemctl reload nginx
Valida la configuración:
nginx -t
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/barassistant
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/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. Recargue Nginx para aplicar los cambios:
systemctl reload nginx
7. Edita /root/barassistant/.env y reemplaza la IP del servidor en API_URL y MEILISEARCH_URL with your domain:
API_URL=https://yourdomain.com/bar
MEILISEARCH_URL=https://yourdomain.com/search
8. Recrear los servicios:
cd /root/barassistant
docker compose up -d
9. Abre tu navegador y visita: https://yourdomain.com
Verificar el proxy inverso
- Abre
https://yourdomain.com/bar. Deberías ver: "This is your Bar Assistant instance." - Abre
https://yourdomain.com/bar/docs. Deberías ver la documentación de la API de Swagger. - Abre
https://yourdomain.com/bar/api/server/version. Deberías recibir una respuesta JSON con la versión del servidor, no un error "Resource not found".
