Installation
1. Récupérer les fichiers de déploiement
Téléchargez le pack de déploiement on-premise fourni par Aiterraxis (archive aiterava-onprem-<version>.tar.gz) ou clonez uniquement le dossier deploy/onprem depuis le dépôt :
mkdir -p /opt/aiterava && cd /opt/aiterava
# Décompresser l'archive reçue
tar -xzf aiterava-onprem-1.2.0.tar.gz
cd aiterava-onprem-1.2.0/
Les fichiers importants :
docker-compose.onprem.yml # Stack complète
.env.client.example # Template de configuration
install.sh # Script d'installation guidée
Makefile # Commandes utilitaires
2. Préparer la configuration
cp .env.client.example .env
# Éditer .env avec vos valeurs (voir section Configuration)
nano .env
3. Connexion au registry
docker login registry.aiterava.com \
-u "$REGISTRY_USER" \
-p "$REGISTRY_PASSWORD"
4. Télécharger les images
docker compose -f docker-compose.onprem.yml pull
5. Démarrer les services
docker compose -f docker-compose.onprem.yml up -d
Vérifier que tous les services démarrent :
docker compose -f docker-compose.onprem.yml ps
Vous devriez voir 7 services en état running :
NAME STATUS
aiterava_onprem_api running
aiterava_onprem_celery running
aiterava_onprem_celery_beat running
aiterava_onprem_db running
aiterava_onprem_docker_proxy running
aiterava_onprem_frontend running
aiterava_onprem_redis running
6. Initialiser la base de données
docker exec aiterava_onprem_api python manage.py migrate
docker exec aiterava_onprem_api python manage.py createsuperuser
7. Configurer Nginx
Copiez le fichier de configuration Nginx et obtenez un certificat SSL :
# Copier la config (adapter le nom de domaine)
sudo cp nginx.onprem.conf /etc/nginx/sites-available/hotel.votredomaine.com.conf
sudo ln -s /etc/nginx/sites-available/hotel.votredomaine.com.conf \
/etc/nginx/sites-enabled/
# Générer le certificat SSL
sudo certbot --nginx -d hotel.votredomaine.com
# Recharger Nginx
sudo nginx -t && sudo nginx -s reload
8. Vérification finale
Ouvrez https://hotel.votredomaine.com dans votre navigateur. Vous devriez voir la page de connexion Aiterava.
# Test rapide en ligne de commande
curl -s https://hotel.votredomaine.com/api/v1/health/ | python3 -m json.tool
# {"status": "ok", "version": "1.2.0"}
Prochaine étape → Configuration