How to completely uninstall / remove a plugin

I only rebuild a few times per year. I am currently running into an issue with a plugin I do not want.

When I include the plugin repository in my app.yml file I can bootstrap but run into blank screens with the following errors:

When I comment out the plugin repository in app.yml I fail to bootstrap.

So my question is, how can I fully remove the plugin(s) and all of their remnants from my install as if it were never there in the first place?

Can you share the error in bootstrap when doing a rebuild without the plugin?


Here is the error when I try to bootstrap without the plugin.

Pups::ExecError: cd /var/www/discourse && su discourse -c 'bundle exec rake db:migrate' failed with return #     <Process::Status: pid 22379 exit 1>
Location of failure: /pups/lib/pups/exec_command.rb:108:in `spawn'
exec failed with the params {"cd"=>"$home", "hook"=>"bundle_exec", "cmd"=>["su discourse -c 'bundle install --   deployment --verbose --without test --without development'", "su discourse -c 'bundle exec rake db:migrate'", "su  discourse -c 'bundle exec rake assets:precompile'"]}`

And then scrolled up I get this:

I, [2017-01-01T23:52:03.038385 #15]  INFO -- : > cd /var/www/discourse && su discourse -c 'bundle exec rake db:migrate'
URGENT: type Failed to initialize site default
rake aborted!
ArgumentError: type

Handy with most things but I don’t know where to start with this because I bootstrap fine with the plugin.

Looks like df-core is the plugin at fault. Isn’t that one of the Discouse PRO plugins? It’s been a while since I looked at the code on those but if memory serves they contained db migrations. Not sure if that’s good or bad at the moment.

Is it possible that by removing the plugin (and thus removing the migrations) it’s throwing an error?

1 Like

nobody knows how to just remove a plugin??

To remove a plugin, simply remove the - git clone line from your app.yml file and rebuild your site via ./launcher rebuild app.


Would that method remove the entries the plugin would have created in the database, like tables or records?

Or when you uninstall a plugin garbage in the database would be left after it?


I did this method multiple times, the Fingerprint plugin will not uninstall even though it is not in my app.yml.

How to delete this anyway?

Did you rebuild after you edited your app.yml?

Did you clear you local cache?

Yes, I’ve had several rebuilds and changes since. I cleared my cache.

And you saved after you changed your app.yml :man_shrugging:

Ofcourse, otherwise plugins I installed after would not install, but they are :grinning:

In a support forum nothing is obvious :scream:


For those who only administer Discourse occasionally, or newbies, or in general to save time, it’s most helpful to be as specific as possible.

In this particular case, where exactly is the app.yml file? I don’t see one in /var/discourse, but I do see an app-sparkpost.yml. Maybe that’s the file I created ~5 years ago when I deployed the instance; I don’t know. Is that the right path? How does discourse knows to read this file if there’s no app.yml in /var/discourse?

I wouldn’t expect to find any yaml files at /var/discourse itself, no. The correct path would be /var/discourse/containers. I believe Discourse will read all files in the containers directory, but an engineer will be better equipped to answer this than me. I don’t think the name actually matters.

1 Like

I believe the app.yml can be found at /var/discourse/containers/app.yml. You will need to edit that file and remove any references to the plugin. You should be able to locate something similar to the following in the file:

## Plugins go here
## see for details
    - exec:
        cd: $home/plugins
          - git clone
          - git clone
          - git clone

Each of the git clone lines there refers to a plugin installed in the Discourse instance. After editing the file you will need to rebuild your Discourse application. From the /var/discourse folder you can run ./launcher rebuild app to rebuild your Discourse application.

1 Like