Skip to main content


Project description


This repository provides pfioh – a server process (think of it as anonymous ftp that natively understands recursive paths) that allows for file/path push/copy.


pfioh is a service that pushes/pulls files and directories between different locations.


Installation is relatively straightforward, and we recommend using either python virtual environments or docker.

Python Virtual Environment

On Ubuntu, install the Python virtual environment creator

sudo apt install virtualenv

Then, create a directory for your virtual environments e.g.:

mkdir ~/python-envs

You might want to add to your .bashrc file these two lines:

export WORKON_HOME=~/python-envs
source /usr/local/bin/

Then you can source your .bashrc and create a new Python3 virtual environment:

source .bashrc
mkvirtualenv --python=python3 python_env

To activate or “enter” the virtual env:

workon python_env

To deactivate virtual env:


Using the fnndsc/pfioh dock

The easiest option however, is to just use the fnndsc/pfioh dock.

docker pull fnndsc/pfioh

and then run

docker run --name pfioh -v /home:/Users --rm  \
    fnndsc/pfioh                              \
    --forever --httpResponse                  \
    --storeBase=/tmp --createDirsAsNeeded


pfioh usage

For pfioh detailed information, see the pfioh wiki page.

[--ip <IP>]

The IP interface on which to listen. Defaults to current host IP.

[--port <port>]
The port on which to listen. Defaults to '5055'.

Start service and do not terminate.

Send return strings as HTTP formatted replies with content-type html.

[--storeBase <storagePath>]
A file system location in the network space accessible to ``pfioh``
that is used to unpack received files and also store results of

If specified, create dirs in the base storage as needed.

Enables token based authorization and can be configured to look for a .ini
file or an openshift secret.

[--tokenPath <tokenPath>]
Specify the absolute path to the token in the file system.
By default, this looks for the pfiohConfig.ini file in the current working directory.

If specified, use Swift as object storage.

Run internal tests.

Provide an overview help page.

Provide a synopsis help summary.

Print internal version number and exit.

[-v|--verbosity <level>]
Set the verbosity level. "0" typically means no/minimal output. Allows for
more fine tuned output control as opposed to '--quiet' that effectively
silences everything.


Start pfioh in forever mode, accessible on localhost:

pfioh                                                   \\
    --forever                                           \\
    --port 5055                                         \\
    --storeBase=/tmp                                    \\
    --httpResponse                                      \\
    --createDirsAsNeeded                                \\
    --verbosity 1                                       \\

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pfioh, version
Filename, size File type Python version Upload date Hashes
Filename, size pfioh- (20.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page