Uninstall app

POST/api/install/{app}/uninstall

Stops the app and removes its containers. The app's data stays on disk, and installing again picks it up. Protection: token.

Authorizations

Authorizationstringheaderrequired

The token you start the server with: homebutler serve --token <token>, or web.token in the config file. Send it as Authorization: Bearer <token>. When the server has a token, every /api/ route except the CORS preflight requires it, reads included.

Path parameters

appstringrequired

The app name from List apps.

Example: it-tools

Response

200 · application/json

The app was uninstalled and its data kept.

statusstringrequired

What happened.

Available options: installedfaileduninstalledpurged

appstringrequired

The app name.

issuesstring[]

Why a pre-flight check failed. Present when status is failed.

portstring

The host port.

pathstring

The folder with the app's compose file and data.

statestring

The containers' state after the install.

data_preservedboolean

true after an uninstall, false after a purge.

warningstring

Present when an earlier install's state couldn't be carried over, or when part of the data is in Docker volumes outside the app directory.

kept_volumesstring[]

Volumes that still exist after a purge. Present only when not empty.

unchecked_volumesstring[]

Volumes Docker couldn't be asked about during a purge. Present only when not empty.

cURLcURLPythonJavaScript

curl --request POST \
  --url 'http://localhost:8080/api/install/{app}/uninstall' \
  --header 'Authorization: Bearer <token>'

{
  "status": "uninstalled",
  "app": "it-tools",
  "data_preserved": true
}