Passa al contenuto principale

Per iniziare

Benvenuto in Gäld — la contabilità open-source svizzera per liberi professionisti e piccole imprese.

Requisiti​

Scegli uno dei due metodi di installazione:

MetodoRequisiti
DockerDocker + Docker Compose
ManualePHP 8.2+, PostgreSQL 16+, Redis 7+, Node.js 20+

Avvio rapido con 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

Apri http://localhost:8080. La procedura guidata ti aiuterà a creare la tua organizzazione e l'account amministratore.

Per precompilare il database con dati di esempio (fatture, spese, contatti) a scopo di test:

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

Installazione manuale​

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

Apri http://localhost:8000.

La procedura guidata di configurazione​

Al primo avvio, gaeld:install (o la procedura guidata web) chiede:

  • Nome dell'organizzazione — il nome della tua azienda o ragione commerciale
  • Paese — Svizzera (CH) selezionata per impostazione predefinita
  • Inizio dell'esercizio fiscale — 1 gennaio per impostazione predefinita
  • E-mail e password dell'amministratore

Il piano dei conti svizzero (Kontenrahmen KMU) e le aliquote IVA (8,1 %, 2,6 %, 3,8 %, 0 %) vengono configurati automaticamente.

Aggiornamenti​

Dopo aver scaricato una nuova versione:

php artisan gaeld:update

Questo comando esegue le migrazioni in sospeso, svuota le cache e riavvia il worker della coda in modo sicuro.

Prossimi passi​

  • Basi di contabilità — capire la partita doppia in Gäld
  • Fatture — creare e inviare la prima fattura
  • Spese — registrare una spesa aziendale
  • Banca — importare un estratto conto e riconciliare
  • IVA — gestire l'IVA svizzera
  • Self-hosting — distribuire sul proprio server