koala73 / koala73/worldmonitor

docs(self-host): document Docker/Podman uninstall in SELF_HOSTING.md

Open Beginner friendly
#5,435 1 comment 0 reactions 0 assignees View on GitHub
documentation P3
Dominant language
TypeScript
Stars
86.6k
Forks
13.1k
Avg merge
8h 4m
Merged PRs (30d)
825

Description

## Problem
Reporter cannot uninstall World Monitor. Title typo: Uninsttall. No OS or install path given. A comment said "just destroy the docker containers," which is the Docker path but is not documented as uninstall.

## What already exists
`SELF_HOSTING.md` is the install path for Docker/Podman:
- `docker compose up -d` / `uvx podman-compose up -d`
- `./scripts/run-seeders.sh`
- Redis data lives in the `redis-data` volume and **is lost on `docker compose down -v`** (already stated in the seeder section)
- Rebuild: `docker compose down && docker compose up -d`

There is **no uninstall script** in the repo. That is a docs gap, not a missing binary, unless they installed the desktop AppImage (see #5757 / #5902), which this issue does not mention.

## Scope
Document how to fully remove a **self-hosted Docker/Podman** install. Do not invent a new packaging format.

**In scope**
- A `## Uninstall` section in `SELF_HOSTING.md` that names the commands and what they delete
- `docker compose down -v` (or podman-compose equivalent) plus removal of the clone, `.env`, and `docker-compose.override.yml`
- Explicit warning that `-v` wipes Redis

**Out of scope**
- Desktop AppImage / Tauri uninstall (#5757, #5902)
- A new `scripts/uninstall.sh` unless the docs path is not enough (YAGNI)
- Uninstalling a Vercel/hosted WorldMonitor.app account

## Acceptance
- [ ] `SELF_HOSTING.md` has an Uninstall section with copy-pasteable Docker and Podman commands
- [ ] Commands named: stop stack, remove volumes, remove clone + `.env` + override file
- [ ] Volume-wipe warning is next to the command, not only in the seeder section
- [ ] Desktop/AppImage is pointed at the desktop issues, not faked here

Effort: XS (~0.25d). Docs, not a new script.

Related: #6647 (what self-hosting actually gives you), #5415 (self-host 401).

Contributor guide

Open the contributing guide

Research direction

Read SELF_HOSTING.md and locate the existing Docker/Podman install and rebuild instructions. Add an Uninstall section covering the Docker and podman-compose stop, volume-removal, and clone cleanup steps, with the Redis data warning beside the volume command. Confirm the section is copy-pasteable and points desktop/AppImage users to the referenced desktop issues.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
88/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.