Accéder à Bar Assistant
- Interface web :
https://<SERVER_IP> - API REST :
https://<SERVER_IP>/bar - Meilisearch :
https://<SERVER_IP>/search - Un avertissement SSL du navigateur est normal car un certificat auto-signé est utilisé.
Configuration initiale
1. Ouvrez l'URL suivante dans votre navigateur : https://<SERVER_IP>
2. Cliquez sur Register.
3. Créez le premier compte utilisateur.
4. Une fois l'inscription terminée, désactivez l'inscription publique en modifiant :
vim /root/barassistant/docker-compose.yml
Modifiez ALLOW_REGISTRATION: "true" to ALLOW_REGISTRATION: "false".
Appliquez la modification :
cd /root/barassistant
docker compose up -d
Fichiers et répertoires importants
- Chemin d'installation :
/root/barassistant - Fichier Compose :
/root/barassistant/docker-compose.yml - Fichier d'environnement :
/root/barassistant/.env - Configuration Nginx :
/etc/nginx/sites-available/barassistant - Certificat SSL :
/etc/nginx/ssl/barassistant.crt - Clé SSL :
/etc/nginx/ssl/barassistant.key - Répertoire de données Bar :
/var/lib/docker/volumes/barassistant_bar_data/_data - Répertoire de données Meilisearch :
/var/lib/docker/volumes/barassistant_meilisearch_data/_data
Gérer Bar Assistant
Afficher les conteneurs en cours d'exécution :
docker compose -f /root/barassistant/docker-compose.yml ps
Redémarrer tous les conteneurs :
docker compose -f /root/barassistant/docker-compose.yml restart
Suivez les journaux de l'application :
docker compose -f /root/barassistant/docker-compose.yml logs -f
Arrêtez l'application :
docker compose -f /root/barassistant/docker-compose.yml down
Démarrez l'application :
docker compose -f /root/barassistant/docker-compose.yml up -d
Gestion de Nginx
Vérifier l'état :
systemctl status nginx
Redémarrer Nginx :
systemctl restart nginx
Recharger Nginx :
systemctl reload nginx
Validez la configuration :
nginx -t
Activer SSL avec un domaine
1. Faites pointer votre domaine vers l'IP du serveur.
2. Modifiez la config Nginx et remplacez les deux server_name _; avec votre domaine (server_name <yourdomain.com>) dans les blocs HTTP (port 80) et HTTPS (port 443) :
vim /etc/nginx/sites-available/barassistant
3. Installez Certbot :
apt install -y certbot python3-certbot-nginx
4. Exécutez la commande suivante pour générer un certificat Let's Encrypt valide :
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Remplacez les chemins SSL dans la config 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. Rechargez Nginx pour appliquer les modifications :
systemctl reload nginx
7. Modifiez /root/barassistant/.env et remplacez l'IP du serveur dans API_URL et MEILISEARCH_URL with your domain:
API_URL=https://yourdomain.com/bar
MEILISEARCH_URL=https://yourdomain.com/search
8. Recréez les services :
cd /root/barassistant
docker compose up -d
9. Ouvrez votre navigateur et allez sur : https://yourdomain.com
Vérifier le reverse proxy
- Ouvrez
https://yourdomain.com/bar. Vous devriez voir : "This is your Bar Assistant instance." - Ouvrez
https://yourdomain.com/bar/docs. Vous devriez voir la documentation de l'API Swagger. - Ouvrez
https://yourdomain.com/bar/api/server/version. Vous devriez recevoir une réponse JSON contenant la version du serveur, et non une erreur "Resource not found".
