Aller au contenu
OpenAlternance

Installation locale

Mode SQLite : tout tourne sur ta machine, aucune base distante.

Prérequis

Bun installé (bun --version).

Étapes

Fenêtre de terminal
git clone <url-du-depot> openalternance
cd openalternance
bun install
cp .env.example .env

Édite .env et remplace OPENALTERNANCE_PASSWORD par un mot de passe de 16 caractères minimum. Laisse DATABASE_URL vide.

Fenêtre de terminal
bun run setup   # à lancer depuis la racine du dépôt
bun run serve

Ouvre http://127.0.0.1:3000 et connecte-toi avec le mot de passe.

bun run setup crée le schéma puis, uniquement si aucune entreprise n’existe, ajoute les exemples (Acme SARL, Globex SAS, Initech, lettres et documents). Il ne touche jamais aux lettres existantes. Relancé plus tard, il ne fait que migrer.

Où sont les données

Par défaut data/openalternance.db (dossier créé automatiquement, ignoré par git).

Sauvegarde : arrêter le serveur, copier data/openalternance.db.

Pour placer la base ailleurs (clé USB, disque externe), dans .env :

DATABASE_URL=sqlite:///media/usb/openalternance.db

Le chemin absolu suit sqlite:// (d’où les trois /). Le dossier parent est créé si besoin. Relance bun run setup après tout changement d’URL : c’est une base différente.

Sécurité

Le serveur écoute sur 127.0.0.1 uniquement. Le mot de passe reste demandé : 10 échecs en 15 minutes bloquent l’IP, les sessions durent 30 jours.

Ne l’expose jamais sur 0.0.0.0 ni derrière un reverse proxy : la limite de débit se base sur l’adresse du socket et le serveur refuse tout en-tête Host autre que 127.0.0.1 ou localhost.