Uninstalling discourse instance


Is there comprehensive documentation available on how to uninstall discourse instance via command line?
This is required to do a clean install once again.


According to the official installation guide, discourse lives inside its own docker container.
So, you simply need to stop the container and remove /var/discourse folder.


  1. ssh into your vps server.
  2. cd /var/discourse
  3. ./launcher stop app
  4. ./launcher destroy app
  5. cd /var
  6. sudo rm -rf discourse
1 Like

It would be nice to include Uninstall section in installation or some other guide.

Since the recommended way to do things is to install Discourse on a fresh installation used for nothing else, the way most people uninstall is by destroying the virtual machine.

Those instructions are by design for only the one most standard case.


Absolutely, “Uninstall” is so year 2000 :wink:

1 Like

One interesting thing, if I want to stop and destroy the app it will try to download another base image. What the hell? :smile:

:/var/discourse> sudo ./launcher stop app
x86_64 arch detected.

WARNING: We are about to start downloading the Discourse base image
This process may take anywhere between a few minutes to an hour, depending on your network speed

Please be patient

2.0.20220818-0047: Pulling from discourse/base
Digest: sha256:7734701087766821ffb2ddcef423754798bd345c2ac0d550131c6e6905c268e8
Status: Downloaded newer image for discourse/base:2.0.20220818-0047
You have less than 5GB of free space on the disk where /var/lib/docker is located. You will need more space to continue
Filesystem            Size  Used Avail Use% Mounted on
/dev/mapper/vg00-var  9.8G  4.9G  4.4G  53% /var

Would you like to attempt to recover space by cleaning docker images and containers in the system? (y/N)y
If the cleanup was successful, you may try again now

What I did was:

  1. sudo rm -rf discourse
  2. find the docker container that has discourse, kill it and then remove it.

Let me know if I need to do anything else. :slight_smile:

1 Like

Yeah. ./launcher keeps itself and the Discourse base image up to date. If you’re familiar with docker then you can just docker stop app;docker rm app as you did.

1 Like

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.