> For the complete documentation index, see [llms.txt](https://cristiandis.gitbook.io/ntix/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cristiandis.gitbook.io/ntix/ntix-documentation/docs-it/quick-start.md).

# Avvio rapido

## Avvio rapido

{% stepper %}
{% step %}

### Installa NTIX

Scarica l'ultima versione da [Rilasci GitHub](https://github.com/Cristiandis/NTIX/releases), installa tramite Scoop oppure compila dal codice sorgente:

```bash
# Scoop (consigliato)
scoop bucket add ntix https://github.com/Cristiandis/scoop-ntix
scoop install ntix
```

```bash
# Compila dal codice sorgente
git clone https://github.com/Cristiandis/NTIX.git
cd NTIX
cargo build --release
```

Gli artefatti della release (ZIP e MSI) sono generati da `cargo-dist`. Il binario si trova in `target/x86_64-pc-windows-gnu/release/ntix.exe`.

Verifica l'installazione:

```bash
ntix --version
```

{% endstep %}

{% step %}

### Configura la tua configurazione

Basta eseguire `ntix diff` - NTIX creerà una configurazione predefinita in `~/ntix/config.lua`:

```
Configurazione predefinita creata in C:\Users\you\ntix\config.lua
Modificalo per aggiungere i tuoi pacchetti, poi esegui di nuovo ntix diff.
```

Modifica il file per aggiungere i tuoi pacchetti:

```lua
local options = {
    winget = { enable = true, acceptAgreements = true },
    chocolatey = { enable = true, yes = true },
    scoop = { enable = true, buckets = { "main", "extras" } }
}

local pkgs = {}
pkgs.winget = { "Google.Chrome", "7zip.7zip" }
pkgs.chocolatey = { "ripgrep" }
pkgs.scoop = { "fd", "bat" }

return { options = options, pkgs = pkgs }
```

Abilita solo i gestori di pacchetti che hai installato.
{% endstep %}

{% step %}

### Anteprima delle modifiche

Esegui `ntix diff` per vedere cosa cambierebbe senza installare nulla:

```bash
ntix diff
```

Vedrai un output come:

```
Da installare:
  winget: Google.Chrome (ultima versione)
  winget: 7zip.7zip (ultima versione)
  chocolatey: ripgrep (ultima versione)
  scoop: fd (ultima versione)
  scoop: bat (ultima versione)
```

Puoi anche specificare un percorso di configurazione personalizzato: `ntix diff ./my-config.lua`
{% endstep %}

{% step %}

### Applica le modifiche

Esegui `ntix apply` con privilegi di amministratore per installare i pacchetti:

```bash
ntix apply
```

{% hint style="warning" %}
`ntix apply` richiede privilegi di amministratore. Fai clic destro sul terminale e seleziona "Esegui come amministratore".
{% endhint %}

NTIX installerà tutti i pacchetti elencati e creerà un file di stato per tenere traccia di ciò che ha gestito.
{% endstep %}
{% endstepper %}

### E adesso?

* Blocca versioni specifiche per mantenere stabili i pacchetti critici
* Gestisci i file di configurazione (dotfiles, impostazioni) con `configFiles`
* Configura più ambienti per lavoro e uso personale
* Scopri i colori e le sezioni dell'output di diff