Reinstall an app and keep its data
Reinstalling puts an app back with Deployrr’s default settings and keeps the app’s data folder. This guide shows the ways to do it, what is kept, what is reset, and how to back up first.
Overview
Section titled “Overview”There are three ways to reinstall an app:
| Way | Use it when |
|---|---|
| Install it again from Apps > Browse Apps | The app is installed and you want to redo its install questions, such as the GPU. |
| Apps > Manage Apps > the app > Reinstall | The app is stopped and you want to reinstall it without the Already Installed box. |
| Tools > Stack Manager > Delete > Safe, then install it again | You want a clean start for the app’s compose file, rules file and .env values, and you want to keep its data. |
All three keep the app’s appdata folder. All three replace the app’s compose file with the default one.
You need a Basic, Plus or Pro license to install, reinstall or delete apps. With a Free license you see “License Required”. See Licenses.
Before you reinstall
Section titled “Before you reinstall”-
Stop the app if you can. A copy of a running app’s data may be incomplete.
-
Open a terminal on the server and go to your Docker folder. Replace
YOUR_DOCKER_FOLDERwith the path to it:Terminal window cd YOUR_DOCKER_FOLDER -
Copy the app’s data folder. Replace
APPwith the app’s name, such asplex:Terminal window sudo cp -a appdata/APP ~/APP-appdata-backup -
Copy the app’s compose file. Replace
HOSTNAMEwith your server’s hostname andAPPwith the app’s name:Terminal window sudo cp compose/HOSTNAME/APP.yml ~/APP.yml.backup
If you have a Pro license, you can also back up the whole Docker folder with Tools > Backups > Backup. See Back up and restore your Docker folder.
When to reinstall
Section titled “When to reinstall”- To pick a GPU for an app that is already installed. See GPU hardware transcoding.
- To answer the install questions again, such as the app’s port.
- To replace a broken or hand-edited app compose file with the default one. This is the app’s own file in
compose/HOSTNAME, not your main compose file. For the main file, see Docker environment setup fails with: docker-compose file is malformed. - To get a new rules file and answer the login and exposure questions again. See Change login or exposure.
If you only edited the app’s compose file or .env values, you don’t need a reinstall. Use Recreate in Stack Manager so the app picks up your change and keeps your edits.
Reinstall from the Apps menu
Section titled “Reinstall from the Apps menu”- Go to Apps > Browse Apps. Apps that are installed show [Running] or [Installed].
- Select the app and choose Install.
- At “Do you want to install this app?”, choose Yes.
- Read the Already Installed box. It says the app is already installed or running. It lists what reinstalling does:
- Stop the existing container.
- Recreate with latest image.
- Preserve data volumes.
- Choose Yes to go on. Choose No to cancel and change nothing.
- Answer the install questions that follow.
Choosing Yes stops and removes the app’s container if it is running, then installs it again. Deployrr also takes the app off the Deployrr Dashboard and adds it again at the end of the install.
Reinstall from Manage Apps
Section titled “Reinstall from Manage Apps”- Go to Apps > Manage Apps. The title shows how many apps are installed, for example “Manage Apps (3 installed)”. If none are, you see “No apps installed.”
- Select the app and choose Manage.
- In the Manage: APP box, check the status line. The menu you get depends on it.
- If the app is running, choose Stop. Then go back to Apps > Manage Apps and open the app again.
- Choose Reinstall.
- Look for “APP reinstalled successfully”.
Reinstall is only in the menu when the app is stopped. This route skips the Already Installed box.
For context, the other actions in this box are below. See Install and manage apps from the Apps menu for each one.
| App status | Actions |
|---|---|
| Running | Logs, Restart, Stop, Remove |
| Stopped | Start, Logs, Remove, Reinstall |
Core apps such as Traefik are not in the Manage Apps list. They have their own menus.
What a reinstall keeps and what it resets
Section titled “What a reinstall keeps and what it resets”A reinstall keeps the app’s appdata folder and an existing Traefik rules file. It replaces the app’s compose file, and those of linked containers such as a database, with the defaults, and asks the install questions again. For .env values, passwords and secret files, see What Reinstall keeps and resets.
Config files
Section titled “Config files”During the install you see “Copying configuration files…” and then “Files copied successfully”. For some apps, this writes a config file into the app’s appdata folder.
qBittorrent and qBittorrent VPN are two examples. Reinstalling qBittorrent replaces appdata/qbittorrent/qBittorrent/qBittorrent.conf, and the web UI login goes back to admin and adminadmin. Reinstalling qBittorrent VPN deletes appdata/qbittorrent-vpn/qBittorrent/qBittorrent.conf, and the login becomes admin with a temporary password from its log. Either way your qBittorrent settings are reset. See Reset to the default login and settings.
Copy any config file you changed before you reinstall. For the other apps that get a config file written again, and the steps to keep your edits, see Config files a reinstall writes again.
Safe delete, then reinstall
Section titled “Safe delete, then reinstall”Use this to start the app clean and keep its data.
- Make the copies in Before you reinstall.
- Go to Tools > Stack Manager > Delete.
- Pick Safe. It keeps the app’s
appdatafolder and its secrets. - Follow the prompts. See Stack Manager for each one.
- Look for “(safe delete - data preserved)”.
- Go to Apps > Browse Apps, select the app and choose Install.
- At “Do you want to install this app?”, choose Yes. You don’t see Already Installed, because the app is gone.
- Answer the install questions again.
- Open the app and check that your data is there.
Both Safe and Full delete remove the app’s compose file, its .env settings, its Traefik rules file and its Dashboard entry. Only Full deletes the appdata folder, secrets and unused Docker volumes. Never pick Full if you want to reuse the data.
Because the rules file is gone, the install makes a new one.
To see Stack Manager delete and a reinstall, watch Deployrr 5 walkthrough: Uninstall App at 32:29 (shows Deployrr v5; menus and steps differ in v6).
Change login or exposure
Section titled “Change login or exposure”When Traefik is running and the app supports it, the install asks for a subdomain, a login method and, in Advanced mode, an exposure choice. See Choose a login method for your apps and Simple vs Advanced Traefik mode.
If the app already has a rules file, a plain reinstall keeps that file. You still see the questions, but Traefik keeps the old subdomain, login and exposure. The Dashboard link may show your new answers while Traefik uses the old ones. Do one of these:
- Use Security > Manage Auth for the login method. The login page covers it.
- Do a Safe delete, then install the app again. The new rules file uses your new answers.
- To change only the subdomain, edit the rules file. See Change the subdomain of an app you already installed.
If something goes wrong
Section titled “If something goes wrong”- The app starts but its data looks empty. Check that
appdata/APPstill exists in your Docker folder. If you did a Full delete, restore your copy of the folder. - Your compose edits are gone. Put the changes back from
~/APP.yml.backup, then use Recreate in Stack Manager. - The install stops at a question or error. Read the message, fix it, and run the install again.
Next steps
Section titled “Next steps”- Check the app’s logs from Apps > Manage Apps > the app > Logs.
- Add your edits back into the compose file, then use Recreate in Stack Manager.

