> 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/guides/new-computer/restore.md).

# Set up a new computer

Reinstall all your apps on a new or reset computer from a bundle, a local backup or a GitHub backup.

Got a new computer? Install UniGetUI, open your bundle or backup, and reinstall all your apps in one batch. You choose what to bring back, so it's also a good moment to leave behind the apps you never use.

## Before you start

* Install UniGetUI on the new computer. See [Quick start](/unigetui/quick-start.md).
* Make sure the package managers your apps come from are enabled in ***Settings*** – ***Package manager preferences***. An app from Scoop, for example, can't install if Scoop isn't there. See [Supported package managers](/unigetui/reference/package-managers.md).

{% stepper %}
{% step %}

### Open your list of apps

{% tabs %}
{% tab title="Bundle or local backup" %}

1. Copy the `.ubundle` file to the new computer.
2. Open ***Package Bundles***.
3. Click ***Open*** and select the file.

UniGetUI also opens `.json`, `.yaml` and `.xml` bundles.
{% endtab %}

{% tab title="GitHub backup" %}

1. Go to ***Settings*** – ***Package backup***.
2. Click ***Log in with GitHub*** and sign in with the same account as on your old computer.
3. Click ***Select backup*** beside ***Restore a backup from the cloud***.
4. Choose the backup of your old computer. Backups are named after the computer and user that created them.
5. Click ***Select backup***.

The backup opens in ***Package Bundles***.
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### Review the bundle security report

If the bundle contains custom installer arguments or pre-install and post-install commands, UniGetUI doesn't import them and shows a ***Bundle security report*** listing what it left out. Read it, then click ***OK***.

The apps still install, just without those extras. That's usually what you want.

{% hint style="danger" %}
Those commands run on your computer with the installer's rights. Only allow them if you created the bundle yourself or fully trust who did. The settings are in ***Settings*** – ***Administrator rights and other dangerous settings***, under ***Restrictions when importing package bundles***. Reopen the bundle after changing them.
{% endhint %}
{% endstep %}

{% step %}

### Choose the apps and install

1. Select the check box of each app to install, or ***Select all***.
2. Click ***Install selection***.

UniGetUI queues the installations and runs them one after another. Apps that are already installed are skipped. Grab a coffee: a full computer can take a while.

{% hint style="info" %}
On Windows, to avoid an administrator prompt for every app, turn on ***Ask for administrator privileges once for each batch of operations*** in ***Settings*** – ***Administrator rights and other dangerous settings*** before you start.
{% endhint %}
{% endstep %}
{% endstepper %}

## If it doesn't work

* **Some apps fail to install.** Check that their package manager is enabled, then read the operation output. See [An update or installation fails](/unigetui/help/troubleshooting/update-or-install-fails.md).
* **The file won't open.** UniGetUI says the bundle isn't valid when the file is damaged or isn't a bundle. Export it again from the old computer.
* **Your GitHub backup isn't listed.** Make sure you're logged in with the same GitHub account, and that cloud backup ran at least once on the old computer.
* **You want to reinstall apps that are already there.** Turn on ***When batch installing packages from a bundle, install also packages that are already installed*** in ***Settings*** – ***Experimental settings and developer options***.

## Next

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Back up the new computer</strong></td><td>Turn on automatic backups so you're ready next time.</td><td><a href="/unigetui/guides/new-computer/backup.md">Back up your app list automatically</a></td></tr><tr><td><strong>Update everything</strong></td><td>Bring all your apps to their latest version in one click.</td><td><a href="/unigetui/guides/updates/update-all.md">Update everything in one click</a></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/guides/new-computer/restore.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.