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

# File Manager

> Il file manager si collega al tuo bucket compatibile con S3 per archiviare e servire i file e le immagini dei tuoi template email. Un endpoint CDN facoltativo serve quei file più velocemente.

![Schermata del File Manager](https://www.notifuse.com/docs/assets/screenshots/file_manager.png)

## Configurazione dello storage S3

Configura il tuo storage compatibile con S3 con queste impostazioni:

- **Endpoint S3**: l'URL dell'endpoint del tuo storage compatibile con S3
- **Chiave di accesso S3**: la chiave di accesso per l'autenticazione
- **Chiave segreta S3**: la chiave segreta per l'autenticazione
- **Bucket S3**: il nome del bucket in cui verranno archiviati i file
- **Regione S3**: la regione dello storage (per esempio us-east-1)

## Configurazione della CDN

### Endpoint CDN

- **A cosa serve**: URL della CDN che mette in cache i tuoi file
- **Vantaggio**: consegna dei file più rapida e costi di banda ridotti
- **Facoltativo**: non obbligatorio, ma consigliato

### Personalizzazione degli URL

Quando è configurato un endpoint CDN, gli URL dei file nei tuoi template email usano l'URL della CDN invece dell'URL S3 diretto.

## Configurazione CORS

Perché il file manager possa caricare i file direttamente dal tuo browser, configura il CORS (Cross-Origin Resource Sharing) sul tuo bucket.

### Cloudflare R2 / AWS S3

Crea una policy CORS con questa configurazione:

```json
[
  {
    "AllowedOrigins": ["*"],
    "AllowedMethods": ["GET", "POST", "HEAD", "DELETE", "PUT"],
    "AllowedHeaders": ["*"]
  }
]
```

> [!TIP]
>
> In produzione, sostituisci `"*"` in `AllowedOrigins` con l'URL della tua console Notifuse, per una sicurezza maggiore.

### Google Cloud Storage

Per GCS, usa il comando `gsutil` con un file di configurazione JSON:

```json
[
  {
    "origin": ["*"],
    "method": ["GET", "POST", "HEAD", "PUT", "DELETE", "OPTIONS"],
    "responseHeader": ["Content-Type", "*"]
  }
]
```

Applica la configurazione CORS:

```bash
gsutil cors set cors.json gs://your-bucket-name
```

## Provider di storage supportati

I file si possono caricare su qualsiasi servizio di storage compatibile con S3:

- Amazon S3
- Cloudflare R2
- DigitalOcean Spaces
- Wasabi
- MinIO
- Backblaze B2
- Google Cloud Storage (API S3)

## Opzione S3 self-hosted

Se preferisci non usare un provider di storage cloud, puoi eseguire il nostro server di storage self-hosted compatibile con S3:

> [card] [Storage S3 self-hosted](https://github.com/Notifuse/selfhost_s3)
>
> Un server di storage leggero, basato su Docker e compatibile con S3, per fare self-hosting di Notifuse senza dipendenze esterne.

È adatto a:

- Ambienti isolati dalla rete o offline
- Sviluppo e test
- Utenti che vogliono il pieno controllo sui propri dati
- Evitare i costi di un provider cloud

## Uso dei file

Una volta configurato, i file caricati si possono usare per:

- Le immagini dei template email
- Gli allegati
- Le risorse del brand (loghi, intestazioni)
- Qualsiasi contenuto multimediale delle tue campagne email

## Limiti

Il file manager elenca i primi 10.000 file di un bucket. In un bucket più grande, il conteggio delle cartelle, la dimensione totale e la ricerca considerano solo quei file; gli altri file restano archiviati e continuano a funzionare nelle tue email.

## Integrazione con l'editor dei template

Il file manager è disponibile dall'editor visuale delle email:

- **Accesso da una finestra modale**: il file manager si apre in una finestra modale mentre modifichi un template
- **Integrazione diretta**: seleziona e inserisci file dall'editor
- **Caricamento in tempo reale**: carica nuovi file senza uscire dall'editor dei template
