> 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/reference/settings.md).

# All settings

Every UniGetUI setting in one place, grouped by settings page, with what it does and the platforms where it's available.

This page lists every setting in ***Settings***, grouped by settings page in the order they appear in the app. To jump to a setting in UniGetUI, type part of its name in the ***Search settings*** box of the title bar.

* **Platform**: ***All*** means Windows, macOS and Linux. A setting that's not available on your platform is hidden.
* **Restart required**: some settings only apply after a restart. UniGetUI then shows ***Restart UniGetUI to fully apply changes*** with a ***Restart UniGetUI*** button.
* Toggles that say "Do not…" or "Disable…" in their name work as written: turning them on turns the feature off.

{% hint style="info" %}
You can also read and change most settings from a script with the [command-line interface](/unigetui/reference/cli.md#settings): `unigetui settings list` shows the internal keys.
{% endhint %}

## General preferences

Language, UniGetUI updates, telemetry, privacy, and import, export or reset of the settings.

### Language

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>UniGetUI display language:</strong></em></td><td>Language of the interface. <em><strong>System language</strong></em> follows the operating system. The completion percentage of each translation is shown beside its name. Restart required.</td><td>All</td></tr></tbody></table>

### UniGetUI updater

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Update UniGetUI automatically</strong></em></td><td>Downloads and installs new versions of UniGetUI. <em><strong>Check for updates</strong></em> looks for a new version right away. See <a href="/unigetui/reference/installation.md#update-unigetui">Update UniGetUI</a>.</td><td>All</td></tr><tr><td><em><strong>Install prerelease versions of UniGetUI</strong></em></td><td>Includes beta and other prerelease versions when UniGetUI updates itself.</td><td>All</td></tr><tr><td><em><strong>Show the release notes after UniGetUI is updated</strong></em></td><td>Shows the release notes the first time UniGetUI starts after an update.</td><td>All</td></tr></tbody></table>

### Telemetry

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Manage telemetry settings</strong></em></td><td><em><strong>Manage</strong></em> opens the choice to share anonymous usage data or not.</td><td>All</td></tr></tbody></table>

### Privacy

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Hide my username from the logs</strong></em></td><td>Replaces your username with <code>****</code> in the logs. Restart UniGetUI to also hide it from entries already recorded.</td><td>All</td></tr></tbody></table>

### Manage UniGetUI settings

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Import settings from a local file</strong></em></td><td><em><strong>Import</strong></em> loads a settings JSON file exported earlier. Restart required.</td><td>All</td></tr><tr><td><em><strong>Export settings to a local file</strong></em></td><td><em><strong>Export</strong></em> saves the current settings to a JSON file, for example to copy them to another computer.</td><td>All</td></tr><tr><td><em><strong>Reset UniGetUI</strong></em></td><td>Restores every setting to its default value, after confirmation. Restart required.</td><td>All</td></tr></tbody></table>

{% hint style="info" %}
The restrictions on the ***Administrator rights and other dangerous settings*** page are stored separately and aren't included in an exported settings file.
{% endhint %}

## User interface preferences

Theme, startup page, navigation menu, system tray and what package lists show.

### Appearance

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Application theme:</strong></em></td><td><em><strong>Light</strong></em>, <em><strong>Dark</strong></em> or <em><strong>Follow system color scheme</strong></em>.</td><td>All</td></tr><tr><td><em><strong>Use the font configured in Windows instead of the default interface font</strong></em></td><td>Displays the interface with the Windows system font. Restart required.</td><td>Windows</td></tr><tr><td><em><strong>UniGetUI startup page:</strong></em></td><td>Page shown when UniGetUI opens: <em><strong>Default</strong></em>, <em><strong>Discover Packages</strong></em>, <em><strong>Software Updates</strong></em>, <em><strong>Installed Packages</strong></em>, <em><strong>Package Bundles</strong></em> or <em><strong>Settings</strong></em>.</td><td>All</td></tr><tr><td><em><strong>Navigation menu:</strong></em></td><td>How the left menu is displayed: <em><strong>Automatic</strong></em>, <em><strong>Docked open</strong></em> or <em><strong>Sliding overlay</strong></em>.</td><td>All</td></tr></tbody></table>

### Rendering

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Automatically switch to software rendering when Windows has no hardware GPU</strong></em></td><td>Uses software rendering on computers without a graphics card, such as some virtual machines. Restart required.</td><td>Windows</td></tr></tbody></table>

### UniGetUI on the background and system tray

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Close UniGetUI to the system tray</strong></em></td><td>Keeps UniGetUI running in the notification area when you close the window. Notifications and scheduled tasks need UniGetUI to keep running.</td><td>All</td></tr><tr><td><em><strong>Manage UniGetUI autostart behaviour</strong></em></td><td><em><strong>Open</strong></em> opens the Windows startup apps settings, where you choose whether UniGetUI starts with Windows.</td><td>Windows</td></tr></tbody></table>

### Package lists

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Show package icons on package lists</strong></em></td><td>Shows the icon of each package.</td><td>All</td></tr><tr><td><em><strong>Show illustrations on package lists</strong></em></td><td>Shows illustrations on the package pages. Restart required.</td><td>All</td></tr><tr><td><em><strong>Show the installer host on package lists</strong></em></td><td>Adds an <em><strong>Installer host</strong></em> column with the host name of the installer download URL. Restart required.</td><td>All</td></tr><tr><td><em><strong>Show the download size on package lists</strong></em></td><td>Adds a <em><strong>Download size</strong></em> column. Restart required.</td><td>All</td></tr><tr><td><em><strong>The local icon cache currently takes … MB</strong></em></td><td>Size of the cached package icons. <em><strong>Clear cache</strong></em> deletes them; they're downloaded again when needed.</td><td>All</td></tr><tr><td><em><strong>Select upgradable packages by default</strong></em></td><td>Selects every package on <em><strong>Software Updates</strong></em> when the list loads.</td><td>All</td></tr></tbody></table>

## Notification preferences

Which notifications UniGetUI shows.

{% hint style="warning" %}
Notifications need the system tray icon. If ***Close UniGetUI to the system tray*** is off, the page shows ***The system tray icon must be enabled in order for notifications to work*** and ***Enable UniGetUI notifications*** is locked.
{% endhint %}

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Enable UniGetUI notifications</strong></em></td><td>Turns all UniGetUI system notifications on or off.</td><td>All</td></tr><tr><td><em><strong>Show an in-app summary toast when a batch of operations finishes</strong></em></td><td>Shows a summary inside the UniGetUI window when a group of operations is done.</td><td>All</td></tr></tbody></table>

### Notification types

Unavailable while ***Enable UniGetUI notifications*** is off.

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Show a notification when there are available updates</strong></em></td><td>Notifies you when new versions of installed packages are found.</td><td>Windows, macOS</td></tr><tr><td><em><strong>Show a silent notification when an operation is running</strong></em></td><td>Shows a notification without sound while an operation is in progress.</td><td>Windows, macOS</td></tr><tr><td><em><strong>Show a notification when an operation fails</strong></em></td><td>Notifies you when an install, update or uninstall fails.</td><td>Windows, macOS</td></tr><tr><td><em><strong>Show a notification when an operation finishes successfully</strong></em></td><td>Notifies you when an operation completes.</td><td>Windows, macOS</td></tr></tbody></table>

To silence update notifications for one package manager only, see ***Ignore packages from {package manager} when showing a notification about updates*** under [Package manager preferences](#package-manager-preferences).

## Administrator rights and other dangerous settings

Elevation behavior, the Devolutions Agent broker, and security restrictions. The page opens with a warning: most of these settings are off by default because they can weaken the security of the computer.

{% hint style="danger" %}
Change these settings only if you understand the consequences. To enforce them on managed computers, see [Lock down risky settings](/unigetui/for-it-teams/organization/restrict-settings.md).
{% endhint %}

### Change how operations request administrator rights

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Ask for administrator privileges once for each batch of operations</strong></em></td><td>Asks for elevation once for a group of operations started together, instead of once per operation.</td><td>Windows</td></tr><tr><td><em><strong>Ask only once for administrator privileges</strong></em></td><td>Asks for elevation once and reuses it for the following operations.</td><td>Windows</td></tr><tr><td><em><strong>Prohibit any kind of Elevation via UniGetUI Elevator or GSudo</strong></em></td><td>Never elevates. Any operation that can't elevate itself fails, and installing, updating or uninstalling as administrator doesn't work. The two options above are locked while this is on.</td><td>Windows</td></tr><tr><td><em><strong>Delegate package operations to the Devolutions Agent broker</strong></em></td><td>Sends install, update and uninstall operations of supported package managers to the Devolutions Agent service instead of showing a UAC prompt. Operations fail unless the agent is installed and running. See <a href="/unigetui/for-it-teams/organization/devolutions-agent.md">Let users install approved apps without admin rights</a>.</td><td>Windows</td></tr><tr><td><em><strong>Inspect active package broker policy</strong></em></td><td>Opens the <em><strong>Active package broker policy</strong></em> page, which checks whether Devolutions Agent is reachable and shows the policy enforced for package operations. From there, <em><strong>Edit the active policy</strong></em>, <em><strong>Create a new policy</strong></em> or <em><strong>Replace the active policy identity</strong></em>, when allowed.</td><td>Windows</td></tr></tbody></table>

{% hint style="warning" %}
With the Devolutions Agent broker there's no fallback to UAC: if the agent is unavailable or its policy denies the request, the operation fails.
{% endhint %}

### Restrictions on package operations

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Allow custom command-line arguments</strong></em></td><td>Lets you add custom install, update and uninstall arguments in a package's installation options. Custom arguments change how programs are installed in ways UniGetUI can't control, and can break packages.</td><td>All</td></tr><tr><td><em><strong>Ignore custom pre-install and post-install commands when importing packages from a bundle</strong></em></td><td>Despite its name, this toggle <strong>allows</strong> custom pre-operation and post-operation commands. When it's on, the commands set in a package's installation options run before and after the package is installed, updated or uninstalled. When it's off, they're discarded.</td><td>All</td></tr></tbody></table>

### Restrictions on package managers

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Allow changing the paths for package manager executables</strong></em></td><td>Lets you pick a different executable for each package manager in <a href="#package-manager-preferences">Package manager preferences</a>. Restart required.</td><td>All</td></tr></tbody></table>

### Restrictions when importing package bundles

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Allow importing custom command-line arguments when importing packages from a bundle</strong></em></td><td>Keeps the custom arguments stored in a bundle when you open it. Malformed arguments can break packages or let a malicious actor gain privileged execution. Only available when <em><strong>Allow custom command-line arguments</strong></em> is on.</td><td>All</td></tr><tr><td><em><strong>Allow importing custom pre-install and post-install commands when importing packages from a bundle</strong></em></td><td>Keeps the pre-install and post-install commands stored in a bundle when you open it. Only import commands from bundles you trust. Only available when pre-install and post-install commands are allowed (see the toggle above).</td><td>All</td></tr></tbody></table>

## Package operation preferences

How install, update and uninstall operations run.

### Concurrency and execution

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Choose how many operations should be performed in parallel</strong></em></td><td>Maximum number of operations that run at the same time, from 1 to 100.</td><td>All</td></tr><tr><td><em><strong>Clear successful operations from the operation list after a 5 second delay</strong></em></td><td>Removes successful operations from the operations panel automatically. Download operations aren't affected.</td><td>All</td></tr><tr><td><em><strong>Try to kill the processes that refuse to close when requested to</strong></em></td><td>Forces apps to close when an installer asks them to and they don't respond. You may lose unsaved data.</td><td>All</td></tr></tbody></table>

### Installer downloads

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Default location for downloaded installers</strong></em></td><td><em><strong>Select</strong></em> picks the folder where installers are saved. <em><strong>Reset</strong></em> removes the custom folder and <em><strong>Open</strong></em> opens it.</td><td>All</td></tr><tr><td><em><strong>Name of the downloaded installer files</strong></em></td><td><em><strong>Name given by the publisher</strong></em>, <em><strong>Package name and version</strong></em>, <em><strong>Package identifier and version</strong></em>, or <em><strong>Name given by the publisher, followed by the version</strong></em>. Adding the version keeps a new download from overwriting an older installer.</td><td>All</td></tr></tbody></table>

### Environment variables in custom install options

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Use %VARIABLE% syntax for environment variables in custom install arguments and locations</strong></em></td><td>By default, UniGetUI expands variables written as <code>&#x3C;VARIABLE></code> in custom arguments and install locations. Turn this on to use the Windows <code>%VARIABLE%</code> syntax instead. Folder names that contain a variable name, such as <code>%TEMP%</code>, may then be expanded unexpectedly.</td><td>All</td></tr></tbody></table>

### Shortcut management

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Ask to delete desktop shortcuts created during an install or upgrade.</strong></em></td><td>After an operation creates new desktop shortcuts, asks whether to delete them. <em><strong>Manage shortcuts</strong></em> opens the list of known desktop shortcuts.</td><td>All</td></tr><tr><td><em><strong>Ask about the Start Menu shortcuts created during an install or upgrade.</strong></em></td><td>After an operation creates new Start Menu shortcuts, asks what to do with them. <em><strong>Manage Start Menu shortcuts</strong></em> opens the list of known Start Menu shortcuts.</td><td>Windows</td></tr></tbody></table>

## Package update preferences

Conditions for automatic updates and security checks on new versions. The ***Scheduled maintenance*** link at the top of the page opens the update schedules.

### Automatic update restrictions

These only apply to updates installed by the ***Install available updates*** task of [Scheduled maintenance](#scheduled-maintenance), and are locked while that task is off.

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Do not automatically install updates when the network connection is metered</strong></em></td><td>Postpones automatic updates on a metered connection, such as a mobile hotspot.</td><td>Windows</td></tr><tr><td><em><strong>Do not automatically install updates when the device runs on battery</strong></em></td><td>Postpones automatic updates while the device isn't plugged in.</td><td>Windows</td></tr><tr><td><em><strong>Do not automatically install updates when the battery saver is on</strong></em></td><td>Postpones automatic updates while the battery saver is on.</td><td>Windows</td></tr></tbody></table>

### Update security

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Minimum age for updates</strong></em></td><td>Only shows updates released at least this long ago: <em><strong>No minimum age</strong></em>, <em><strong>1 day</strong></em>, <em><strong>3 days</strong></em>, <em><strong>7 days</strong></em>, <em><strong>14 days</strong></em>, <em><strong>30 days</strong></em> or <em><strong>Custom...</strong></em>. Can be overridden per package manager.</td><td>All</td></tr><tr><td><em><strong>Custom minimum age (days)</strong></em></td><td>Number of days, when <em><strong>Custom...</strong></em> is selected.</td><td>All</td></tr><tr><td><em><strong>Warn me when the installer URL host changes between the installed version and the new version (WinGet only)</strong></em></td><td>On <em><strong>Software Updates</strong></em>, flags WinGet updates whose installer comes from a completely different host than the installed version. This can reveal a redirected or compromised download.</td><td>All</td></tr></tbody></table>

The minimum age relies on release dates. The ***Release date support per package manager*** table on the page shows which managers provide them (***Yes***, ***Partial*** or ***No***). For managers without release dates, it has no effect. See [Avoid brand-new releases](/unigetui/guides/updates/update-safely.md).

## Scheduled maintenance

When UniGetUI checks for updates, installs them, and backs up your app list on its own.

{% hint style="warning" %}
Tasks run while UniGetUI is running, including from the notification area.
{% endhint %}

### Maintenance tasks

Turn on a task's toggle to enable it and show its schedule. A collapsed task shows its current schedule beside its name.

<table><thead><tr><th width="250">TASK</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Check for package updates</strong></em></td><td>Looks for new versions of installed packages.</td><td>All</td></tr><tr><td><em><strong>Install available updates</strong></em></td><td>Updates upgradable packages, respecting the <a href="#automatic-update-restrictions">automatic update restrictions</a>.</td><td>All</td></tr><tr><td><em><strong>Local package backup</strong></em></td><td>Saves your app list to the local backup folder.</td><td>All</td></tr><tr><td><em><strong>Cloud package backup</strong></em></td><td>Saves your app list to your cloud backup.</td><td>All</td></tr></tbody></table>

### Schedule options

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Repeat</strong></em></td><td>How often the task runs. <em><strong>Check for package updates</strong></em>: <em><strong>On a fixed interval</strong></em>, <em><strong>Every day</strong></em> or <em><strong>On selected days</strong></em>. <em><strong>Install available updates</strong></em>: <em><strong>After every update check</strong></em>, <em><strong>Every day</strong></em> or <em><strong>On selected days</strong></em>. Backups: <em><strong>When UniGetUI starts</strong></em>, <em><strong>Every day</strong></em> or <em><strong>On selected days</strong></em>.</td><td>All</td></tr><tr><td><em><strong>Check every</strong></em></td><td>Interval between two update checks, with <em><strong>On a fixed interval</strong></em>.</td><td>All</td></tr><tr><td><em><strong>Days</strong></em></td><td>Days of the week, with <em><strong>On selected days</strong></em>.</td><td>All</td></tr><tr><td><em><strong>Start time</strong></em></td><td>Time of day the task runs.</td><td>All</td></tr><tr><td><em><strong>If the scheduled time is missed</strong></em></td><td>What to do if UniGetUI wasn't running at that time: <em><strong>Run within</strong></em> a delay, <em><strong>Run whenever UniGetUI next starts</strong></em>, or <em><strong>Skip until the next occurrence</strong></em>.</td><td>All</td></tr><tr><td><em><strong>Install</strong></em></td><td>For <em><strong>Install available updates</strong></em>: <em><strong>All available updates</strong></em> or <em><strong>Only packages marked for automatic updates</strong></em>.</td><td>All</td></tr><tr><td><em><strong>Manage the list</strong></em></td><td>Opens the list of packages marked for automatic updates, with their count. Only with <em><strong>Only packages marked for automatic updates</strong></em>. If none is marked, the page shows <em><strong>No packages are marked yet, so nothing will be installed</strong></em>.</td><td>All</td></tr><tr><td><em><strong>Run this task now</strong></em></td><td><em><strong>Run now</strong></em> runs the task immediately. The last and next run times are shown beside it, with the error of the last run if it failed.</td><td>All</td></tr></tbody></table>

See [Run updates on a schedule](/unigetui/guides/updates/schedule.md) and [Choose which apps update automatically](/unigetui/guides/updates/automatic-updates.md).

## Package backup

Saves the list of your installed packages so you can restore them later. A backup contains the package list and installation options, plus ignored updates and skipped versions. It doesn't contain any program files or app data.

### Cloud package backup

Cloud backups are stored in a private GitHub Gist on your account. ***Log in with GitHub*** connects your account; ***Log out from GitHub*** disconnects it.

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Periodically perform a cloud backup of the installed packages</strong></em></td><td>Backs up to the cloud on the <em><strong>Cloud package backup</strong></em> schedule of <a href="#scheduled-maintenance">Scheduled maintenance</a>.</td><td>All</td></tr><tr><td><em><strong>Perform a cloud backup now</strong></em></td><td><em><strong>Backup</strong></em> uploads a backup immediately.</td><td>All</td></tr><tr><td><em><strong>Restore a backup from the cloud</strong></em></td><td><em><strong>Select backup</strong></em> lets you pick a cloud backup and review which packages to restore.</td><td>All</td></tr></tbody></table>

### Local package backup

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Periodically perform a local backup of the installed packages</strong></em></td><td>Saves a backup file on the <em><strong>Local package backup</strong></em> schedule of <a href="#scheduled-maintenance">Scheduled maintenance</a>.</td><td>All</td></tr><tr><td><em><strong>Perform a local backup now</strong></em></td><td><em><strong>Backup</strong></em> saves a backup immediately.</td><td>All</td></tr><tr><td><em><strong>Change backup output directory</strong></em></td><td><em><strong>Select</strong></em> picks the folder for local backups. The current folder is shown below.</td><td>All</td></tr></tbody></table>

### Local backup advanced options

Only available when local backups are on.

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Set a custom backup file name</strong></em></td><td>Name of the backup file. Leave empty for the default name.</td><td>All</td></tr><tr><td><em><strong>Keep a separate file for each backup</strong></em></td><td>Adds the date and time to the file name, so each backup gets its own file.</td><td>All</td></tr><tr><td><em><strong>Maximum number of local backups to keep</strong></em></td><td>Deletes the oldest backups past this limit: <em><strong>Keep all backups</strong></em>, <em><strong>Keep the last 5 backups</strong></em>, <em><strong>Keep the last 10 backups</strong></em>, <em><strong>Keep the last 25 backups</strong></em>, <em><strong>Keep the last 50 backups</strong></em> or <em><strong>Custom...</strong></em>. Only with <em><strong>Keep a separate file for each backup</strong></em>.</td><td>All</td></tr><tr><td><em><strong>Custom maximum number of backups</strong></em></td><td>Number of backups to keep, when <em><strong>Custom...</strong></em> is selected.</td><td>All</td></tr></tbody></table>

See [Back up your app list automatically](/unigetui/guides/new-computer/backup.md).

## Package manager preferences

Also reachable from ***Package Managers*** in the left menu. The page lists the package managers supported on your platform (see [Supported package managers](/unigetui/reference/package-managers.md)), each with a toggle and a status: ***Ready***, ***Disabled***, ***Failed*** (found but couldn't start; check the UniGetUI log) or ***Not found***. Click a manager to open its settings.

### Status and executable

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Enable {package manager}</strong></em></td><td>Turns the package manager on or off.</td><td>All</td></tr><tr><td><em><strong>{package manager} status</strong></em></td><td>Whether the manager is ready, disabled, failed to load or wasn't found. <em><strong>Expand version</strong></em> shows its version.</td><td>All</td></tr><tr><td><em><strong>Select the executable to be used. The following list shows the executables found by UniGetUI</strong></em></td><td>Executable used to run the manager. <em><strong>Browse...</strong></em> picks another file. Locked by default; <em><strong>Change this</strong></em> opens the administrator settings, where <em><strong>Allow changing the paths for package manager executables</strong></em> unlocks it.</td><td>All</td></tr><tr><td><em><strong>Current executable file:</strong></em></td><td>Path of the executable in use, with a copy button.</td><td>All</td></tr></tbody></table>

### Default installation options

The ***Default installation options for {package manager} packages*** section applies to every install, update and uninstall done with this manager. Options the manager doesn't support are locked. ***Apply*** saves; ***Reset*** restores the defaults.

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Run as admin</strong></em></td><td>Runs operations with administrator rights.</td><td>Windows</td></tr><tr><td><em><strong>Interactive installation</strong></em></td><td>Shows the installer so you can answer its prompts.</td><td>All</td></tr><tr><td><em><strong>Skip hash check</strong></em></td><td>Doesn't verify the installer hash.</td><td>All</td></tr><tr><td><em><strong>Allow pre-release versions</strong></em></td><td>Includes prerelease versions when installing and updating.</td><td>All</td></tr><tr><td><em><strong>Uninstall previous versions when updated</strong></em></td><td>Removes the previous version after an update.</td><td>All</td></tr><tr><td><em><strong>Architecture to install:</strong></em></td><td>Processor architecture to install, or <em><strong>Default</strong></em>.</td><td>All</td></tr><tr><td><em><strong>Installation scope:</strong></em></td><td><em><strong>Default</strong></em>, <em><strong>User | Local</strong></em> (current user) or <em><strong>Machine | Global</strong></em> (all users).</td><td>All</td></tr><tr><td><em><strong>Install location:</strong></em></td><td>Install folder. <em><strong>Select</strong></em> picks one; <em><strong>Reset</strong></em> goes back to the package default. <code>%PACKAGE%</code> is replaced with the package ID and <code>%NAME%</code> with the package name.</td><td>All</td></tr><tr><td><em><strong>Subfolder for each package:</strong></em></td><td>Creates a subfolder named after the <em><strong>Package ID</strong></em> or the <em><strong>Package name</strong></em> in the install location, or <em><strong>No subfolder</strong></em>.</td><td>All</td></tr><tr><td><em><strong>Custom install arguments:</strong></em>, <em><strong>Custom update arguments:</strong></em>, <em><strong>Custom uninstall arguments:</strong></em></td><td>Arguments added to each operation's command line. <em><strong>Copy install arguments to update and uninstall</strong></em> copies the first field to the other two. Only when <em><strong>Allow custom command-line arguments</strong></em> is on.</td><td>All</td></tr></tbody></table>

### Sources and advanced options

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Manage {package manager} sources</strong></em></td><td>Lists the manager's sources. <em><strong>Add source</strong></em> adds a known or custom source (<em><strong>Source name</strong></em>, <em><strong>Source URL</strong></em>); the delete button removes one; <em><strong>Reload sources</strong></em> refreshes the list. Only for managers that support sources.</td><td>All</td></tr><tr><td><em><strong>Ignore packages from {package manager} when showing a notification about updates</strong></em></td><td>Leaves this manager's packages out of update notifications.</td><td>All</td></tr><tr><td><em><strong>Minimum age for updates</strong></em></td><td>Overrides the global minimum update age for this manager, or <em><strong>Use global setting</strong></em>. Limited or no effect if the manager provides release dates for only some packages, or none.</td><td>All</td></tr><tr><td><em><strong>Custom minimum age (days)</strong></em></td><td>Number of days, when <em><strong>Custom...</strong></em> is selected.</td><td>All</td></tr><tr><td><em><strong>View {package manager} logs</strong></em></td><td>Opens the log of the commands run by this manager.</td><td>All</td></tr></tbody></table>

### Options specific to one package manager

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>WinGet command-line tool</strong></em></td><td><strong>WinGet.</strong> Tool used for WinGet operations when the COM API isn't used: <em><strong>Default</strong></em>, <em><strong>WinGet</strong></em> or <em><strong>Pinget</strong></em>.</td><td>Windows</td></tr><tr><td><em><strong>WinGet COM API</strong></em></td><td><strong>WinGet.</strong> Whether UniGetUI may use the WinGet COM API before falling back to the command-line tool: <em><strong>Default</strong></em>, <em><strong>Enabled</strong></em> or <em><strong>Disabled</strong></em>.</td><td>Windows</td></tr><tr><td><em><strong>Reset WinGet</strong></em></td><td><strong>WinGet.</strong> Resets WinGet. May help if no packages are listed.</td><td>Windows</td></tr><tr><td><em><strong>Force install location parameter when updating packages with custom locations</strong></em></td><td><strong>WinGet.</strong> Passes the custom install location again when updating a package installed in a custom location.</td><td>Windows</td></tr><tr><td><em><strong>Download full package manifest alongside the installer</strong></em></td><td><strong>WinGet.</strong> Saves the package manifest next to downloaded installers.</td><td>Windows</td></tr><tr><td><em><strong>Stop offering an update that never applies after this many attempts</strong></em></td><td><strong>WinGet.</strong> When an update reports success but never changes the installed version, stops offering it after this many attempts, until a newer version appears (default: 3).</td><td>Windows</td></tr><tr><td><em><strong>Install Scoop</strong></em> / <em><strong>Uninstall Scoop (and its packages)</strong></em></td><td><strong>Scoop.</strong> Installs Scoop, or removes Scoop and every package it installed.</td><td>Windows</td></tr><tr><td><em><strong>Run cleanup and clear cache</strong></em></td><td><strong>Scoop.</strong> Removes old versions and cached downloads now.</td><td>Windows</td></tr><tr><td><em><strong>Clear Scoop download cache on launch</strong></em></td><td><strong>Scoop.</strong> Clears the download cache each time UniGetUI starts.</td><td>Windows</td></tr><tr><td><em><strong>Clean up older Scoop app versions on launch</strong></em></td><td><strong>Scoop.</strong> Removes older app versions each time UniGetUI starts.</td><td>Windows</td></tr><tr><td><em><strong>Prefer latest versions (may include breaking changes) instead of recommended safe updates</strong></em></td><td><strong>Bun.</strong> Offers the latest versions rather than the recommended safe updates.</td><td>All</td></tr><tr><td><em><strong>Default vcpkg triplet</strong></em></td><td><strong>vcpkg.</strong> Triplet (target platform) used by default to install vcpkg packages.</td><td>All</td></tr><tr><td><em><strong>Change vcpkg root location</strong></em></td><td><strong>vcpkg.</strong> <em><strong>Select</strong></em> picks the vcpkg root folder; <em><strong>Reset</strong></em> restores the default; <em><strong>Open</strong></em> opens it.</td><td>All</td></tr></tbody></table>

{% hint style="info" %}
Pip on Windows: if Python isn't found, or lists no packages although it's installed, turn off the `python.exe` App Execution Alias in Windows settings.
{% endhint %}

## Internet connection settings

Proxy and connectivity.

### Proxy settings

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Connect the internet using a custom proxy</strong></em></td><td>Sends the traffic of UniGetUI and compatible package managers through a proxy.</td><td>All</td></tr><tr><td><em><strong>Proxy URL</strong></em></td><td>Address of the proxy server. Only when the proxy is on.</td><td>All</td></tr><tr><td><em><strong>Authenticate to the proxy with a user and a password</strong></em></td><td>Sends credentials to the proxy.</td><td>All</td></tr><tr><td><em><strong>Credentials</strong></em></td><td><em><strong>Username</strong></em> and <em><strong>Password</strong></em> for the proxy. Only when proxy authentication is on.</td><td>All</td></tr></tbody></table>

Not every package manager fully supports a proxy. The ***Proxy compatibility table*** on the page shows, per manager, ***Compatible with proxy*** and ***Compatible with authentication*** (***Yes***, ***Partially*** or ***No***).

{% hint style="danger" %}
UniGetUI doesn't guarantee that proxy credentials are stored safely. Use a dedicated account with limited rights.
{% endhint %}

### Other settings

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Wait for the device to be connected to the internet before attempting to do tasks that require internet connectivity.</strong></em></td><td>Delays tasks that need the internet, such as loading packages, until a connection is available. Restart required.</td><td>All</td></tr></tbody></table>

## Experimental settings and developer options

Options still in development or meant for troubleshooting. Change them only if you know why, for example when support asks you to.

<table><thead><tr><th width="250">SETTING</th><th>WHAT IT DOES</th><th>PLATFORM</th></tr></thead><tbody><tr><td><em><strong>Show UniGetUI's version and build number on the titlebar.</strong></em></td><td>Shows the exact version in the title bar. Restart required.</td><td>All</td></tr><tr><td><em><strong>Enable background api (UniGetUI Widgets and Sharing, port 7058)</strong></em></td><td>Runs the local API used by UniGetUI Widgets, package sharing and the <a href="/unigetui/reference/cli.md">command-line interface</a> in a desktop session.</td><td>All</td></tr><tr><td><em><strong>Wait for the device to be connected to the internet before attempting to do tasks that require internet connectivity.</strong></em></td><td>Same setting as in <a href="#other-settings">Internet connection settings</a>.</td><td>All</td></tr><tr><td><em><strong>Disable the 1-minute timeout for package-related operations</strong></em></td><td>Lets package listing tasks run longer than one minute, for example with slow managers or networks.</td><td>All</td></tr><tr><td><em><strong>Use installed GSudo instead of UniGetUI Elevator</strong></em></td><td>Elevates operations with a GSudo installed on the computer instead of the elevator included with UniGetUI.</td><td>Windows</td></tr><tr><td><em><strong>Use a custom icon and screenshot database URL</strong></em></td><td>Address of the database for package icons and screenshots. Leave empty for the default.</td><td>All</td></tr><tr><td><em><strong>Enable background CPU Usage optimizations (see Pull Request #3278)</strong></em></td><td>Reduces CPU usage while UniGetUI works in the background.</td><td>All</td></tr><tr><td><em><strong>Perform integrity checks at startup</strong></em></td><td>Verifies the integrity of the UniGetUI installation at each start.</td><td>All</td></tr><tr><td><em><strong>When batch installing packages from a bundle, install also packages that are already installed</strong></em></td><td>On <em><strong>Package Bundles</strong></em>, includes already-installed packages when you install the selection. By default they're skipped.</td><td>All</td></tr></tbody></table>


---

# 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/reference/settings.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.