Sommaire de la documentation
AarView · Démarrer
Installation
Installer l'édition autonome d'AarView en une commande : secrets, certificat, images, schéma de la base et fournisseur d'identité configurés et vérifiés.
Sur cette page
L’installation tient en une commande, lancée depuis le dossier de l’édition autonome (portal/deploy/standalone dans la distribution AarView). Pour obtenir la distribution, contactez CyberAar.
Lancer l’installateur
cd portal/deploy/standalone
./install.sh
L’installateur demande trois valeurs, ou les lit dans .env ou dans l’environnement :
| Valeur | Variable | Exemple |
|---|---|---|
| Le domaine que vos utilisateurs saisiront | AARVIEW_DOMAIN | aarview.example.org |
| Le nom de votre organisation | AARVIEW_OPERATOR_NAME | affiché sur la page de connexion, les rapports et les e-mails |
| L’adresse de l’administrateur | AARVIEW_ADMIN_EMAIL | administrateur du fournisseur d’identité, contact affiché en cas de verrouillage |
Pour une installation sans question, renseignez-les avant de lancer le script :
AARVIEW_DOMAIN=aarview.example.org \
AARVIEW_OPERATOR_NAME="Mon organisation" \
[email protected] \
./install.sh
Ce que fait l’installateur
- Il crée
.envà partir de.env.exampleet y génère tous les secrets (fichier en mode 0600). Aucun secret n’est affiché. - Il crée une autorité de certification privée et le certificat du portail, sauf si vous déposez le vôtre dans
traefik/tls/. Voir Certificat TLS. - Il construit les images depuis les sources, applique le schéma de la base et démarre la pile.
- Il configure le fournisseur d’identité : double authentification obligatoire, verrouillage des comptes, politique de mots de passe, liens de définition du mot de passe.
- Il configure le compte d’annuaire du portail, puis vérifie que ce compte a les droits nécessaires et aucun autre. Si la vérification échoue, l’installation s’arrête.
À la fin, il affiche l’adresse du portail, la première connexion et l’identifiant d’instance, nécessaire pour la licence.
Relancer sans risque
Le script peut être relancé : il ne remplace jamais un secret ni un certificat existant. L’identifiant d’instance est fixé une fois pour toutes, car la licence y est liée : ne le modifiez jamais sur une installation en service.
Les conteneurs
La pile Docker Compose comprend :
| Service | Rôle |
|---|---|
traefik | point d’entrée HTTPS, seul port publié (443) |
web | l’interface d’AarView |
api | l’API d’AarView |
migrate | applique le schéma de la base, puis s’arrête |
postgres | la base de données (PostgreSQL) |
redis | le stockage clé-valeur (Redis) |
authentik-server, authentik-worker | le fournisseur d’identité (Authentik) |
Si quelque chose échoue
Le script s’arrête au premier problème et indique quoi regarder, par exemple :
docker compose logs authentik-server
docker compose logs authentik-worker
Étape suivante : la première connexion.