Accedere a Bar Assistant
- Interfaccia web:
https://<SERVER_IP> - API REST:
https://<SERVER_IP>/bar - Meilisearch:
https://<SERVER_IP>/search - È previsto un avviso SSL del browser perché viene usato un certificato autofirmato.
Configurazione iniziale
1. Apri il seguente URL nel browser: https://<SERVER_IP>
2. Fai clic su Register.
3. Crea il primo account utente.
4. Completata la registrazione, disattiva la registrazione pubblica modificando:
vim /root/barassistant/docker-compose.yml
Modifica ALLOW_REGISTRATION: "true" to ALLOW_REGISTRATION: "false".
Applica la modifica:
cd /root/barassistant
docker compose up -d
File e directory importanti
- Percorso di installazione:
/root/barassistant - File Compose:
/root/barassistant/docker-compose.yml - File di ambiente:
/root/barassistant/.env - Configurazione Nginx:
/etc/nginx/sites-available/barassistant - Certificato SSL:
/etc/nginx/ssl/barassistant.crt - Chiave SSL:
/etc/nginx/ssl/barassistant.key - Directory dati Bar:
/var/lib/docker/volumes/barassistant_bar_data/_data - Directory dati Meilisearch:
/var/lib/docker/volumes/barassistant_meilisearch_data/_data
Gestione di Bar Assistant
Visualizzare i container in esecuzione:
docker compose -f /root/barassistant/docker-compose.yml ps
Riavviare tutti i container:
docker compose -f /root/barassistant/docker-compose.yml restart
Segui i log dell'applicazione:
docker compose -f /root/barassistant/docker-compose.yml logs -f
Arresta l'applicazione:
docker compose -f /root/barassistant/docker-compose.yml down
Avvia l'applicazione:
docker compose -f /root/barassistant/docker-compose.yml up -d
Gestione di Nginx
Verifica lo stato:
systemctl status nginx
Riavviare Nginx:
systemctl restart nginx
Ricaricare Nginx:
systemctl reload nginx
Convalida la configurazione:
nginx -t
Abilitare SSL con un dominio
1. Punta il tuo dominio all'IP del server.
2. Modifica la configurazione Nginx e sostituisci entrambi server_name _; con il tuo dominio (server_name <yourdomain.com>) sia per i blocchi HTTP (porta 80) sia HTTPS (porta 443):
vim /etc/nginx/sites-available/barassistant
3. Installa Certbot:
apt install -y certbot python3-certbot-nginx
4. Esegui il seguente comando per generare un certificato Let's Encrypt valido:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Sostituisci i percorsi SSL nella configurazione 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. Ricarica Nginx per applicare le modifiche:
systemctl reload nginx
7. Modifica /root/barassistant/.env e sostituisci l'IP del server in API_URL e i piani MEILISEARCH_URL with your domain:
API_URL=https://yourdomain.com/bar
MEILISEARCH_URL=https://yourdomain.com/search
8. Ricreare i servizi:
cd /root/barassistant
docker compose up -d
9. Apri il browser e vai a: https://yourdomain.com
Verificare il reverse proxy
- Apri
https://yourdomain.com/bar. Dovresti vedere: "This is your Bar Assistant instance." - Apri
https://yourdomain.com/bar/docs. Dovresti vedere la documentazione dell'API Swagger. - Apri
https://yourdomain.com/bar/api/server/version. Dovresti ricevere una risposta JSON con la versione del server, non un errore "Resource not found".
