Skip to content
Simple file uploading and sharing
PHP JavaScript CSS Makefile SQLPL
Branch: master
Clone or download

Latest commit

ProfessorDey Fix cleancss binary dependancies and URL rebasing (#96)
* Fix CSS URL Rebasing Issues and Update Command Syntax

I found that the syntax used for cleancss is no longer accurate as url rebasing defaults to on in the latest version of cleancss (4.3.0).
Following the -h feedback it appears adding --skip-rebase fixes this step. I also exchanged the piped stout with the dedicated --output option that is now available.

* Update Dependancies to include cleancss binary

It appears that the node_modules/.bin/cleancss binary is no longer supplied with the clean-css package and is now contained within the separate clean-css-cli package instead, thus the relevant package has been added to the dev dependencies.
Latest commit b84cd24 May 20, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
confs Introduce configuration examples Jun 18, 2016
moe @ 689342f Update submodules Jul 11, 2016
static Delete redundent readme Jan 21, 2017
templates In tools page update ShareX links Nov 12, 2016
.gitignore doh. Jan 4, 2017
.gitmodules Merge php submodule into pomf, delete expiry. Jan 4, 2017
.mailmap Add Austin Gillmann <> to the mailmap Jun 20, 2016
.travis.yml Significant Makefile improvements (#21) Jun 22, 2016
COPYING.CC-BY-3.0 UploadException: Correct license header to CC BY 3.0+ Jun 19, 2016
LICENSE Update licenses Jan 4, 2017
Makefile Fix cleancss binary dependancies and URL rebasing (#96) May 20, 2020 update readme with new demo May 22, 2019
dist.json Fixed emails Dec 4, 2016
mysql_schema.sql Remove all deprecation notices Jul 5, 2016
package.json Fix cleancss binary dependancies and URL rebasing (#96) May 20, 2020
sqlite_schema.sql Added instructions and schema to use or migrate to SQLite (#17) Jun 22, 2016


Build Status Dependency Status devDependency Status MIT licensed Documentation Status

Pomf is a simple file uploading and sharing platform.


  • One click uploading, no registration required
  • A minimal, modern web interface
  • Drag & drop supported
  • Upload API with multiple response choices
    • JSON
    • HTML
    • Text
    • CSV
  • Supports ShareX and other screenshot tools


See the real world example at


Original development environment is Nginx + PHP5.5 + MySQL, but is confirmed to work with Apache 2.4 and newer PHP versions. Should work with any other PDO-compatible database.


For the purposes of this guide, we won't cover setting up Nginx, PHP, MySQL, Node, or NPM. So we'll just assume you already have them all running well.


First you must get a copy of the pomf code. To do so, clone this git repo. You will need to recursively clone the repo to get the required PHP submodule, and the optional user panel submodule.

git clone --recursive

If you don't want either of the submodules run the following command,

git clone

Assuming you already have Node and NPM working, compilation is easy. If you would like any additional submodules, or to exclude the default PHP submodule, use the MODULES="..." variable.

Run the following commands to do so.

cd pomf/
# alternatively
make MODULES="" # compile no submodules; exclude the default php backend module
make MODULES="php moe" # compile the php and moe submodules
make install


make install DESTDIR=/desired/path/for/site

After this, the pomf site is now compressed and set up inside dist/, or, if specified, DESTDIR.


Front-end related settings, such as the name of the site, and maximum allowable file size, are found in dist.json. Changes made here will only take effect after rebuilding the site pages. This may be done by running make from the root of the site directory.

Back-end related settings, such as database configuration, and path for uploaded files, are found in static/php/includes/ Changes made here take effect immediately.

If you intend to allow uploading files larger than 2 MB, you may also need to increase POST size limits in php.ini and webserver configuration. For PHP, modify upload_max_filesize and post_max_size values. The configuration option for nginx webserver is client_max_body_size.

Example nginx configs can be found in confs/.

Using SQLite as DB engine

We need to create the SQLite database before it may be used by pomf. Fortunately, this is incredibly simple.

First create a directory for the database, e.g. mkdir /var/db/pomf.
Then, create a new SQLite database from the schema, e.g. sqlite3 /var/db/pomf/pomf.sq3 -init /home/pomf/sqlite_schema.sql. Then, finally, ensure the permissions are correct, e.g.

chown nginx:nginx /var/db/pomf
chmod 0750 /var/db/pomf
chmod 0640 /var/db/pomf/pomf.sq3

Finally, edit php/includes/ to indicate this is the database engine you would like to use. Make the changes outlined below

define('POMF_DB_CONN', '[stuff]'); ---> define('POMF_DB_CONN', 'sqlite:/var/db/pomf/pomf.sq3');
define('POMF_DB_USER', '[stuff]'); ---> define('POMF_DB_USER', null);
define('POMF_DB_PASS', '[stuff]'); ---> define('POMF_DB_PASS', null);

NOTE: The directory where the SQLite database is stored, must be writable by the web server user


If you are running Apache and want to compress your output when serving files, add to your .htaccess file:

AddOutputFilterByType DEFLATE text/html text/plain text/css application/javascript application/x-javascript application/json

Remember to enable deflate_module and filter_module modules in your Apache configuration file.

Migrating from MySQL to SQLite

, Compared to SQLite, MySQL is relatively complicated to administer, brings in many unneeded dependencies, and consumes more resources. Additonally, as a network service, poorly configured installations have the potential to pose a security risk.

For these reasons, you may wish to use SQLite rather than MySQL.

Fortunately, it is incredibly simple to migrate your database. This may be done on a live server, if you desire, and requires zero downtime.

The process described below involves running these commands on a live server. Nothing done here affects your main site, until running the very last command, which is done after verifying there are no issues.

No changes described here are destructive, and are easily reverted. They only have the potential to cause uploading to fail gracefully, and will not affect downloading.

Run the following commands as root, to dump your database, and make a SQLite database with the contents.

mkdir /var/db/pomf
wget -O /tmp/m2s
mysqldump -u OLD_DB_USER -p OLD_DB_PASS pomf | sh /tmp/m2s | sqlite3 /var/db/pomf/sq3
rm /tmp/m2s
chown -R nginx:nginx /var/db/pomf #replace user as appropriate
chmod 0750 /var/db/pomf && chmod 0640 /var/db/pomf/sq3

Edit the file php/includes/, in your source directory, making the changes outlined below. Note, changing the second two lines is optional, as they are simply ignored when using SQLite.

define('POMF_DB_CONN', '[stuff]'); ---> define('POMF_DB_CONN', 'sqlite:/var/db/pomf/pomf.sq3');
define('POMF_DB_USER', '[stuff]'); ---> define('POMF_DB_USER', null);
define('POMF_DB_PASS', '[stuff]'); ---> define('POMF_DB_PASS', null);

Then, run make DESTDIR=/path/to/main_site/testing_dir (note the testing_dir component) to rebuild the website, and copy it into place, in a new testing subdirectory.

Now, navigate to this subdirectory in your web browser, e.g., and verify that uploading works fine. If so, excellent! You may rerun make DESTDIR=/path/to/main_site to update your main site.

All done! You may disable or uninstall MySQL if you wish.

Getting help

The Pomf community gathers on IRC. You can also email the maintainer for help.

  • IRC (users): #pomfret on Rizon (


We'd really like if you can take some time to make sure your coding style is consistent with the project. Pomf follows PHP PSR-2 and Airbnb JavaScript (ES5) (airbnb/legacy) coding style guides. We use ESLint and PHPCS tools to enforce these standards.

You can also help by sending us feature requests or writing documentation and tests.



Pomf was created by Eric Johansson and Peter Lejeck for The software is currently maintained by the community.


Pomf is free software, and is released under the terms of the Expat license. See LICENSE.

You can’t perform that action at this time.