Zugriff auf Bar Assistant
- Weboberfläche:
https://<SERVER_IP> - REST-API:
https://<SERVER_IP>/bar - Meilisearch:
https://<SERVER_IP>/search - Eine SSL-Warnung im Browser ist zu erwarten, da ein selbstsigniertes Zertifikat verwendet wird.
Ersteinrichtung
1. Öffnen Sie die folgende URL in Ihrem Browser: https://<SERVER_IP>
2. Klicken Sie auf Register.
3. Legen Sie das erste Benutzerkonto an.
4. Deaktivieren Sie nach Abschluss der Registrierung die öffentliche Registrierung, indem Sie bearbeiten:
vim /root/barassistant/docker-compose.yml
Ändern Sie ALLOW_REGISTRATION: "true" to ALLOW_REGISTRATION: "false".
Wende die Änderung an:
cd /root/barassistant
docker compose up -d
Wichtige Dateien und Verzeichnisse
- Installationspfad:
/root/barassistant - Compose-Datei:
/root/barassistant/docker-compose.yml - Umgebungsdatei:
/root/barassistant/.env - Nginx-Konfiguration:
/etc/nginx/sites-available/barassistant - SSL-Zertifikat:
/etc/nginx/ssl/barassistant.crt - SSL-Schlüssel:
/etc/nginx/ssl/barassistant.key - Bar-Datenverzeichnis:
/var/lib/docker/volumes/barassistant_bar_data/_data - Meilisearch-Datenverzeichnis:
/var/lib/docker/volumes/barassistant_meilisearch_data/_data
Bar Assistant verwalten
Laufende Container anzeigen:
docker compose -f /root/barassistant/docker-compose.yml ps
Alle Container neu starten:
docker compose -f /root/barassistant/docker-compose.yml restart
Verfolgen Sie die Anwendungs-Logs:
docker compose -f /root/barassistant/docker-compose.yml logs -f
Stoppen Sie die Anwendung:
docker compose -f /root/barassistant/docker-compose.yml down
Starten Sie die Anwendung:
docker compose -f /root/barassistant/docker-compose.yml up -d
Nginx verwalten
Status prüfen:
systemctl status nginx
Nginx neu starten:
systemctl restart nginx
Nginx neu laden:
systemctl reload nginx
Überprüfen Sie die Konfiguration:
nginx -t
SSL mit einer Domain aktivieren
1. Richten Sie Ihre Domain auf die Server-IP aus.
2. Nginx-Konfiguration bearbeiten und beide ersetzen server_name _; mit Ihrer Domain (server_name <yourdomain.com>) für beide Blöcke HTTP (Port 80) und HTTPS (Port 443):
vim /etc/nginx/sites-available/barassistant
3. Certbot installieren:
apt install -y certbot python3-certbot-nginx
4. Führen Sie den folgenden Befehl aus, um ein gültiges Let's Encrypt-Zertifikat zu generieren:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. SSL-Pfade in der Nginx-Konfiguration ersetzen:
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. Laden Sie Nginx neu, um die Änderungen anzuwenden:
systemctl reload nginx
7. Bearbeiten Sie /root/barassistant/.env und ersetzen Sie die Server-IP in API_URL und MEILISEARCH_URL with your domain:
API_URL=https://yourdomain.com/bar
MEILISEARCH_URL=https://yourdomain.com/search
8. Dienste neu erstellen:
cd /root/barassistant
docker compose up -d
9. Öffnen Sie Ihren Browser und besuchen Sie: https://yourdomain.com
Reverse Proxy überprüfen
- Öffnen Sie
https://yourdomain.com/bar. Sie sollten sehen: "This is your Bar Assistant instance." - Öffnen Sie
https://yourdomain.com/bar/docs. Sie sollten die Swagger-API-Dokumentation sehen. - Öffnen Sie
https://yourdomain.com/bar/api/server/version. Sie sollten eine JSON-Antwort mit der Serverversion erhalten, keinen "Resource not found"-Fehler.
