Déployer Alyren sur votre réseau
L’app Alyren et un Postgres dédié restent sur votre réseau. Le proxy de l’agent et l’extension lisent ce coffre. Le modèle ne reçoit que des jumeaux.
Ce Postgres est le coffre d’Alyren. Ce n’est pas la base métier, et ce n’est pas le Postgres de Veilio Core.
Vue d’ensemble : Alyren. Le proxy lui-même : Agent.
Ce que vous faites tourner
| Pièce | Où elle tourne |
|---|---|
| Coffre | L’app Alyren et son Postgres, sur votre réseau. Les originaux, les paires et les messages restent là. |
| Proxy | La bibliothèque dans le processus de l’agent. ALYREN_URL est l’URL interne de cette app. Le proxy ne copie pas les originaux, et ce n’est pas un second coffre. |
| Extension | Reliée depuis le studio de cette instance. Le bouton vaut pour toute URL custom, y compris un domaine custom. Le chat et l’agent partagent les paires du même compte. |
Ouvrir l’instance affiche la page de connexion. Cette installation n’a pas de landing produit. Après la connexion, le studio s’ouvre.
1. La licence
L’instance reste fermée sans ALYREN_LICENSE. Veilio crée la licence. La clé se révèle dans le studio cloud, page On-prem. Elle se copie dans l’env plus bas. Ce n’est pas une clé alr_live_. La clé qui signe les licences reste sur le cloud Veilio. Elle ne fait pas partie de cette installation.
Prolonger signe une nouvelle clé. L’ancienne reste valable jusqu’à sa propre date. Les deux valeurs tiennent dans ALYREN_LICENSE, séparées par un espace. L’instance garde la clé qui expire le plus tard. Après l’ancienne date, retirer l’ancienne clé.
Après chaque changement de ALYREN_LICENSE, dans le dossier du compose :
docker compose up -dCompose relit le .env et recrée le conteneur. La nouvelle clé est alors celle du fichier.
Une révocation, ou une rotation après compromission, ferme l’instance en moins d’une minute. L’instance interroge alyren.veilio.fr. En cas de rotation, remplacer la clé. Ne pas laisser l’ancienne à côté de la nouvelle. Si le cloud ne répond pas, la dernière réponse est gardée 24 heures.
2. Récupérer l’image
Docker et Docker Compose v2, sur la machine qui héberge le coffre. Pas de login Docker Hub. L’image est publique. La licence ouvre l’instance.
docker pull veilio/alyren:latestImage : veilio/alyren. latest est l’image on-prem. Un redémarrage ne change pas la version. Pour prendre une image plus récente : docker compose pull, puis docker compose up -d.
3. Installation
Créer un dossier. Deux fichiers : .env et compose.yml.
mkdir alyren && cd alyren
openssl rand -hex 24
openssl rand -hex 32La première valeur va dans POSTGRES_PASSWORD. La seconde va dans BETTER_AUTH_SECRET. Lettres et chiffres seulement dans le mot de passe Postgres.
| Variable | Rôle |
|---|---|
POSTGRES_PASSWORD | Mot de passe du rôle alyren |
BETTER_AUTH_SECRET | Secret de session de cette instance. Ne pas réutiliser le mot de passe Postgres ni une clé alr_live_ |
BETTER_AUTH_URL | URL utilisée par le navigateur et l’agent, par exemple https://alyren.interne |
ALYREN_ADMIN_EMAILS | Email du compte qui ouvre /admin |
ALYREN_LICENSE | Clé de licence, révélée dans le studio cloud, page On-prem |
.env :
POSTGRES_PASSWORD=change_me_long
BETTER_AUTH_SECRET=change_me_long_secret
BETTER_AUTH_URL=https://alyren.interne
ALYREN_ADMIN_EMAILS=admin@exemple.fr
ALYREN_LICENSE=la_cle_du_studiocompose.yml :
services:
postgres:
image: postgres:16-alpine
environment:
POSTGRES_USER: alyren
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?POSTGRES_PASSWORD manquant}
POSTGRES_DB: alyren
volumes:
- alyren_pg:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U alyren -d alyren"]
interval: 5s
timeout: 5s
retries: 20
restart: unless-stopped
alyren:
image: veilio/alyren:latest
depends_on:
postgres:
condition: service_healthy
ports:
- "127.0.0.13000"
environment:
NODE_ENV: production
HOSTNAME: 0.0.0.0
PORT: 3000
DATABASE_URL: postgres://alyren:${POSTGRES_PASSWORD}@postgres:5432/alyren
BETTER_AUTH_SECRET: ${BETTER_AUTH_SECRET:?BETTER_AUTH_SECRET manquant}
BETTER_AUTH_URL: ${BETTER_AUTH_URL:?BETTER_AUTH_URL manquant}
ALYREN_ADMIN_EMAILS: ${ALYREN_ADMIN_EMAILS:-}
ALYREN_REQUIRE_EMAIL_VERIFICATION: "0"
ALYREN_ONPREM: "1"
ALYREN_LICENSE: ${ALYREN_LICENSE:?ALYREN_LICENSE manquant}
restart: unless-stopped
volumes:
alyren_pg:Le port 5432 n’est pas publié. Seul Alyren parle à Postgres. Le port 3000 n’écoute que sur 127.0.0.1.
docker compose pull
docker compose up -dLes tables se créent au premier appel.
curl -s http://127.0.0.1:3000/api/healthAttendu : ok true et driver postgres.
Une licence absente, expirée ou révoquée répond HTTP 503, avec ok false et license false. Le navigateur affiche la page licence. L’API répond 402.
4. HTTPS devant le conteneur
Le conteneur parle HTTP. Le navigateur et l’agent utilisent l’adresse de BETTER_AUTH_URL. Placez votre reverse proxy devant 127.0.0.1:3000.
location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto https;
}BETTER_AUTH_URL est cette adresse HTTPS, par exemple https://alyren.interne, sans chemin. Laissez le port 3000 sur la machine. Il ne doit pas être ouvert vers Internet.
5. Le premier compte
Ouvrir BETTER_AUTH_URL. La page est la connexion. Créer le compte dont l’email est dans ALYREN_ADMIN_EMAILS. Ce compose n’envoie pas de mail de confirmation. L’inscription ouvre le studio.
Dans /admin, créer les comptes des collaborateurs. Pas de solde par personne. La vue globale montre le reste face à la souscription. Les logs listent les cloaks de l’instance, sans la valeur originale. Cette page ne fixe pas de prix.
6. Brancher l’agent
Dans le studio, page Agent, créer une clé alr_live_. Copier le proxy depuis l’image :
docker compose cp alyren:/workspace/agent/proxy.mjs ./proxy.mjsSur le serveur de l’agent :
ALYREN_URL=https://alyren.interne
ALYREN_API_KEY=alr_live_...ALYREN_URL est la même adresse que BETTER_AUTH_URL. Ce n’est pas l’URL de Postgres. La clé reste dans l’environnement de l’agent. La suite du proxy, y compris ce que le modèle doit renvoyer, est sur Agent.
7. Relier l’extension
Lier mon extension à ce coffre enregistre l’adresse ouverte dans le navigateur. Ce bouton sert pour toute URL custom du coffre, y compris un domaine custom : https://coffre.client.fr, https://alyren.interne, http://127.0.0.1:3000 ou http://localhost:3000. L’extension envoie ensuite vers cette adresse. Un cloak du chat écrit dans le même coffre que le proxy. Il faut l’extension 1.3.8 ou plus récente.
- Ouvrez le studio de l’instance, page Extension. L’URL de la barre d’adresse est celle qui sera liée.
- Cliquez Lier mon extension à ce coffre.
- La page affiche « Elle envoie vers », puis cette URL custom.
Le même bouton est dans /admin, section Extension. Forcer pour tous les membres relie l’extension de chaque collaborateur à cette URL custom, au moment où il ouvre le studio. Un navigateur fermé ne reçoit pas la liaison.
Un domaine custom en HTTPS se déclare une fois, pour que l’extension ait le droit de lui parler. http://127.0.0.1:3000 et http://localhost:3000 sont déjà connues : le bouton suffit.
- Studio cloud, page On-prem, champ URL du coffre. Une licence, une adresse
https, sans chemin. C’est le domaine custom du coffre.localhostet une adresse IP ne vont pas dans ce champ. - L’enregistrement prévient Alyren. Dans l’admin cloud, page Notifications, cliquez Autoriser dans l’extension.
- Sur chaque navigateur, la popup Alyren affiche ce domaine. Cliquez Autoriser ce coffre une fois.
- Revenez au studio de l’instance, page Extension, et cliquez Lier mon extension à ce coffre.
Changer le domaine custom retire l’autorisation. Enregistrez la nouvelle URL, autorisez-la à nouveau, puis refaites le clic dans la popup.
8. Sauvegarde
Le volume s’appelle alyren_pg. Dump :
docker compose exec postgres pg_dump -U alyren -d alyren -Fc -f /tmp/alyren.dump
docker compose cp postgres:/tmp/alyren.dump ./alyren.dumpRestaurer sur une base vide. Arrêter Alyren avant.
docker compose cp ./alyren.dump postgres:/tmp/alyren.dump
docker compose exec postgres pg_restore -U alyren -d alyren --clean --if-exists /tmp/alyren.dumpNe pas supprimer le volume alyren_pg. C’est le coffre.
Postgres déjà en place
Créez une base et un rôle dédiés à Alyren. Le compose ne contient alors que le service alyren : retirez le service postgres, le bloc depends_on et le volume alyren_pg.
services:
alyren:
image: veilio/alyren:latest
ports:
- "127.0.0.13000"
environment:
NODE_ENV: production
HOSTNAME: 0.0.0.0
PORT: 3000
DATABASE_URL: postgres://alyren:${POSTGRES_PASSWORD}@hote:5432/alyren
BETTER_AUTH_SECRET: ${BETTER_AUTH_SECRET:?BETTER_AUTH_SECRET manquant}
BETTER_AUTH_URL: ${BETTER_AUTH_URL:?BETTER_AUTH_URL manquant}
ALYREN_ADMIN_EMAILS: ${ALYREN_ADMIN_EMAILS:-}
ALYREN_REQUIRE_EMAIL_VERIFICATION: "0"
ALYREN_ONPREM: "1"
ALYREN_LICENSE: ${ALYREN_LICENSE:?ALYREN_LICENSE manquant}
restart: unless-stoppedhote est le nom que ce conteneur utilise pour joindre votre Postgres. Le mot de passe ne contient pas @, :, /, ni #. L’app crée les tables au premier appel. BETTER_AUTH_SECRET, BETTER_AUTH_URL, ALYREN_ADMIN_EMAILS et ALYREN_LICENSE restent ceux du .env. La sauvegarde se fait avec les outils de ce Postgres. Le volume alyren_pg n’existe pas dans ce montage.
Ce que cette instance n’inclut pas
- Pas de Stripe, et pas de page Facturation. Les crédits de l’instance se lisent dans
/admin, face à la souscription. - Pas de code parrain, pas de demande entreprise, pas de bandeau cookies, pas de gestion d’organisations.
- Pas de second coffre à côté de l’agent.
- Pas de clé de signature. Les licences sont émises par le cloud Veilio.