Goto navigation

phorkie - Git based pastebin

Self-hosted pastebin software written in PHP. Pastes are editable, may have multiple files and are stored in git repositories.

Homepage | Bug tracker | Git repository · GitHub mirror | News


  • every paste is a git repository
    • repositories can be cloned
    • clone url can be displayed
    • remote pastes can be forked (rel="vcs-git" and
    • single click forking of forks on different servers to your own
  • paste editing
    • add new files
    • delete existing files
    • replace file with upload
  • embedding of pastes in your blog (via JavaScript or oEmbed)
  • multiple files in one paste - option to edit single files in a multi-file paste
  • syntax highlighting with GeSHi
  • rST and Markdown rendering
  • image upload + display
  • OpenID authentication
  • external tool support
    • xmllint
    • php syntax check
  • history in the sidebar
    • old files can be downloaded easily
  • search across pastes: description, file names and file content
    • options: quoting, logical and, or, not, partial words
  • webhook support - get notified when pastes are created, edited or deleted
  • atom feed for new and updated pastes
  • notifies remote instances via linkbacks when a paste has been forked
  • text file detection for unknown file types


phorkie is released as self-contained .phar file that includes all dependencies, as well as a normal zip file.

Download the latest release:

  • 0.8.1, 2017-08-29
    • phorkie-0.8.1.phar, 5614 kiB
      SHA256: d4e5b0e5fea1320e8acd9bc66a9cf3be1e7d9d249a8386966ef167b30de32da7
    • phorkie-0.8.1.tar.bz2, 198 kiB
      SHA256: 8b37b8ee62ad253e8989794dd02f8826ee99156bc57352368917616541de812f

See phorkie downloads page for all released versions.



Download phorkie-0.8.1.phar and put it in your web server's document root directory.

No further setup needed.


Only valid if your webserver is configured to let PHP handle .phar files.

Unfortunately, no Linux distribution has this activated by default. You can do it yourself, though - see Enable .phar handling in your web server.


PHP has some bugs in its .phar handling code (e.g. with FPM).

So currently, the .phar option is considered experimental.

Zip package

  1. Unzip the phorkie release file:

    $ tar xjvf phorkie-0.8.1.tar.bz2
  2. Create the git directories:

    $ mkdir -p www/repos/git www/repos/work
    $ chmod og+w www/repos/git www/repos/work
  3. Install dependencies

  4. Copy data/config.php.dist to data/config.php and adjust it to your needs:

    $ cp data/config.php.dist data/config.php
    $ $EDITOR data/config.php

    Look at config.default.php for values that you may adjust.

  5. Set your web server's document root to /path/to/phorkie/www/ Alternatively, you can add a symlink to the www folder into your web server's existing document root tree (being careful to keep main phorkie folder outside the document root for security purposes) and ensure you set the baseurl config option appropriately. You must also set the RewriteBase in the .htaccess file or adjust the nginx configuration accordingly.

  6. Open http://yourhost/setup in your web browser to see if everything is working fine.

  7. Go to http://yourhost/

  8. If you like phorkie, send a mail to


phorkie stands on the shoulders of giants.

It requires the following programs to be installed on your machine:

  • Git v1.7.5 or later
  • PHP v5.3.0 or later
    • optionally the mbstring extension
  • PEAR v1.9.2 or later
$ pear install versioncontrol_git-alpha
$ pear install services_libravatar-alpha
$ pear install http_request2
$ pear install pager
$ pear install date_humandiff-alpha
$ pear install openid-alpha

$ pear channel-discover
$ pear install twig/Twig

$ pear channel-discover
$ pear install geshi/geshi

$ pear channel-discover
$ pear install zz/mime_type_plaindetect-alpha

$ pear channel-discover
$ pear install michelf/Markdown

$ pear channel-discover
$ pear install pear2/pear2_services_linkback-alpha

You can use composer to install all dependencies automatically:

$ composer install

Note that the .phar package already contains all dependencies.


Make git repositories clonable


By default, the pastes are clonable via http as long as the repos/git/ directory is within the www/ directory.

No further setup needed.


You may use git-daemon to provide public git:// clone urls. Install the git-daemon-run package on Debian/Ubuntu.

Make the repositories available by symlinking the paste repository directory ($GLOBALS['phorkie']['cfg']['repos'] setting) into /var/cache/git, e.g.:

$ ln -s /home/user/www/paste/repos/git /var/cache/git/paste

Edit your config.php and set the $GLOBALS['phorkie']['cfg']['git']['public'] setting to git://$yourhostname/git/paste/. The rest will be appended automatically.

You're on your own to setup writable repositories.

Protect your site with OpenID

You have the option of enabling OpenID authentication to help secure your pastes on phorkie. Set the $GLOBALS['phorkie']['auth'] values in the data/config.php file as desired.

There are two different types of security you can apply. First, you can restrict to one of three securityLevels:

  • completely open (0)
  • protection of write-enabled functions such as add, edit, etc. (1)
  • full site protection (2)

Additionally, you can restrict your site to listedUsersOnly. You will need to add the individual OpenID urls to the $GLOBALS['phorkie']['auth']['users'] variable.

Get information about paste editors

Phorkie stores the user's OpenID or IP address (when not logged in) when a paste is edited. It is possible to get this information for each single commit:

// IP / OpenID for the latest commit
$ git notes --ref=identity show

// show IP / OpenID for a given commit
$ git notes --ref=identity show 29f82a

Notifications via webhooks

Depending on how you use phorkie, it might be nice to notify some other service when pastes are added or updated. Phorkie contains a simply mechanism to post data to a given URL which you can then use as needed.

The data are json-encoded POSTed to the URLs contained in the $GLOBALS['phorkie']['cfg']['webhooks'] setting array, with a MIME type of application/vnd.phorkie.webhook+json:

    'event': 'create',
    'author': {
        'email': 'anonymous@phorkie',
    'repository': {
        'name': 'webhooktest',
        'url': '',
        'description': 'webhooktest',
        'owner': {
            'name': 'Anonymous',
            'email': 'anonymous@phorkie',

The event may be create, edit or delete.

Technical details


Index page.
Display page for paste
Edit the paste
Edit a single file of the paste
JavaScript code that embeds the whole paste in a HTML page
JavaScript code that embeds a single file in a HTML page
Display raw file contents
Run a tool on the given file
Show specific revision of the paste
Delete the paste
Show DOAP document for paste
Create a fork of the paste
Search for term, with optional page
List all pastes, with optional page
Fork a remote URL
Show help page
Shows form for new paste
Login page for protecting site
Check if everything is setup correctly and all dependencies are installed
Edit logged-in user information

Internal directory layout

    1/ - work directory for paste #1
    2/ - work directory for paste #2
    1.git/ - git repository for paste #1
      description - Description for the repository
    2.git/ - git repository for paste #2

nginx rewrites

If you use nginx, place the following lines into your server block:

if (!-e $request_uri) {
  rewrite ^/([0-9]+)$ /display.php?id=$1;
  rewrite ^/([0-9]+)/delete$ /delete.php?id=$1;
  rewrite ^/([0-9]+)/delete/confirm$ /delete.php?id=$1&confirm=1;
  rewrite ^/([0-9]+)/doap$ /doap.php?id=$1;
  rewrite ^/([0-9]+)/edit$ /edit.php?id=$1;
  rewrite ^/([0-9]+)/edit/(.+)$ /edit.php?id=$1&file=$2;
  rewrite ^/([0-9]+)/embed$ /embed.php?id=$1;
  rewrite ^/([0-9]+)/embed/(.+)$ /embed.php?id=$1&file=$2;
  rewrite ^/([0-9]+)/fork$ /fork.php?id=$1;
  rewrite ^/([0-9]+)/raw/(.+)$ /raw.php?id=$1&file=$2;
  rewrite ^/([0-9]+)/rev/(.+)$ /revision.php?id=$1&rev=$2;
  rewrite ^/([0-9]+)/rev-raw/(.+)/(.+)$ /raw.php?id=$1&rev=$2&file=$3;
  rewrite ^/([0-9]+)/tool/([^/]+)/(.+)$ /tool.php?id=$1&tool=$2&file=$3;

  rewrite ^/fork-remote$ /fork-remote.php;
  rewrite ^/help$ /help.php;
  rewrite ^/new$ /new.php;

  rewrite ^/feed/new$ /feed-new.php;
  rewrite ^/feed/updated$ /feed-updated.php;

  rewrite ^/list$ /list.php;
  rewrite ^/list/([0-9]+)$ /list.php?page=$1;

  rewrite ^/search$ /search.php;
  rewrite ^/search/([0-9]+)$ /search.php?page=$1;

  rewrite ^/login$ /login.php;
  rewrite ^/setup$ /setup.php;
  rewrite ^/user$ /user.php;

Lighttpd rewrites

url.rewrite-once += (
    "^/([0-9]+)$" => "/display.php?id=$1",
    "^/([0-9]+)/delete$" => "/delete.php?id=$1",
    "^/([0-9]+)/delete/confirm" => "/delete.php?&id=$1&confirm=1",
    "^/([0-9]+)/doap$" => "/doap.php?id=$1",
    "^/([0-9]+)/edit$" => "/edit.php?id=$1",
    "^/([0-9]+)/edit/(.+)" => "/edit.php?id=$1&file=$2",
    "^/([0-9]+)/embed$" => "/embed.php?id=$1",
    "^/([0-9]+)/embed/(.+)$" => "/embed.php?id=$1",
    "^/([0-9]+)/fork$" => "/fork.php?id=$1",
    "^/([0-9]+)/raw/(.+)$" => "/raw.php?id=$1&file=$2",
    "^/([0-9]+)/rev/(.+)$" => "/revision.php?id=$1&rev=$2",
    "^/([0-9]+)/rev-raw/(.+)/(.+)$" => "/raw.php?id=$1&rev=$2&file=$3",
    "^/([0-9]+)/tool/([^/]+)/(.+)$" => "/tool.php?id=$1&tool=$2&file=$3",

    "^/fork-remote$" => "/fork-remote.php",
    "^/help$" => "/help.php",
    "^/new$" => "/new.php",

    "^/feed/new$" => "/feed-new.php",
    "^/feed/updated$" => "/feed-updated.php",

    "^/list$" => "/list.php",
    "^/list/([0-9]+)$" => "/list.php?page=$1",

    "^/search$" => "/search.php",
    "^/search/([0-9]+)$" => "/search.php?page=$1",

    "^/login$" => "/login.php",
    "^/setup$" => "/setup.php",
    "^/user$" => "/user.php"


Releasing a new version

  1. Update ChangeLog, NEWS.rst, build.xml and README.rst.

  2. Update local dependencies:

    $ phing collectdeps
  3. Build .tar.bz2 and .phar release files with:

    $ phing zip
    $ phing phar
  4. Test.

  5. Tag the release in git

  6. Run the script to update the homepage

    $ cd /home/cweiske/Dev/html/ $ ./scripts/

File: phorkie.htm | last update: 2023-04-06 23:45:02 Valid XHTML Valid CSS