@intlayer/docs 9.5.5 → 9.5.7

package/docs/it/benchmark/nextjs.md

@@ -112,19 +112,19 @@ Infine, `Intlayer` applica un'ottimizzazione build-time in modo che `useIntlayer
 Per questo benchmark, abbiamo confrontato le seguenti librerie:
 
 - `Base App` (Nessuna libreria i18n)
-- `next-intlayer` (v9.5.1)
-- [`@intlayer/next-intl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/next-intl.md) (v9.5.1)
-- [`@intlayer/next-i18next`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/next-i18next.md) (v9.5.1)
-- `next-i18next` (v16.3.0)
-- `next-intl` (v4.14.2)
-- `@lingui/core` (v6.6.0)
-- `next-translate` (v3.2.0)
-- `next-international` (v1.3.1)
-- `@inlang/paraglide-js` (v2.15.1)
-- `@tolgee/react` (v7.2.0)
-- `@lingo.dev/compiler` (v0.4.12)
-- `wuchale` (v0.26.6)
-- `gt-next` (v11.1.24)
+- [`next-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/next-intlayer/exports.md) (v9.5.6)
+- [`@intlayer/next-intl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/next-intl.md) (v9.5.6)
+- [`@intlayer/next-i18next`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/next-i18next.md) (v9.5.6)
+- [`next-i18next`](https://github.com/i18next/next-i18next) (v16.3.0)
+- [`next-intl`](https://github.com/amannn/next-intl) (v4.14.2)
+- [`@lingui/core`](https://github.com/lingui/js-lingui) (v6.6.0)
+- [`next-translate`](https://github.com/aralroca/next-translate) (v3.2.0)
+- [`next-international`](https://github.com/QuiiBz/next-international) (v1.3.1)
+- [`@inlang/paraglide-js`](https://github.com/opral/paraglide-js) (v2.15.1)
+- [`@tolgee/react`](https://github.com/tolgee/tolgee-js) (v7.2.0)
+- [`@lingo.dev/compiler`](https://github.com/lingodotdev/lingo.dev) (v0.4.12)
+- [`wuchale`](https://github.com/wuchalejs/wuchale) (v0.26.6)
+- [`gt-next`](https://github.com/generaltranslation/gt) (v11.1.24)
 
 Ho utilizzato `Next.js` versione `16.3.4` con App Router.
 

package/docs/it/benchmark/solid.md

@@ -65,7 +65,7 @@ L'autre impatto riguarda l'esperienza dello sviluppatore (DX): come si dichiara
 
 ## TL;DR
 
-- **Intlayer**: Scelta consigliata per applicazioni Solid professionali che necessitano di funzionalità avanzate e ottimizzazione (v9.5.0).
+- **Intlayer**: Scelta consigliata per applicazioni Solid professionali che necessitano di funzionalità avanzate e ottimizzazione (v9.5.6).
 - **@solid-primitives/i18n**: Eccellente alternativa leggera per progetti semplici, sebbene manchi di funzionalità avanzate come il lazy loading.
 - **solid-i18next**: Opzione standard ma pesante (~3.5× Intlayer) con gli stessi svantaggi di React i18next.
 - **Paraglide**: Approccio innovativo ma DX complessa e problemi di tree-shaking in alcune configurazioni.
@@ -100,10 +100,10 @@ Le sintassi costruite attorno a `t('a.b.c')` sono molto comode ma spesso incorag
 Per questo benchmark, abbiamo confrontato le seguenti librerie:
 
 - `Base App` (Nessuna libreria i18n)
-- `solid-intlayer` (v9.5.0)
-- `@solid-primitives/i18n` (v2.2.1)
-- `i18next` (v26.0.8) + `@mbarzda/solid-i18next` (v1.4.1)
-- `@inlang/paraglide-js` (v2.25.1)
+- [`solid-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/solid-intlayer/exports.md) (v9.5.6)
+- [`@solid-primitives/i18n`](https://github.com/solidjs-community/solid-primitives/tree/main/packages/i18n) (v2.2.1)
+- [`i18next`](https://github.com/i18next/i18next) (v26.0.8) + [`@mbarzda/solid-i18next`](https://github.com/mbarzda/solid-i18next) (v1.4.1)
+- [`@inlang/paraglide-js`](https://github.com/opral/paraglide-js) (v2.25.1)
 
 Il framework è `Solid` con un'app multilingue di **10 pagine** e **10 lingue**.
 

package/docs/it/benchmark/svelte.md

@@ -65,7 +65,7 @@ L'altro impatto riguarda l'esperienza dello sviluppatore (DX): come si dichiara
 
 ## TL;DR
 
-- **Intlayer**: La scelta più efficiente in termini di prestazioni (v9.5.0) con il footprint più ridotto.
+- **Intlayer**: La scelta più efficiente in termini di prestazioni (v9.5.6) con il footprint più ridotto.
 - **Paraglide**: Forte candidato per il tree-shaking ma presenta una DX più complessa e un overhead di reattività.
 - **svelte-i18n**: Completo e standard per Svelte, ma comporta un peso del bundle molto maggiore (~4.5 volte Intlayer).
 
@@ -99,9 +99,9 @@ Le sintassi costruite attorno a `t('a.b.c')` sono molto comode ma spesso incorag
 Per questo benchmark, abbiamo confrontato le seguenti librerie:
 
 - `Base App` (Nessuna libreria i18n)
-- `svelte-intlayer` (v9.5.0)
-- `svelte-i18n` (v4.0.1)
-- `@inlang/paraglide-js` (v2.25.1)
+- [`svelte-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/svelte-intlayer/exports.md) (v9.5.6)
+- [`svelte-i18n`](https://github.com/kaisermann/svelte-i18n) (v4.0.1)
+- [`@inlang/paraglide-js`](https://github.com/opral/paraglide-js) (v2.25.1)
 
 Il framework è `Svelte` con un'app multilingue di **10 pagine** e **10 lingue**.
 

package/docs/it/benchmark/tanstack.md

@@ -65,7 +65,7 @@ L'altro impatto riguarda la developer experience (DX): come si dichiara il conte
 
 ## TL;DR
 
-- **Intlayer**: Fornisce le migliori prestazioni e la dimensione del bundle più ridotta (v9.5.1) per TanStack Start.
+- **Intlayer**: Fornisce le migliori prestazioni e la dimensione del bundle più ridotta (v9.5.6) per TanStack Start.
 - **react-i18next** & **use-intl**: Alternative mature con ecosistemi ampi, ma significativamente più pesanti e complesse da ottimizzare.
 - **Paraglide**: Idea innovativa di tree-shaking che non funziona nella pratica. DX complessa e sovraccarico di reattività in TanStack Start.
 - **Da evitare**: **General Translation (GT)** e **Lingo.dev** a causa di gravi problemi di prestazioni, limiti di quota AI e vendor lock-in.
@@ -100,18 +100,19 @@ Le sintassi costruite attorno a `const t = useTranslation()` + `t('a.b.c')` sono
 Per questo benchmark, abbiamo confrontato le seguenti librerie:
 
 - `Base App` (Nessuna libreria i18n)
-- `react-intlayer` (v9.5.1)
-- `@intlayer/use-intl` (v9.5.1)
-- [`@intlayer/lingui`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/lingui.md) (v9.5.1)
-- `react-i18next` (v17.0.13)
-- `use-intl` (v4.14.2)
-- `@lingui/core` (v6.6.0)
-- `@inlang/paraglide-js` (v2.15.1)
-- `@tolgee/react` (v7.2.0)
-- `react-intl` (v10.1.26)
-- `wuchale` (v0.26.6)
-- `gt-react` (v10.18.3)
-- `lingo.dev` (v0.138.7)
+- [`react-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/exports.md) (v9.5.6)
+- [`@intlayer/use-intl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/next-intl.md) (v9.5.6)
+- [`@intlayer/lingui`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/lingui.md) (v9.5.6)
+- [`@intlayer/react-i18next`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/react-i18next.md) (v9.5.6)
+- [`react-i18next`](https://github.com/i18next/react-i18next) (v17.0.13)
+- [`use-intl`](https://github.com/amannn/next-intl/tree/main/packages/use-intl) (v4.14.2)
+- [`@lingui/core`](https://github.com/lingui/js-lingui) (v6.6.0)
+- [`@inlang/paraglide-js`](https://github.com/opral/paraglide-js) (v2.15.1)
+- [`@tolgee/react`](https://github.com/tolgee/tolgee-js) (v7.2.0)
+- [`react-intl`](https://github.com/formatjs/formatjs) (v10.1.26)
+- [`wuchale`](https://github.com/wuchalejs/wuchale) (v0.26.6)
+- [`gt-react`](https://github.com/generaltranslation/gt) (v10.18.3)
+- [`lingo.dev`](https://github.com/lingodotdev/lingo.dev) (v0.138.7)
 
 Il framework è `TanStack Start` con un'app multilingue di **10 pagine** e **10 lingue**.
 

package/docs/it/benchmark/vue.md

@@ -65,7 +65,7 @@ L'altro impatto riguarda l'esperienza dello sviluppatore (DX): come si dichiara
 
 ## TL;DR
 
-- **Intlayer**: La soluzione più leggera (v9.5.0) con scoping e caricamento dinamico nativi.
+- **Intlayer**: La soluzione più leggera (v9.5.6) con scoping e caricamento dinamico nativi.
 - **vue-i18n**: Lo standard del settore con un ricco ecosistema, ma può essere significativamente più pesante e difficile da ottimizzare per il code-splitting in applicazioni di grandi dimensioni.
 - **fluent-vue**: Organizzazione dei messaggi innovativa ma manca di type-safety e risulta essere una soluzione estremamente pesante.
 
@@ -99,10 +99,10 @@ Le sintassi costruite attorno a `const { t } = useI18n()` + `t('a.b.c')` sono mo
 Per questo benchmark, abbiamo confrontato le seguenti librerie:
 
 - `Base App` (Nessuna libreria i18n)
-- `vue-intlayer` (v9.5.0)
-- [`@intlayer/vue-i18n`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/vue-i18n.md) (v9.5.1)
-- `vue-i18n` (v11.4.0)
-- `fluent-vue` (v3.8.2)
+- [`vue-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/vue-intlayer/exports.md) (v9.5.6)
+- [`@intlayer/vue-i18n`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/vue-i18n.md) (v9.5.6)
+- [`vue-i18n`](https://github.com/intlify/vue-i18n) (v11.4.0)
+- [`fluent-vue`](https://github.com/fluent-vue/fluent-vue) (v3.8.2)
 
 Il framework è `Vue` con un'app multilingue di **10 pagine** e **10 lingue**.
 

package/docs/it/chrome_extension.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2026-09-22
+updatedAt: 2026-09-22
+title: Estensione Chrome & Firefox, Scanner i18n & SEO
+description: Ispeziona la configurazione i18n di qualsiasi sito web con l'estensione Chrome di Intlayer. Rileva framework, libreria i18n, lingue, tag hreflang e SEO ed esegui un audit SEO i18n completo.
+keywords:
+  - Estensione Chrome
+  - Scanner i18n
+  - Controllo hreflang
+  - SEO multilingue
+  - Intlayer
+  - Localizzazione
+  - Strumenti di sviluppo
+slugs:
+  - doc
+  - chrome-extension
+history:
+  - version: 9.5.6
+    date: 2026-09-22
+    changes: "Inizializzazione cronologia"
+author: aymericzip
+---
+
+# Estensione Chrome & Firefox: Scanner i18n & SEO
+
+## Panoramica
+
+[**Intlayer i18n Scanner**](https://chromewebstore.google.com/detail/intlayer_i18n_scanner/pmlehcgmjmfimmjnembihbakhnheiabc) è l'estensione ufficiale di Chrome per **Intlayer**. Aprila su qualsiasi sito web per vedere come il sito gestisce l'internazionalizzazione: quale framework e libreria i18n utilizza, quali lingue espone e se i suoi tag SEO multilingue sono impostati correttamente.
+
+Funziona su qualsiasi sito web, indipendentemente dal fatto che utilizzi o meno Intlayer.
+
+![Estensione Chrome Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/assets/chrome_extension.png?raw=true)
+
+[Link all'estensione per Chrome](https://chromewebstore.google.com/detail/intlayer_i18n_scanner/pmlehcgmjmfimmjnembihbakhnheiabc)
+
+[Link al componente aggiuntivo per Firefox](https://addons.mozilla.org/en-US/firefox/addon/intlayer-i18n-scanner/)
+
+## Funzionalità
+
+- **Rilevamento delle tecnologie**: identifica il framework (Next.js, Nuxt, Astro, SvelteKit, Angular, Vue.js, Qwik, React, Gatsby, WordPress) e la libreria i18n (Intlayer, i18next, Vue I18n, @nuxtjs/i18n, Angular @angular/localize, next-intl / next-i18next, Weglot, Localize, WPML, Polylang). Ogni rilevamento mostra gli elementi che lo hanno attivato, come una variabile globale, un cookie o un marcatore DOM.
+- **Lingue**: elenca le lingue trovate nell'attributo `lang`, nei tag hreflang e `og:locale`, nel prefisso di lingua dell'URL e nei cookie o voci di memorizzazione della lingua.
+- **Tag SEO i18n**: controlla `html lang`, `html dir`, il link canonico, i tag hreflang, `x-default`, `og:locale` e la percentuale di link interni localizzati.
+- **Navigazione tra le locale**: passa con un clic dalla pagina corrente a una delle sue versioni localizzate, in base ai suoi tag hreflang.
+- **Ricerca nella sitemap**: cerca tra tutte le pagine elencate nella sitemap del sito e le apre nella scheda corrente.
+- **Audit completo**: esegue lo stesso audit dello [Scanner SEO i18n](https://intlayer.org/i18n-seo-scanner) e mostra un punteggio in tempo reale.
+
+## Installazione
+
+<Tabs group="browser">
+  <Tab label="Chrome" value="chrome">
+
+Installa [**Intlayer i18n Scanner**](https://chromewebstore.google.com/detail/intlayer_i18n_scanner/pmlehcgmjmfimmjnembihbakhnheiabc) dal Chrome Web Store, quindi fissala sulla barra degli strumenti.
+
+L'estensione funziona su Chrome e su qualsiasi browser basato su Chromium che supporta le estensioni del Chrome Web Store (Edge, Brave, Arc, Opera).
+
+  </Tab>
+  <Tab label="Firefox" value="firefox">
+
+Installa [**Intlayer i18n Scanner**](https://addons.mozilla.org/en-US/firefox/addon/intlayer-i18n-scanner/) dai componenti aggiuntivi di Firefox, quindi fissala sulla barra degli strumenti.
+
+  </Tab>
+</Tabs>
+
+## Utilizzo
+
+### Ispezionare una pagina
+
+1. Apri il sito web che desideri ispezionare.
+2. Fai clic sull'icona di **Intlayer i18n Scanner** nella barra degli strumenti.
+3. Il popup mostra le sezioni **Tecnologie rilevate**, **Lingue** e **Tag SEO i18n** per la pagina corrente.
+
+Il rilevamento viene eseguito localmente nel browser, solo sulla scheda attiva.
+
+### Navigare tra le locale
+
+![Navigazione dell'estensione Chrome Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/assets/chrome_extension_navigation.png?raw=true)
+
+La sezione **Naviga** elenca le **Versioni localizzate** della pagina corrente, lette dai suoi tag hreflang. Clicca su una locale per aprire quella versione nella scheda corrente.
+
+In **Pagine della sitemap**, digita per cercare tra gli URL della sitemap del sito, poi clicca su un risultato per aprirlo.
+
+### Eseguire un audit completo
+
+![Punteggio dell'audit dell'estensione Chrome Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/assets/chrome_extension_audit_score.png?raw=true)
+
+Scorri fino alla sezione **Audit completo** e fai clic su **Esegui audit i18n completo**. I risultati arrivano in streaming al termine di ogni verifica, raggruppati in:
+
+- **Pagina**: attributi `html lang` e `dir`, lingua corrente, tag hreflang, `x-default`, link canonico, link interni localizzati, selettore di lingua, icone delle bandiere e contenuto non utilizzato della lingua incluso nel bundle JavaScript.
+- **Robots.txt**: presenza e verifica che i percorsi di lingua rimangano accessibili ai crawler.
+- **Sitemap**: presenza, ogni lingua elencata, link alternativi e `x-default`.
+- **Dominio**: numero di lingue scoperte nell'intero sito.
+
+Ogni controllo è contrassegnato come superato, avviso o fallito e il punteggio riassume lo stato generale del SEO i18n della pagina.
+
+## Privacy e autorizzazioni
+
+L'estensione richiede autorizzazioni minime:
+
+- **activeTab** e **scripting**: il rilevatore viene eseguito solo sulla scheda attualmente visualizzata e solo quando si apre il popup.
+- **back.intlayer.org**: utilizzato solo quando si esegue un audit completo. L'URL della pagina corrente viene inviato all'API di Intlayer per essere scansionato.
+
+Non viene raccolta alcuna cronologia di navigazione e nulla viene eseguito in background.
+
+## FAQ
+
+<FAQ>
+
+<Question title="Il sito web deve utilizzare Intlayer?">
+
+No. L'estensione ispeziona qualsiasi sito web, indipendentemente dal framework o dalla libreria i18n utilizzata.
+
+</Question>
+<Question title="Perché una tecnologia non viene rilevata?">
+
+Il rilevamento si basa su ciò che la pagina espone nel browser: variabili globali, cookie, meta tag e marcatori DOM. Alcune build di produzione rimuovono questi marcatori, quindi una libreria può essere in uso senza lasciare una traccia visibile.
+
+</Question>
+<Question title="Come posso risolvere i problemi riscontrati dall'audit?">
+
+La maggior parte dei controlli corrisponde a un'impostazione di routing o di metadati. Con Intlayer, hreflang, canonico, `x-default`, link localizzati, sitemap e robots.txt vengono generati dalla tua [configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md). Consulta la guida all'integrazione per il tuo framework, ad esempio [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_nextjs_16.md), [Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_nuxt.md) o [TanStack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_tanstack.md).
+
+</Question>
+
+</FAQ>
+
+## Strumenti correlati
+
+- [Estensione VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/vs_code_extension.md)
+- [Server MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/mcp_server.md)
+- [Server LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/lsp.md)

package/docs/it/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2026-09-12
+updatedAt: 2026-09-21
 title: CLI - Tutti i comandi della CLI di Intlayer per il tuo sito web multilingue
 description: Scopri come utilizzare la CLI di Intlayer per gestire il tuo sito web multilingue. Segui i passaggi in questa documentazione online per configurare il tuo progetto in pochi minuti.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "Aggiungi il comando init infra"
   - version: 9.5.2
     date: 2026-09-12
     changes: "Sostituzione del comando `ci` con il flag `--ci`"
@@ -151,6 +154,7 @@ Per vedere come configurare le lingue disponibili o altri parametri, fai riferim
 ### Configurazione
 
 - **[Inizializza Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/init.md)** - Configura Intlayer nel tuo progetto con la configurazione automatica
+- **[Configura l'infrastruttura](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/infra.md)** - Installa l'applicazione desktop o auto-ospita il CMS con Docker (all-in-one o Compose)
 - **[Gestisci Configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/configuration.md)** - Ottieni e invia la tua configurazione Intlayer al CMS
 
 ### Gestione della documentazione
@@ -177,6 +181,7 @@ Per vedere come configurare le lingue disponibili o altri parametri, fai riferim
 ```json fileName="package.json"
 "scripts": {
   "intlayer:init": "npx intlayer init",
+  "intlayer:infra": "npx intlayer init infra",
   "intlayer:login": "npx intlayer login",
   "intlayer:build": "npx intlayer build",
   "intlayer:watch": "npx intlayer build --watch",

package/docs/it/cli/infra.md

@@ -0,0 +1,162 @@
+---
+createdAt: 2026-09-21
+updatedAt: 2026-09-21
+title: CLI - Init Infra
+description: Scopri come utilizzare il comando init infra della CLI di Intlayer per installare l'applicazione desktop o auto-ospitare il CMS Intlayer con Docker (contenitore all-in-one o stack Docker Compose).
+keywords:
+  - CLI
+  - Infrastruttura
+  - Auto-hosting
+  - Applicazione desktop
+  - Docker
+  - Docker Compose
+  - CMS
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - infra
+history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "Aggiungi il comando init infra"
+author: aymericzip
+---
+
+# Comando Intlayer CLI Init Infra
+
+## Descrizione
+
+Il comando `init infra` configura l'infrastruttura Intlayer sul tuo computer. Scarica il programma di installazione ospitato per la tua piattaforma (`https://intlayer.org/install.sh` su macOS / Linux, `https://intlayer.org/install.ps1` su Windows) e lo esegue con il terminale collegato, in modo che il menu e l'avanzamento siano mostrati senza modifiche.
+
+Il programma di installazione chiede come desideri eseguire Intlayer:
+
+- **Applicazione desktop**: scarica la dashboard nativa per il tuo sistema operativo e CPU e la apre o la installa. La versione desktop comunica con il backend Intlayer Cloud.
+- **Docker all-in-one**: dashboard + API + MongoDB + Redis + MinIO in un unico contenitore supportato da un volume. Scrive `./intlayer.env` con i segreti generati e scarica l'immagine `intlayer/cms-all`.
+- **Docker Compose**: un contenitore per servizio, per un auto-hosting scalabile. Scrive `docker-compose.yml` e `.env` in `./intlayer/` e scarica le immagini.
+
+Il programma di installazione ospitato è l'unica fonte di verità per il flusso di configurazione: la CLI lo esegue invece di reimplementare gli stessi passaggi, quindi `npx intlayer init infra` e `curl -fsSL https://intlayer.org/install.sh | sh` fanno esattamente la stessa cosa.
+
+## Utilizzo
+
+```bash packageManager="npm"
+npx intlayer init infra [options]
+```
+
+```bash packageManager="yarn"
+yarn intlayer init infra [options]
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer init infra [options]
+```
+
+```bash packageManager="bun"
+bun x intlayer init infra [options]
+```
+
+Lo stesso passaggio è offerto nell'elenco di controllo di `npx intlayer init --interactive`, sotto **Infrastruttura (applicazione desktop / auto-hosting)**.
+
+## Opzioni
+
+- `-m, --mode <mode>` - Opzionale. Salta il menu del programma di installazione ed esegue direttamente una modalità. Valori accettati: `desktop`, `docker` (all-in-one) o `compose`. Qualsiasi altro valore genera un errore elencando le modalità accettate.
+
+## Esempi
+
+### Scegli la modalità in modo interattivo
+
+```bash
+npx intlayer init infra
+```
+
+### Installa l'applicazione desktop
+
+```bash
+npx intlayer init infra --mode desktop
+```
+
+### Auto-ospita con il contenitore all-in-one
+
+```bash
+npx intlayer init infra --mode docker
+```
+
+### Auto-ospita con Docker Compose
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+## Esempio di output
+
+```bash
+npx intlayer init infra --mode compose
+◇  Installer downloaded
+▸ Fetching docker-compose.yml into ./intlayer
+▸ Writing ./intlayer/.env
+▸ Pulling images
+
+  Everything is installed. Two steps left.
+
+  1. Configure a mailer in:
+
+       ./intlayer/.env
+
+     Either RESEND_API_KEY (resend.com) or the MAIL_SMTP_* block — the first
+     account cannot be verified without a working mailer.
+  2. Start the stack:
+
+       cd ./intlayer && docker compose up -d
+
+  Then open http://localhost:3000 — first boot initialises the
+  datastores, so give it a minute. The first account you create becomes the
+  super admin.
+
+    Logs      docker compose logs -f
+    Stop      docker compose down
+    Upgrade   docker compose pull && docker compose up -d
+```
+
+## Impostazioni del programma di installazione
+
+Il programma di installazione legge alcune variabili di ambiente, che la CLI trasmette senza modifiche. Impostale nella tua shell prima di eseguire il comando:
+
+```bash
+INTLAYER_COMPOSE_DIR=./cms npx intlayer init infra --mode compose
+```
+
+| Variabile                 | Predefinito               | Si applica a | Descrizione                                                        |
+| ------------------------- | ------------------------- | ------------ | ------------------------------------------------------------------ |
+| `INTLAYER_MODE`           | _(richiesto)_             | tutte        | `desktop`, `docker` o `compose`, uguale a `--mode`                 |
+| `INTLAYER_DOWNLOAD_DIR`   | `~/Downloads`             | desktop      | Dove viene salvato il programma di installazione dell'app          |
+| `INTLAYER_IMAGE`          | `intlayer/cms-all:latest` | docker       | Immagine all-in-one da scaricare                                   |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`          | docker       | Dove scrivere il file di ambiente                                  |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                | docker       | Nome del contenitore                                               |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`           | docker       | Volume con nome montato in `/data`                                 |
+| `INTLAYER_APP_PORT`       | `3000`                    | docker       | Porta host per la dashboard                                        |
+| `INTLAYER_API_PORT`       | `3100`                    | docker       | Porta host per l'API                                               |
+| `INTLAYER_S3_PORT`        | `9000`                    | docker       | Porta host per l'API S3 MinIO                                      |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                    | docker       | Porta host per la console MinIO                                    |
+| `INTLAYER_COMPOSE_DIR`    | `./intlayer`              | compose      | Dove vengono scritti `docker-compose.yml` e `.env`                 |
+| `INTLAYER_SELFHOST_REF`   | `main`                    | entrambe     | Rif Git da cui vengono recuperati il file compose e il modello env |
+
+> Le variabili di porta modificano solo il lato **host** della mappatura. Le immagini pubblicate includono `http://localhost:3000`, `http://localhost:3100` e `http://localhost:9000` compilati nel pacchetto della dashboard, quindi mantieni i valori predefiniti a meno che non crei le tue immagini: consulta la [guida all'auto-hosting](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/self_hosting.md#limitations).
+
+## Requisiti
+
+- **L'applicazione desktop** richiede [Node.js](https://nodejs.org): l'app incorpora il server della dashboard e lo avvia con il binario `node` del computer.
+- **Le modalità Docker** richiedono [Docker](https://docs.docker.com/get-docker/) (Docker Desktop con backend WSL 2 su Windows). La modalità Compose richiede inoltre il plug-in `docker compose`.
+
+## Note
+
+- La riesecuzione del comando è sicura: un file di ambiente esistente non viene mai sovrascritto, fungendo anche da percorso di aggiornamento (il programma di installazione scarica le immagini più recenti e mantiene i segreti).
+- Il programma di installazione viene scaricato in una directory temporanea ed eliminato al termine, qualunque sia il risultato.
+- Il codice di uscita del comando corrisponde a quello del programma di installazione. Se il download fallisce, la CLI stampa il comando equivalente `curl … | sh` (o `irm … | iex`) in modo da poter eseguire direttamente il programma di installazione.
+- Le modalità Docker richiedono comunque un gestore di posta elettronica per l'invio delle email di accesso. Al termine dell'installazione, configura Resend o SMTP nel file di ambiente generato: consulta [Mailer globale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/self_hosting.md#global-mailer).
+
+## Correlati
+
+- [Guida all'auto-hosting](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/self_hosting.md) - Architettura, primi passi e limitazioni di ciascuna modalità
+- [Inizializza Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/init.md) - Il comando principale `init` e il suo elenco di controllo interattivo
+- [CMS Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md) - Funzionalità della dashboard appena installata

package/docs/it/cli/init.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-12-30
-updatedAt: 2025-12-30
+updatedAt: 2026-09-21
 title: Inizializza Intlayer
 description: Scopri come inizializzare Intlayer nel tuo progetto.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - cli
   - init
 history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "Aggiunta del sottocomando init infra"
   - version: 8.6.4
     date: 2026-03-31
     changes: "Aggiunta opzione --no-gitignore"
@@ -125,6 +128,26 @@ bun x intlayer init --no-gitignore
 
 Questo configurerà tutti i file di configurazione ma non modificherà il tuo `.gitignore`.
 
+### Configura l'infrastruttura (applicazione desktop o auto-hosting):
+
+```bash
+npx intlayer init infra
+```
+
+Scarica ed esegue il programma di installazione ospitato (`https://intlayer.org/install.sh`, o `install.ps1` su Windows), che chiede come desideri eseguire Intlayer:
+
+- **Applicazione desktop** - installa la dashboard nativa sul tuo computer, connessa a Intlayer Cloud.
+- **Docker all-in-one** - dashboard + API + MongoDB + Redis + MinIO in un unico contenitore.
+- **Docker Compose** - un contenitore per servizio, per un auto-hosting scalabile.
+
+Salta il menu con `--mode`:
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+Lo stesso passaggio è offerto da `npx intlayer init --interactive`. Consulta il [riferimento `init infra`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/infra.md) per le impostazioni del programma di installazione e la [guida all'auto-hosting](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/self_hosting.md) per informazioni sulla configurazione di ciascuna modalità.
+
 ## Esempio di output:
 
 ```bash