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 :

ValeurVariableExemple
Le domaine que vos utilisateurs saisirontAARVIEW_DOMAINaarview.example.org
Le nom de votre organisationAARVIEW_OPERATOR_NAMEaffiché sur la page de connexion, les rapports et les e-mails
L’adresse de l’administrateurAARVIEW_ADMIN_EMAILadministrateur 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

  1. Il crée .env à partir de .env.example et y génère tous les secrets (fichier en mode 0600). Aucun secret n’est affiché.
  2. 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.
  3. Il construit les images depuis les sources, applique le schéma de la base et démarre la pile.
  4. 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.
  5. 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 :

ServiceRôle
traefikpoint d’entrée HTTPS, seul port publié (443)
webl’interface d’AarView
apil’API d’AarView
migrateapplique le schéma de la base, puis s’arrête
postgresla base de données (PostgreSQL)
redisle stockage clé-valeur (Redis)
authentik-server, authentik-workerle 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.