uninstall - nself-org/cli GitHub Wiki
This page covers how to fully remove ɳSelf from your machine, including the CLI binary, local state, Docker containers, volumes, networks, and images.
brew uninstall nselfIf you installed manually instead of via Homebrew:
sudo rm /usr/local/bin/nselfrm -rf ~/.nselfStop any running ɳSelf stack first:
# Inside your project directory
nself stop
# Or with Docker Compose directly if nself is already removed
cd /path/to/your/project
docker compose down --volumes --remove-orphansRemove ɳSelf Docker images:
docker images | grep nself | awk '{print $3}' | xargs docker rmi -fRemove any ɳSelf Docker networks:
docker network ls | grep nself | awk '{print $1}' | xargs docker network rmYour project directory (containing .env, .env.dev, docker-compose.yml, etc.) is not touched by the steps above. Remove it manually if you no longer need it:
rm -rf /path/to/your/nself/projectsudo rm /usr/local/bin/nselfOr if you installed to a different location:
which nself
sudo rm $(which nself)rm -rf ~/.nself# Inside your project directory
nself stop
# Remove containers and volumes
docker compose down --volumes --remove-orphans
# Remove nSelf Docker images
docker images | grep nself | awk '{print $3}' | xargs docker rmi -f
# Remove nSelf Docker networks
docker network ls | grep nself | awk '{print $1}' | xargs docker network rmrm -rf /path/to/your/nself/projectɳSelf runs inside WSL2. The uninstall steps are the same as Linux, run inside your WSL2 terminal.
sudo rm /usr/local/bin/nself
rm -rf ~/.nselfdocker compose down --volumes --remove-orphans
docker images | grep nself | awk '{print $3}' | xargs docker rmi -f
docker network ls | grep nself | awk '{print $1}' | xargs docker network rmIf you want to remove the entire WSL2 environment:
# In PowerShell (Windows)
wsl --unregister UbuntuThis deletes the entire WSL2 virtual disk. Only do this if you have no other projects inside it.
After completing the steps above, verify nothing remains:
# Binary is gone
which nself 2>&1 || echo "nself not found — OK"
# State directory is gone
ls ~/.nself 2>&1 || echo "~/.nself not found — OK"
# No nself containers running
docker ps -a | grep nself || echo "no nself containers — OK"
# No nself images
docker images | grep nself || echo "no nself images — OK"
# No nself networks
docker network ls | grep nself || echo "no nself networks — OK"All five lines should report "not found" or "no nself X" for a clean uninstall.
← Installation | Home →