Aller au contenu principal

Installation

Guide d'installation d'Aaperture pour le développement local.

Prérequis​

  • Node.js : Version 22 ou supérieure
  • PostgreSQL : Version 14 ou supérieure
  • Redis : Version 6 ou supérieure (optionnel mais recommandé)
  • Docker : Pour le développement local (recommandé)

Installation Rapide​

1. Cloner le Repository​

git clone https://github.com/aaperture/aaperture.git
cd aaperture

2. Configuration de l'Environnement​

Copiez le fichier .env.example vers .env :

cp .env.example .env

Éditez .env et configurez les variables nécessaires (voir Variables d'Environnement).

3. Installation des Dépendances​

npm install

4. Synchronisation de l'Environnement​

make sync-env

5. Démarrage avec Docker​

make dev

Cette commande :

  • Démarre PostgreSQL, Redis, et les services nécessaires
  • Lance le backend et le frontend
  • Configure HTTPS local avec Caddy

6. Migrations de Base de Données​

make migrate

7. Accès à l'Application​

L'application sera accessible sur :

Vérification de l'Installation​

  1. Ouvrez https://localhost:5173 dans votre navigateur
  2. Acceptez le certificat auto-signé (pour le développement local)
  3. Connectez-vous avec Google OAuth

Dépannage​

Problèmes de Certificat HTTPS​

Pour macOS, ajoutez le certificat aux certificats de confiance :

sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain infra/caddy-data/caddy/pki/authorities/local/root.crt

Redémarrez votre navigateur après avoir ajouté le certificat.

Problèmes de Base de Données​

Vérifiez que PostgreSQL est bien démarré :

docker ps | grep postgres

Problèmes de Port​

Si les ports 5173 ou 8080 sont déjà utilisés, modifiez-les dans docker-compose.yml.

Prochaines Étapes​