Zum Hauptinhalt springen

Erste Schritte

Willkommen bei Gäld — Open-Source-Buchhaltung für Schweizer Freiberufler und Kleinunternehmen.

Voraussetzungen​

Wählen Sie eine der beiden Installationsmethoden:

MethodeVoraussetzungen
DockerDocker + Docker Compose
ManuellPHP 8.2+, PostgreSQL 16+, Redis 7+, Node.js 20+

Schnellstart mit 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

Öffnen Sie http://localhost:8080. Der Einrichtungsassistent führt Sie durch die Erstellung Ihrer Organisation und Ihres Administratorkontos.

Um die Datenbank mit Beispieldaten (Rechnungen, Ausgaben, Kontakte) für Tests zu befüllen:

docker-compose exec app php artisan gaeld:install --demo

Manuelle Installation​

git clone https://github.com/Scanix/Gaeld.git
cd Gaeld
composer install
npm install && npm run build
cp .env.example .env
# .env bearbeiten — DB_*, APP_URL, REDIS_HOST setzen
php artisan key:generate
php artisan gaeld:install
php artisan serve

Öffnen Sie http://localhost:8000.

Der Einrichtungsassistent​

Beim ersten Start fragt gaeld:install (oder der Web-Assistent) nach:

  • Organisationsname — Ihr Firmen- oder Handelsname
  • Land — Schweiz (CH) ist standardmässig ausgewählt
  • Beginn des Geschäftsjahres — standardmässig 1. Januar
  • Administrator-E-Mail und Passwort

Der Schweizer Kontenplan (Kontenrahmen KMU) und die MWST-Sätze (8,1 %, 2,6 %, 3,8 %, 0 %) werden automatisch eingerichtet.

Aktuell bleiben​

Nach dem Abrufen einer neuen Version:

php artisan gaeld:update

Dieser Befehl führt ausstehende Migrationen durch, leert Caches und startet den Queue-Worker sicher neu.

Nächste Schritte​