Premiers pas
Bienvenue dans Gäld — la comptabilité open-source suisse pour les indépendants et les petites entreprises.
Prérequis
Choisissez l'une des deux méthodes d'installation :
| Méthode | Prérequis |
|---|---|
| Docker | Docker + Docker Compose |
| Manuel | PHP 8.2+, PostgreSQL 16+, Redis 7+, Node.js 20+ |
Démarrage rapide avec Docker
git clone https://github.com/Scanix/Gaeld.git
cd Gaeld
cp .env.example .env
docker-compose up -d
docker-compose exec app php artisan key:generate
docker-compose exec app php artisan gaeld:install
Ouvrez http://localhost:8080. L'assistant de configuration vous guidera pour créer votre organisation et votre compte administrateur.
Pour préremplir la base de données avec des exemples (factures, dépenses, contacts) à des fins de test :
docker-compose exec app php artisan gaeld:install --demo
Installation manuelle
git clone https://github.com/Scanix/Gaeld.git
cd Gaeld
composer install
npm install && npm run build
cp .env.example .env
# Éditer .env — configurer DB_*, APP_URL, REDIS_HOST
php artisan key:generate
php artisan gaeld:install
php artisan serve
Ouvrez http://localhost:8000.
L'assistant de configuration
Au premier lancement, gaeld:install (ou l'assistant web) demande :
- Nom de l'organisation — votre nom d'entreprise ou nom commercial
- Pays — Suisse (CH) sélectionné par défaut
- Début de l'exercice fiscal — 1er janvier par défaut
- E-mail et mot de passe de l'administrateur
Le plan comptable suisse (Kontenrahmen KMU) et les taux de TVA (8,1 %, 2,6 %, 3,8 %, 0 %) sont configurés automatiquement.
Mise à jour
Après avoir récupéré une nouvelle version :
php artisan gaeld:update
Cette commande exécute les migrations en attente, vide les caches et redémarre le worker de file correctement.
Étapes suivantes
- Bases de la comptabilité — comprendre la comptabilité en partie double dans Gäld
- Factures — créer et envoyer votre première facture
- Dépenses — enregistrer une dépense professionnelle
- Banque — importer un relevé bancaire et rapprocher
- TVA — gérer la TVA suisse
- Auto-hébergement — déployer sur votre propre serveur