Skip to main content

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