Go to file
PrivateBin Translator Bot 5cb40e1f9e New translations en.json (Ukrainian) 2022-10-25 07:04:46 +02:00
.github Use NodeJs v16 for tests 2022-07-10 00:13:47 +02:00
cfg credit change, document it and improve wording 2022-10-23 13:10:55 +02:00
css incrementing version 2022-04-05 07:30:51 +02:00
doc changes required for jsdoc, adding legacy.js to code coverage 2019-09-22 21:18:19 +02:00
i18n New translations en.json (Ukrainian) 2022-10-25 07:04:46 +02:00
img updating change log and optimizing png 2019-11-02 17:03:40 +01:00
js update zlib to 1.2.13 2022-10-15 09:05:19 +02:00
lib adding tests for YOURLS functionality 2022-10-23 13:09:54 +02:00
tpl allow unit tests to pass 2022-10-23 09:12:31 +02:00
tst PHP 5.6 seems to tolerate an empty string as valid JSON 2022-10-23 13:21:22 +02:00
vendor update all libraries 2022-02-18 07:36:09 +01:00
.codeclimate.yml removing PHPCS from CodeClimate, since it can't be configured and contradicts our code style enforced by other checkers 2018-01-06 15:10:21 +01:00
.csslintrc add codeclimate settings 2016-07-06 13:20:14 +02:00
.editorconfig Force JSON request for getting paste data 2017-04-11 16:34:13 +02:00
.eslintignore implementing ESlint suggestions 2018-01-06 07:17:33 +01:00
.eslintrc eslint env cleanup 2019-09-08 09:12:56 +02:00
.gitattributes these don't belong in a release 2021-06-06 17:52:10 +02:00
.gitignore added Google Cloud Storage support 2021-05-28 22:39:50 +02:00
.htaccess.disabled Allow to upload bigger files 2019-07-12 09:03:14 +02:00
.jshintrc addressing issues found by codacy 2018-10-20 22:05:35 +02:00
.nsprc add Node Security configuration and enabling it in CodeClimate 2018-01-06 08:06:09 +01:00
.php_cs Add missing fixers from PHP CS 2016-10-31 11:29:25 +01:00
.scrutinizer.yml Merge branch 'issue-794/add-gcs-support' of https://github.com/binxio/PrivateBin into binxio-issue-794/add-gcs-support 2021-05-30 07:57:58 +02:00
.styleci.yml limit files of StyleCI scan 2022-01-10 21:26:28 +01:00
BADGES.md adding browserstack badge in order to be elegible for their OpenSource program (https://www.browserstack.com/open-source?ref=pricing) 2019-09-16 20:51:49 +02:00
CHANGELOG.md credit change, document it and improve wording 2022-10-23 13:10:55 +02:00
CODE_OF_CONDUCT.md document the applicability of RFC 1855 / Netiquette 2019-07-27 07:31:34 +02:00
CREDITS.md credit change, document it and improve wording 2022-10-23 13:10:55 +02:00
INSTALL.md implemented S3 storage backend 2022-10-22 18:30:24 +02:00
LICENSE.md Merge branch 'master' into webcrypto, implementing base58, fixes #377 2019-05-15 21:20:54 +02:00
Makefile incrementing version 2022-04-05 07:30:51 +02:00
Procfile Create Procfile 2022-02-10 18:53:39 -05:00
README.md incrementing version 2022-04-05 07:30:51 +02:00
SECURITY.md incrementing version 2022-04-05 07:30:51 +02:00
browserconfig.xml moved images to img folder 2017-01-08 10:13:12 +01:00
codacy-analysis.yml Let's try Codacy code scanning again 2021-04-04 13:29:41 +02:00
composer.json implemented S3 storage backend 2022-10-22 18:30:24 +02:00
composer.lock update all libraries 2022-02-18 07:36:09 +01:00
crowdin.yml Update Crowdin configuration file 2020-10-04 12:41:27 +02:00
index.php incrementing version 2022-04-05 07:30:51 +02:00
manifest.json moved images to img folder 2017-01-08 10:13:12 +01:00
robots.txt adding an example to opt-out of the privatebin directory 2020-04-08 05:35:38 +02:00

README.md

PrivateBin

Current version: 1.4.0

PrivateBin is a minimalist, open source online pastebin where the server has zero knowledge of pasted data.

Data is encrypted and decrypted in the browser using 256bit AES in Galois Counter mode.

This is a fork of ZeroBin, originally developed by Sébastien Sauvage. PrivateBin was refactored to allow easier and cleaner extensions and has many additional features. It is, however, still fully compatible to the original ZeroBin 0.19 data storage scheme. Therefore, such installations can be upgraded to PrivateBin without losing any data.

What PrivateBin provides

  • As a server administrator you don't have to worry if your users post content that is considered illegal in your country. You have plausible deniability of any of the pastes content. If requested or enforced, you can delete any paste from your system.

  • Pastebin-like system to store text documents, code samples, etc.

  • Encryption of data sent to server.

  • Possibility to set a password which is required to read the paste. It further protects a paste and prevents people stumbling upon your paste's link from being able to read it without the password.

What it doesn't provide

  • As a user you have to trust the server administrator not to inject any malicious code. For security, a PrivateBin installation has to be used over HTTPS! Otherwise you would also have to trust your internet provider, and any jurisdiction the traffic passes through. Additionally the instance should be secured by HSTS. It can use traditional certificate authorities and/or use a DNSSEC protected DANE record.

  • The "key" used to encrypt the paste is part of the URL. If you publicly post the URL of a paste that is not password-protected, anyone can read it. Use a password if you want your paste to remain private. In that case, make sure to use a strong password and share it privately and end-to-end-encrypted.

  • A server admin can be forced to hand over access logs to the authorities. PrivateBin encrypts your text and the discussion contents, but who accessed a paste (first) might still be disclosed via access logs.

  • In case of a server breach your data is secure as it is only stored encrypted on the server. However, the server could be absused or the server admin could be legally forced into sending malicious code to their users, which logs the decryption key and sends it to a server when a user accesses a paste. Therefore, do not access any PrivateBin instance if you think it has been compromised. As long as no user accesses this instance with a previously generated URL, the content can't be decrypted.

Options

Some features are optional and can be enabled or disabled in the configuration file:

  • Password protection

  • Discussions, anonymous or with nicknames and IP based identicons or vizhashes

  • Expiration times, including a "forever" and "burn after reading" option

  • Markdown format support for HTML formatted pastes, including preview function

  • Syntax highlighting for source code using prettify.js, including 4 prettify themes

  • File upload support, image, media and PDF preview (disabled by default, size limit adjustable)

  • Templates: By default there are bootstrap CSS, darkstrap and "classic ZeroBin" to choose from and it is easy to adapt these to your own websites layout or create your own.

  • Translation system and automatic browser language detection (if enabled in browser)

  • Language selection (disabled by default, as it uses a session cookie)

  • QR code for paste URLs, to easily transfer them over to mobile devices

Further resources

Run into any issues? Have ideas for further developments? Please report them!