Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Upgrading from ZeroBin 0.19 Alpha
This upgrade guide is intended for installations of ZeroBin version 0.19 Alpha and has been tested with the latest commit of Sébastien SAUVAGE as of the time of this writing.
As always when upgrading or otherwise changing your files manually, please create a backup of your installation before proceeding.
Optional: If your service is popular and frequently used, it might be nice to announce the service interruption to your users, i.e. by adding a message into the note block of
tpl/page.html. If you have the possibility you could disable the access to your site in your hosting configuration while you perform the actual upgrade.
Download the latest stable release of PrivateBin.
Optional: If you don't have the URL of a current paste in your installation, you might want to create one before the upgrade to be able to test if it still works afterwards.
Remove all files from your document root folder, except for the
datadirectory. It contains the pastes, their discussions, the server salt (used to create valid deletion links) and the traffic limiter rules.
If you want to keep the current traffic limiter rules, rename "data/trafic_limiter.php" into "data/traffic_limiter.php".
Upload the contents of the archive you downloaded in "Preparations" step 3. into your document root.
Copy the newly created file
cfg/conf.iniand edit it with a text editor:
Change the setting
Suggested: The already existing pastes will now fall back to the
defaultformattersetting. Leave it on "plaintext", to keep these displayed in the same style as they were in 0.19 Alpha.
Optional: If you prefer to use the classic ZeroBin design instead of the new bootstrap-based one, change the setting
templateto "page" and uncomment the
Optional: You might not want to enable all the new features by default. Review and change any other configuration options to your liking. Detailed descriptions of the options can be found in the configuration guide. Note that there is currently not yet a way to migrate a data folder based installation into a database one.
Optional: If you disabled the access to your website during the upgrade, you can reenable it again.
Test your service, i.e. with a previously created paste. Create a new paste, view it, delete one with the delete-link. Typical problems you might encounter are permission problems: Make sure your webservers user has the permission to write into both the
tmpdirectories in the document root.
Suggested: For added security you might consider to move any non necessary folders out of the document root. More details on this can be found in the advanced installation guide.