Distributing your plugin

You can distribute a plugin with OctoPrint via two ways.

Manual file distribution

You can have your users copy it to OctoPrint’s plugin folder (normally located at ~/.octoprint/plugins under Linux, %APPDATA%\OctoPrint\plugins on Windows and ~/Library/Application Support/OctoPrint on Mac). In this case your plugin will be distributed directly as a Python module (a single .py file containing all of your plugin’s code directly and named like your plugin) or a package (a folder named like your plugin + __init.py__ contained within).

Proper packages installable via pip

You can have your users install it via pip and register it for the entry point octoprint.plugin via your plugin’s setup.py, this way it will be found automatically by OctoPrint upon initialization of the plugin subsystem 1.

For an example of how the directory structure and related files would look like in this case, please take a look at the helloworld example from OctoPrint’s example plugins.

This variant is highly recommended for pretty much any plugin besides the most basic ones since it also allows requirements management and pretty much any thing else that Python’s setuptools provide to the developer.

See also

OctoPrint Plugin Cookiecutter Template

A Cookiecutter Template providing you with all you need to get started with writing a properly packaged OctoPrint plugin. See the Plugin Tutorial for an example on how to use this.



The automatic registration will only work within the same Python installation (this also includes virtual environments), so make sure to instruct your users to use the exact same Python installation for installing the plugin that they also used for installing & running OctoPrint. For OctoPi this means using ~/oprint/bin/pip for installing plugins instead of just pip.

Registering with the official plugin repository

Once it is ready for general consumption, you might want to register your plugin with the official OctoPrint Plugin Repository. You can find instructions on how to do that in the Plugin Repository’s help pages.

If you used the OctoPrint Plugin Cookiecutter Template when creating your plugin, you can find a prepared registration entry .md file in the extras folder of your plugin.