Welcome to the documentation of the pinnwand pastebin software.


pinnwand is a straightforward pastebin written for Python 3.8 and up using the Tornado web framework and the sqlalchemy ORM. It uses the awesome pygments library for its syntax highlighting.

It’s no nonsense and has no features aside from pasting code temporarily.


You can run the built in pinnwand HTTP server through the pinnwand http command. This will serve up a HTTP server listening on localhost on port 8000 and use an in-memory sqlite database to store data.

If you stop the process then the database will be gone again.

For persistence you’ll need to configure pinnwand to use another database. See the Configuration page for the howto.


You can install pinnwand from PyPI by running pip as follows:

pip install pinnwand

I suggest you use a virtual environment for installation. There are extended Installation instructions available which explain how to do so.


pinnwand is a place that will accept your first contribution to an open source project. The preferred place to start out is to visit our GitHub page and look at the issues there. If you can solve any of them then you can send a pull request. I will make sure to review your code.

If you are thinking about contributing a new feature then keep in mind that pinnwand is trying to stay as small and lean of a project as possible. Open a ticket first if you have a specific feature in mind.

Table of Contents