> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/unigetui/it/riferimento/installation.md).

# Installare UniGetUI

Tutti i modi per installare UniGetUI in Windows, macOS e Linux, oltre alle opzioni di installazione invisibile all'utente, la modalità portatile, l'aggiornamento di UniGetUI e la disinstallazione.

Questa pagina descrive ogni metodo di installazione, le opzioni di distribuzione invisibile all'utente, la modalità portatile, come UniGetUI si aggiorna e come rimuoverlo. Per la via più rapida, veda [Avvio rapido](/unigetui/it/quick-start.md).

{% hint style="danger" %}
Scarichi UniGetUI solo da [devolutions.net/unigetui](https://devolutions.net/unigetui/), dalle [versioni ufficiali di GitHub](https://github.com/Devolutions/UniGetUI/releases), da Microsoft Store o dai repository ufficiali di WinGet, Scoop e Chocolatey. Gli altri siti non sono affiliati a Devolutions.
{% endhint %}

## Requisiti di sistema

<table><thead><tr><th width="250">PIATTAFORMA</th><th>ARCHITETTURE</th><th>REQUISITI</th></tr></thead><tbody><tr><td><strong>Windows</strong></td><td>x64, arm64</td><td>Windows 10 o Windows 11. Microsoft Visual C++ 2015-2022 Redistributable e Microsoft Edge WebView2 Runtime (il programma di installazione li aggiunge se mancano).</td></tr><tr><td><strong>macOS</strong></td><td>Chip Apple (arm64), Intel (x64)</td><td>macOS 12 o versioni successive.</td></tr><tr><td><strong>Linux</strong></td><td>x64, arm64</td><td>glibc 2.27 o versioni successive, per esempio Ubuntu 18.04+, Debian 10+, RHEL 8+ o Fedora 28+.</td></tr></tbody></table>

Non serve un runtime .NET separato. UniGetUI ha anche bisogno di accesso a Internet per interrogare le origini, scaricare i pacchetti e controllare i propri aggiornamenti, e funziona solo con i gestori di pacchetti presenti sul computer (veda [Gestori di pacchetti supportati](/unigetui/it/riferimento/package-managers.md)).

## Metodi di installazione

{% tabs %}
{% tab title="Windows" %}

<table><thead><tr><th width="250">METODO</th><th>COME</th></tr></thead><tbody><tr><td><strong>Microsoft Store</strong> (consigliato)</td><td>Apra la <a href="https://apps.microsoft.com/detail/xpfftq032ptphf">pagina Store di UniGetUI</a> e faccia clic su <em><strong>Get</strong></em>.</td></tr><tr><td><strong>Programma di installazione</strong></td><td>Scarichi <code>UniGetUI.Installer.x64.exe</code> o <code>UniGetUI.Installer.arm64.exe</code> da <a href="https://devolutions.net/unigetui/">devolutions.net/unigetui</a> o dalla <a href="https://github.com/Devolutions/UniGetUI/releases/latest">versione più recente</a>, poi lo esegua. <code>UniGetUI.Installer.exe</code> è un alias del programma di installazione x64.</td></tr><tr><td><strong>WinGet</strong></td><td><code>winget install --exact --id Devolutions.UniGetUI --source winget</code></td></tr><tr><td><strong>Scoop</strong></td><td><code>scoop bucket add extras</code> then <code>scoop install extras/unigetui</code></td></tr><tr><td><strong>Chocolatey</strong></td><td><code>choco install unigetui</code></td></tr><tr><td><strong>Portatile (.zip)</strong></td><td><code>UniGetUI.x64.zip</code> o <code>UniGetUI.arm64.zip</code>. Veda <a href="#portable-mode">Modalità portatile</a>.</td></tr></tbody></table>

Il programma di installazione chiede se installare solo per l'utente corrente o per tutti gli utenti, poi offre ***Perform a regular installation*** o ***Perform a portable installation***, e i collegamenti ***Create a shortcut on the Start menu*** e ***Create a shortcut on the Desktop***.

<table><thead><tr><th width="250">MODALITÀ DI INSTALLAZIONE</th><th>CARTELLA PREDEFINITA</th></tr></thead><tbody><tr><td>Utente corrente (predefinito)</td><td><code>%LOCALAPPDATA%\Programs\UniGetUI</code></td></tr><tr><td>Tutti gli utenti (richiede diritti di amministratore)</td><td><code>C:\Program Files\UniGetUI</code></td></tr></tbody></table>
{% endtab %}

{% tab title="macOS" %}
Scarichi dalla [versione più recente](https://github.com/Devolutions/UniGetUI/releases/latest):

<table><thead><tr><th width="250">MAC</th><th>FILE</th></tr></thead><tbody><tr><td>Chip Apple (arm64)</td><td><code>UniGetUI.macos-arm64.dmg</code> or <code>UniGetUI.macos-arm64.tar.gz</code></td></tr><tr><td>Intel (x64)</td><td><code>UniGetUI.macos-x64.dmg</code> or <code>UniGetUI.macos-x64.tar.gz</code></td></tr></tbody></table>

1. Apra il file `.dmg`.
2. Trascini ***UniGetUI*** su ***Applications***.
3. Apra UniGetUI da ***Applications***.

L'archivio `.tar.gz` contiene il bundle dell'app e funziona senza un programma di installazione.
{% endtab %}

{% tab title="Linux" %}
Scarichi il file `.deb`, `.rpm` o `.tar.gz` dalla [versione più recente](https://github.com/Devolutions/UniGetUI/releases/latest). Sostituisca `x64` con `arm64` per i computer arm64.

```bash
# Debian, Ubuntu and derivatives
sudo apt install ./UniGetUI.linux-x64.deb

# Fedora, RHEL and derivatives
sudo dnf install ./UniGetUI.linux-x64.rpm

# Any distribution, from the archive
tar -xzf UniGetUI.linux-x64.tar.gz
./UniGetUI
```

I pacchetti `.deb` e `.rpm` installano UniGetUI in `/opt/unigetui` e aggiungono un avvio `unigetui`.
{% endtab %}
{% endtabs %}

## Installazione invisibile all'utente (Windows)

Per una distribuzione tramite script o su larga scala, esegua il programma di installazione da una sessione di PowerShell con privilegi elevati:

```powershell
.\UniGetUI.Installer.x64.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /ALLUSERS /NoAutoStart
```

Aggiunga `/LOG="C:\Windows\Temp\UniGetUI_install.log"` per conservare un registro. Per una procedura completa di distribuzione, veda [Distribuire UniGetUI in modo invisibile](/unigetui/it/per-i-team-it/organization/deploy.md).

### Opzioni del programma di installazione

Il programma di installazione è creato con Inno Setup, quindi si applicano le [opzioni di Inno Setup](https://jrsoftware.org/ishelp/index.php?topic=setupcmdline) standard.

<table><thead><tr><th width="250">OPZIONE</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>/SILENT</code></td><td>Installa senza le pagine della procedura guidata; viene mostrata una finestra di avanzamento.</td></tr><tr><td><code>/VERYSILENT</code></td><td>Installa senza le pagine della procedura guidata né la finestra di avanzamento.</td></tr><tr><td><code>/SUPPRESSMSGBOXES</code></td><td>Elimina le finestre di messaggio. Solo con <code>/SILENT</code> o <code>/VERYSILENT</code>.</td></tr><tr><td><code>/NORESTART</code></td><td>Impedisce al programma di installazione di riavviare il computer.</td></tr><tr><td><code>/ALLUSERS</code></td><td>Installa per tutti gli utenti. Richiede diritti di amministratore.</td></tr><tr><td><code>/CURRENTUSER</code></td><td>Installa solo per l'utente corrente (predefinito).</td></tr><tr><td><code>/DIR="path"</code></td><td>Installa in una cartella personalizzata.</td></tr><tr><td><code>/TASKS="list"</code></td><td>Seleziona solo le attività elencate (vedere sotto); le altre vengono annullate.</td></tr><tr><td><code>/MERGETASKS="list"</code></td><td>Seleziona o annulla attività mantenendo i valori predefiniti. Prefissi un'attività con <code>!</code> per annullarla.</td></tr><tr><td><code>/LOG="path"</code></td><td>Scrive un registro di installazione.</td></tr></tbody></table>

UniGetUI aggiunge opzioni proprie:

<table><thead><tr><th width="250">OPZIONE</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>/NoAutoStart</code></td><td>Non avvia UniGetUI al termine dell'installazione.</td></tr><tr><td><code>/NoRunOnStartup</code></td><td>Registra la voce di avvio come disattivata, così UniGetUI non si avvia all'accesso.</td></tr><tr><td><code>/NoDesktopShortcut</code></td><td>Non crea il collegamento sul desktop.</td></tr><tr><td><code>/NoVCRedist</code></td><td>Non installa Microsoft Visual C++ Redistributable.</td></tr><tr><td><code>/NoEdgeWebView</code></td><td>Non installa Microsoft Edge WebView2 Runtime.</td></tr><tr><td><code>/NoDeployInstaller</code></td><td>Non conserva una copia del programma di installazione (<code>UniGetUI.Installer.exe</code>) nella cartella di installazione. Quella copia serve a riparare l'installazione.</td></tr><tr><td><code>/MSStore</code></td><td>Modalità Microsoft Store: salta i programmi di installazione di Visual C++ e WebView2, non avvia UniGetUI dopo l'installazione né all'accesso. Combini con <code>/CURRENTUSER</code> per un'installazione per utente.</td></tr><tr><td><code>/NoWinGet</code></td><td>Serve a saltare l'installazione di WinGet e del modulo Microsoft.WinGet.Client quando mancano. I programmi di installazione attuali saltano già questo passaggio, quindi l'opzione non ha alcun effetto visibile.</td></tr><tr><td><code>/NoChocolatey</code>, <code>/EnableSystemChocolatey</code></td><td>Deprecato. Accettato per compatibilità, senza effetto.</td></tr></tbody></table>

{% hint style="warning" %}
Con `/NoVCRedist` o `/NoEdgeWebView`, si assicuri che Visual C++ 2015-2022 Redistributable e WebView2 Runtime siano già sui computer di destinazione.
{% endhint %}

### Attività del programma di installazione

Da usare con `/TASKS` o `/MERGETASKS`.

<table><thead><tr><th width="250">ATTIVITÀ</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>regularinstall</code></td><td><em><strong>Perform a regular installation</strong></em>. Predefinito.</td></tr><tr><td><code>regularinstall\startmenuicon</code></td><td><em><strong>Create a shortcut on the Start menu</strong></em>. Predefinito.</td></tr><tr><td><code>regularinstall\desktopicon</code></td><td><em><strong>Create a shortcut on the Desktop</strong></em>. Predefinito.</td></tr><tr><td><code>portableinstall</code></td><td><em><strong>Perform a portable installation</strong></em>. Non può essere combinato con <code>regularinstall</code>.</td></tr></tbody></table>

Esempio, tutti gli utenti senza collegamento sul desktop:

```powershell
.\UniGetUI.Installer.x64.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /ALLUSERS /MERGETASKS="!regularinstall\desktopicon"
```

### Che cosa registra un'installazione normale

* Una voce di avvio, così UniGetUI si avvia ridotto a icona nell'area di notifica all'accesso (salvo `/NoRunOnStartup`).
* Il protocollo `unigetui://`, usato dalle azioni di notifica e dai [collegamenti diretti](/unigetui/it/riferimento/cli.md#deep-links).
* L'associazione di file `.ubundle` per le raccolte di pacchetti.
* Una voce di disinstallazione denominata ***UniGetUI*** nelle app installate.

{% hint style="info" %}
Le serve un MSI, per esempio per i Criteri di gruppo? Il [repository GitHub](https://github.com/Devolutions/UniGetUI) include file di progetto per creare un wrapper MSI intorno al programma di installazione, in `InstallerExtras/MsiCreator`. Il wrapper MSI non installa le dipendenze.
{% endhint %}

## Modalità portatile

In modalità portatile, UniGetUI conserva impostazioni, cache e backup in una cartella `Settings` accanto all'eseguibile, così può portarlo su un'unità rimovibile o copiarlo tra computer.

La modalità portatile si attiva con un file marcatore denominato `ForceUniGetUIPortable` (senza estensione) accanto all'eseguibile di UniGetUI. Conta solo la sua presenza.

{% tabs %}
{% tab title="Windows" %}

* **Zip:** estragga `UniGetUI.x64.zip` o `UniGetUI.arm64.zip` in una cartella in cui l'account può scrivere, poi esegua `UniGetUI.exe`. Lo zip contiene già il file marcatore.
* **Programma di installazione:** scelga ***Perform a portable installation*** e una cartella scrivibile. In modo invisibile all'utente:

```powershell
.\UniGetUI.Installer.x64.exe /VERYSILENT /TASKS="portableinstall" /DIR="E:\UniGetUI"
```

{% endtab %}

{% tab title="macOS" %}

1. Estragga l'archivio `.tar.gz`.
2. Crei il file marcatore accanto all'eseguibile di UniGetUI (dentro il bundle `.app`): `touch /path/to/unigetui/ForceUniGetUIPortable`
3. Avvii UniGetUI.

Il file marcatore viene rimosso quando un aggiornamento sostituisce il bundle. Lo ricrei dopo ogni aggiornamento.
{% endtab %}

{% tab title="Linux" %}

1. Estragga l'archivio `.tar.gz`.
2. Crei il file marcatore accanto all'eseguibile: `touch /path/to/unigetui/ForceUniGetUIPortable`
3. Avvii UniGetUI.
   {% endtab %}
   {% endtabs %}

{% hint style="warning" %}
La cartella deve essere scrivibile dall'account che esegue UniGetUI. Se non lo è (per esempio in `C:\Program Files` o su un'unità di sola lettura), UniGetUI torna in silenzio alla cartella normale dell'utente per quella sessione e registra il motivo in ***Log di UniGetUI*** (menu ***Altro*** della barra laterale).
{% endhint %}

La prima volta che si apre una nuova copia portatile, se un'installazione normale sul computer ha delle impostazioni, UniGetUI offre ***Importare le impostazioni precedenti?***. Faccia clic su ***Importa***, poi su ***Riavvia***. Non viene sovrascritto né rimosso nulla, e l'offerta non si ripete.

In Windows, un'installazione portatile non registra il protocollo `unigetui://`, l'associazione `.ubundle`, una voce di avvio, collegamenti né una voce di disinstallazione. Quando si aggiorna, resta portatile nella stessa cartella. Per disattivare la modalità portatile, copi i dati da conservare da `Settings`, elimini `ForceUniGetUIPortable` e riavvii UniGetUI.

### Dove UniGetUI archivia i dati

<table><thead><tr><th width="250">DATI</th><th>INSTALLAZIONE NORMALE</th><th>PORTATILE</th></tr></thead><tbody><tr><td>Impostazioni, opzioni dei pacchetti, cache</td><td>Windows: <code>%LOCALAPPDATA%\UniGetUI</code><br>macOS: <code>~/Library/Application Support/UniGetUI</code><br>Linux: <code>$XDG_DATA_HOME/UniGetUI</code> o <code>~/.local/share/UniGetUI</code></td><td><code>&#x3C;install folder>\Settings</code></td></tr><tr><td>Registro di sessione, file temporanei</td><td>Windows: <code>%TEMP%\UniGetUI</code><br>macOS, Linux: <code>$TMPDIR/UniGetUI</code></td><td><code>&#x3C;install folder>\Settings\Temp</code></td></tr><tr><td>Cartella predefinita del backup locale</td><td><code>Documents\UniGetUI</code></td><td><code>&#x3C;install folder>\Settings\Backups</code></td></tr><tr><td>Token di backup di GitHub</td><td>Windows: Credential Manager<br>macOS, Linux: <code>SecureStorage</code> nella cartella dei dati</td><td>Windows: Credential Manager (non spostato)<br>macOS, Linux: <code>Settings/SecureStorage</code></td></tr><tr><td>Impostazioni protette dall'amministratore (Windows)</td><td><code>%ProgramFiles%\UniGetUI\SecureSettings</code></td><td>Uguale (non spostato)</td></tr></tbody></table>

{% hint style="danger" %}
Su macOS e Linux, una cartella portatile archivia il token di backup di GitHub come file in chiaro. Protegga quella cartella come il token stesso.
{% endhint %}

La modalità portatile non sposta i dati propri dei gestori di pacchetti, e i pacchetti si installano ancora nelle posizioni abituali.

## Aggiornare UniGetUI

UniGetUI si aggiorna da solo per impostazione predefinita. Quando una nuova versione è pronta, mostra ***UniGetUI {version} is ready to be installed.*** L'aggiornamento viene eseguito quando chiude UniGetUI, oppure subito con ***Aggiorna adesso***. Prima di installare, UniGetUI controlla l'hash del file e, in Windows, la firma Devolutions; se un controllo non riesce, l'aggiornamento viene annullato.

* **Controllare ora:** nella barra laterale, faccia clic su ***Altro*** – ***Verifica aggiornamenti di UniGetUI***. Aggiornato: ***Ottimo! Sei all'ultima versione.***
* **Impostazioni:** ***Impostazioni*** – ***Preferenze generali*** – ***Programma di aggiornamento di UniGetUI*** (veda [Tutte le impostazioni](/unigetui/it/riferimento/settings.md#unigetui-updater)).

<table><thead><tr><th width="250">PIATTAFORMA</th><th>COME VIENE APPLICATO L'AGGIORNAMENTO</th></tr></thead><tbody><tr><td>Windows</td><td>Esegue il nuovo programma di installazione in modo invisibile all'utente e conserva la modalità di installazione: utente corrente, tutti gli utenti o portatile.</td></tr><tr><td>macOS</td><td>Sostituisce il bundle dell'app. In modalità portatile, ricrei <code>ForceUniGetUIPortable</code> subito dopo.</td></tr><tr><td>Linux</td><td>Sostituisce i file della cartella da cui viene eseguito UniGetUI.</td></tr></tbody></table>

Se vede ***L'aggiornamento automatico non è ancora disponibile su questa piattaforma.***, non è ancora pubblicato un pacchetto di aggiornamento per la piattaforma o l'architettura: installi la nuova versione manualmente dalle [versioni GitHub](https://github.com/Devolutions/UniGetUI/releases/latest). Se un aggiornamento non riesce, ***Visualizza log*** apre il registro del programma di aggiornamento.

Può anche aggiornare UniGetUI come qualsiasi altro pacchetto, con lo strumento con cui lo ha installato:

```powershell
winget upgrade --exact --id Devolutions.UniGetUI --source winget
scoop update unigetui
choco upgrade unigetui
```

## Disinstallare UniGetUI

Disinstallare UniGetUI rimuove l'applicazione, non il software installato con essa. Quelle app restano e si possono ancora gestire con il loro gestore di pacchetti.

{% tabs %}
{% tab title="Windows" %}

1. Chiuda UniGetUI: ***Altro*** – ***Esci da UniGetUI***.
2. Apra ***Impostazioni*** – ***Apps*** – ***Installed apps***.
3. Trovi ***UniGetUI***, faccia clic su ***...*** – ***Disinstalla*** e confermi.

Oppure con lo strumento che ha usato: `winget uninstall --exact --id Devolutions.UniGetUI`, `scoop uninstall unigetui`, `choco uninstall unigetui`.

**In modo invisibile all'utente**, con il programma di disinstallazione nella cartella di installazione (sessione con privilegi elevati per le installazioni di tutti gli utenti):

```powershell
# All users
& "C:\Program Files\UniGetUI\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART
# Current user
& "$env:LOCALAPPDATA\Programs\UniGetUI\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART
```

Il programma di disinstallazione chiude UniGetUI e rimuove la voce di avvio, il protocollo `unigetui://` e l'associazione `.ubundle`.

**Portatile:** chiuda UniGetUI ed elimini la sua cartella.
{% endtab %}

{% tab title="macOS" %}

1. Chiuda UniGetUI.
2. Nel Finder, apra ***Applications*** e sposti ***UniGetUI*** nel Cestino.
   {% endtab %}

{% tab title="Linux" %}

1. Chiuda UniGetUI.
2. Rimuova il pacchetto: `sudo apt remove unigetui` o `sudo dnf remove unigetui`. Se ha usato l'archivio, elimini la sua cartella.
   {% endtab %}
   {% endtabs %}

### Rimuovere i dati residui

La disinstallazione conserva le impostazioni, così tornano se reinstalla. Per rimuovere tutto, elimini gli elementi di [Dove UniGetUI archivia i dati](#where-unigetui-stores-its-data) e, in Windows, i dati Pinget inclusi in `%LOCALAPPDATA%\Devolutions\Pinget`.

{% hint style="warning" %}
Questo elimina in modo permanente le impostazioni di UniGetUI, le opzioni di installazione per pacchetto e i backup locali. Copi prima ogni backup che vuole conservare.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/unigetui/it/riferimento/installation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.