> ## Documentation Index
> Fetch the complete documentation index at: https://docs.casebender.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Guida Rapida

> Distribuisci CaseBender localmente in pochi minuti

<Tip>
  **Cerchi un modo più semplice?** Usa il nostro [Installatore Desktop](/it/deployment/desktop-installer) per la distribuzione con un clic e configurazione automatica. Nessuna riga di comando richiesta!
</Tip>

## Prerequisiti

Prima di iniziare, assicurati di avere installato quanto segue sul tuo sistema:

* Docker Engine (20.10.0 o superiore)
* Docker Compose (v2.0.0 o superiore)
* OpenSSL (per generare certificati SSL)

### Installazione di Docker

#### Per macOS:

1. Scarica e installa Docker Desktop da [Docker Hub](https://hub.docker.com/editions/community/docker-ce-desktop-mac)
2. Segui la procedura guidata di installazione
3. Verifica l'installazione:

```bash theme={null}
docker --version
docker-compose --version
```

#### Per Linux (Ubuntu/Debian):

```bash theme={null}
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin
```

Verifica l'installazione:

```bash theme={null}
docker --version
docker-compose --version
```

#### Per Windows:

1. Scarica e installa Docker Desktop da [Docker Hub](https://hub.docker.com/editions/community/docker-ce-desktop-windows)
2. Segui la procedura guidata di installazione
3. Verifica l'installazione:

```bash theme={null}
docker --version
docker-compose --version
```

## Distribuzione Locale

### Passo 1: Clonare il Repository

```bash theme={null}
git clone https://github.com/casebender/casebender.git
cd casebender
```

### Passo 2: Configurazione dell'Ambiente

Crea un file `.env` nella directory principale:

```bash theme={null}
cp .env.example .env
```

Modifica il file `.env` per configurare le tue variabili d'ambiente:

```
DB_HOST=postgres
DB_PORT=5432
DB_NAME=casebender
DB_USER=postgres
DB_PASSWORD=your_secure_password

REDIS_HOST=redis
REDIS_PORT=6379

JWT_SECRET=your_jwt_secret_key
```

### Passo 3: Avviare i Servizi

```bash theme={null}
docker-compose up -d
```

Questo comando avvierà tutti i servizi necessari:

* API Backend (Node.js)
* Frontend (React)
* Database (PostgreSQL)
* Redis (per cache e code)

### Passo 4: Verificare la Distribuzione

Verifica che tutti i container siano in esecuzione:

```bash theme={null}
docker-compose ps
```

Dovresti vedere tutti i servizi con stato "Up".

### Passo 5: Accedere all'Applicazione

* **Interfaccia Utente**: [http://localhost:3000](http://localhost:3000)
* **API**: [http://localhost:8000](http://localhost:8000)
* **Documentazione API**: [http://localhost:8000/api-docs](http://localhost:8000/api-docs)

### Credenziali di Accesso Predefinite

Dopo aver distribuito CaseBender, puoi accedere con le seguenti credenziali predefinite:

```
Nome utente: admin@casebender.app
Password: secret1234
```

<Warning>
  Per motivi di sicurezza, si consiglia vivamente di modificare queste credenziali predefinite subito dopo il primo accesso.
</Warning>

## Configurazione Iniziale

### Creare un Account Amministratore

```bash theme={null}
docker-compose exec api npm run create-admin
```

Segui le istruzioni per creare un account amministratore.

### Importare Dati di Esempio (Opzionale)

```bash theme={null}
docker-compose exec api npm run import-sample-data
```

## Risoluzione dei Problemi

### Verificare i Log

Se riscontri problemi, controlla i log dei container:

```bash theme={null}
docker-compose logs -f api
docker-compose logs -f frontend
docker-compose logs -f postgres
```

### Problemi Comuni

#### Errore di Connessione al Database

Assicurati che le credenziali del database nel file `.env` siano corrette e che il container PostgreSQL sia in esecuzione:

```bash theme={null}
docker-compose ps postgres
```

#### Problemi di Permessi

Se riscontri problemi di permessi nell'accesso ai volumi Docker:

```bash theme={null}
sudo chown -R $(whoami):$(whoami) ./data
```

## Passi Successivi

Ora che hai CaseBender in esecuzione localmente, puoi:

1. [Configurare Integrazioni](/it/settings/integrations/introduction)
2. [Personalizzare Flussi di Lavoro](/it/settings/workflows/introduction)
3. [Esplorare la Gestione degli Avvisi](/it/alerts/list-view)
4. [Imparare sulla Gestione dei Casi](/it/cases/introduction)