Remove an app by hand
Use this page when Tools > Stack Manager > Delete can’t remove an app, for example when Delete fails or the app is not in its list. Delete does all of the steps below for you, so use it when you can. See Stack Manager.
If the name you picked is a helper, such as an app’s database, Delete says “Cannot delete dependency directly”. That is not a reason to remove it by hand: delete the parent app and pick Delete APP + all dependencies.
If the app is missing from the Delete list
Section titled “If the app is missing from the Delete list”The Delete list comes from the app lines in your main compose file. If the app is missing from the list but its file compose/HOSTNAME/APP.yml still exists, put its line back and use Delete instead. Open docker-compose-HOSTNAME.yml and add this line just above # SERVICE-PLACEHOLDER-DO-NOT-DELETE, with two spaces in front of the dash. Keep $HOSTNAME as it is and replace only APP:
- compose/$HOSTNAME/APP.ymlBefore you start
Section titled “Before you start”In these steps, APP is the name in the app’s compose file name, for example n8n for compose/HOSTNAME/n8n.yml. Run the commands from your Docker folder (cd YOUR_DOCKER_FOLDER). For where each file sits, see Docker folder layout.
-
Find the app’s helper containers, such as its database. Deployrr adds a helper’s line to the main compose file right below the app’s line when it installs the app:
Terminal window grep -n "compose/" docker-compose-HOSTNAME.ymlMost helpers are named after the app, for example
n8n-postgresqlbelown8n. A few are not, such asgotenbergandtikafor Paperless-NGX orguacdfor Guacamole. Do every step below for the app and for each helper. An app’sdepends_on:list can also name another app that you installed on its own, such as Ollama for Open-WebUI. Leave those alone. -
Find the app’s secret files:
Terminal window sudo ls secrets/Most start with the app’s name, with
_in place of-, for examplen8n_postgresql_password. A few don’t, such aswgeasy_passwordfor WG-Easy. Some secrets are shared:mariadb_root_passwordis used by MariaDB and phpMyAdmin. Before you remove a secret, check which compose files name it. Only the app and its helpers should show up:Terminal window sudo grep -l SECRET_NAME docker-compose-HOSTNAME.yml compose/HOSTNAME/*.yml -
Stop and remove the container. The container name is almost always the same as
APP. To check, runsudo docker ps -a.Terminal window sudo docker stop APPsudo docker rm APPTo learn more about these commands, read UDMS part 13: Managing container lifecycle (manual setup, shows the commands only).
-
Edit the main compose file with
sudo nano docker-compose-HOSTNAME.yml:- Delete the line
- compose/$HOSTNAME/APP.yml(or# - compose/$HOSTNAME/APP.ymlif the app is disabled). - Under
secrets:near the top, delete the two lines for each secret from step 2 that only this app uses: the secret’s name and thefile:line below it. Not every secret has lines here. - If no secrets are left under
secrets:, put#in front of it so it reads# secrets:, as Deployrr does. - Leave every line that ends in
DO-NOT-DELETEin place.
- Delete the line
-
Delete the app’s compose file:
Terminal window sudo rm compose/HOSTNAME/APP.yml -
If the app was behind Traefik, delete its rules file. Traefik drops the app’s route by itself.
Terminal window sudo rm appdata/traefik3/rules/HOSTNAME/app-APP.yml -
If you use the Deployrr Dashboard, open
appdata/deployrr-dashboard/config/services.yamlwithsudo nanoand delete the app’s entries, each from itsSTARTcomment line to itsENDcomment line. Forn8n, they are markedN8N-LOCAL-STARTandN8N-LOCAL-END, and the same withREMOTEorOTHER. Dashes stay in the marker, for exampleOPEN-WEBUI-LOCAL-START. -
Optional: delete the app’s values in
.env, such asN8N_PORTandN8N_VERSION_PIN. Left in place, they do no harm. The names use the app’s name in capitals without dashes, soopen-webuibecomesOPENWEBUI. To list them:Terminal window sudo grep -n "^OPENWEBUI" .envDo the same for each helper, for example
N8NPOSTGRESQL. A few apps use other names, such asTS_AUTH_KEYfor Tailscale. A short name can also match another app:REDISmatchesREDISCOMMANDER_PORT. Check that each line belongs to this app before you delete it. See Edit .env values and secrets. -
Only if you want the data gone too: delete the app’s data folder and the secret files from step 2 that no other app uses. Skip this step to keep the data for a later reinstall, as a Safe delete does.
Terminal window sudo rm -r appdata/APPsudo rm secrets/SECRET_NAMEYour media and downloads folders are outside the Docker folder and are not touched.
Check it worked
Section titled “Check it worked”-
Check that the main compose file is still valid. No output means it is fine:
Terminal window sudo docker compose --profile all -f docker-compose-HOSTNAME.yml config --quietIf you see an error, compare the file with your
.bakcopy to find a line you removed or changed by mistake. -
Open Stack Manager > Services Status. The app is no longer listed.
-
Run Up. Your other apps start as before.
Deployrr still counts an app you removed by hand as installed. ReDash adds it back to the dashboard, so delete its entries again after a ReDash. When you install the app again later, Deployrr shows the Already Installed box. Select Yes to go on. To install it again with the data you kept, see Reinstall an app and keep its data.

