Skip to content

Latest commit

 

History

History
76 lines (52 loc) · 1.99 KB

README.rst

File metadata and controls

76 lines (52 loc) · 1.99 KB

pb

Overview

pb is a lightweight pastebin and url shortener built using flask.

There is currently no known general-purpose public pb deployment. See #246 for details.

Features

  • full paste and short-url CRUD
  • private pastes
  • tweakable syntax highlighting
  • terminal recording playback
  • markup rendering

Suggested versions

  • python >= 3.6
  • mongodb >= 3.2
  • docker >= 17.04

Development

pb comes with a Dockerfile and docker-compose.yaml to start development environments easily. Refer to relevant documentation for how to install docker and docker-compose.

start pb with:

docker-compose up

pb will be listening on http://localhost:10002

Deployment

ptpb.pw (the reference deployment) uses ptpb-deploy, which includes TLS termination, automatic x509 certificate rotation, and response caching.

For a simpler deployment, the included Dockerfile and docker-compose.yaml can be used verbatim, and are easy to read/study.

Other best practices include:

  • not using a shared/system python, when this is shared with packages other than pb
    • using site-packages is fine/preferred inside a container or isolated filesystem, otherwise use venv
    • if you need/want a version of python other than what your distribution packages, pyenv is a good option
  • not using debian or centos
    • these provide severely outdated packages, and require additional work to compensate for this