Navigazione Docs

Installazione

Come installare Fatturino sul tuo server in 5 minuti.

Requisiti

  • Docker e Docker Compose installati
  • Un dominio (opzionale, puoi iniziare con localhost)
  • Porta 80 e 443 disponibili (o gestisci tu il routing)

Installazione Rapida

1. Clona il Progetto

git clone https://codeberg.org/fatturino/fatturino.git
cd fatturino

2. Configura l'Ambiente

cp .env.example .env
# Modifica .env con le tue preferenze (APP_KEY, MAIL, database, etc)

3. Avvia i Container

docker compose up -d

Questo avvia:

  • App (Laravel + Livewire) sulla porta 80
  • Database (PostgreSQL di default, configurable)
  • Redis (per cache e queues)

4. Inizializza il Database

docker compose exec app php artisan migrate
docker compose exec app php artisan db:seed

5. Accedi

Apri http://localhost nel browser. Usa le credenziali di demo (controllate nel seeder).

Configurazione Post-Install

Email (opzionale)

Per password reset e notifiche, configura SMTP in .env:

MAIL_DRIVER=smtp
MAIL_HOST=smtp.tuoserver.com
MAIL_PORT=587
MAIL_USERNAME=tuo@email.com
MAIL_PASSWORD=password

OpenAPI per l'Invio Fatture

  1. Registrati su OpenAPI
  2. Crea un account e acquista credito
  3. In Fatturino: Settings → Integrations → OpenAPI
  4. Inserisci le tue credenziali API

Backup Automatici

Fatturino non include backup di default. Consigliamo:

# Backup PostgreSQL
docker compose exec db pg_dump -U postgres fatturino > backup.sql

# O usa un tool come Restic, Borg, etc

Prossimi Passi