Public Repository

Last pushed: 2 months ago
Short Description
Picapport container based on ubuntu-minimal
Full Description


The current version of picapport stable and latest are now running picapport as UID 1000. The default port has changed from 80 to 8888, so if you have used the very first version of the picapport container you might have to change ownership of files in data and uploads from root to uid1000 and the port in the properties file to 8888.


This is a fairly generic picapport headless application container with raw support based on a minimal ubuntu.

The application base directory inside the container is /opt/picapport

Static data is exported to the following volumes:

  • /opt/picapport/photos
    This is where your photos are expected to be. picapport should recognize existing photos automatically. If you upload data to picapport, an "uploads" directory will be created within this directory.

  • /opt/picapport/data
    This is where all picapport working data and config resides. If there is no config, a very basic one will be created for you inside this directory on the first start of the container.

The service is running as uid 1000, so your external files in "photos" should belong to this or be readable by this uid.


All lines beginning with "#>" are meant to be entered (without the "#>"!) on a linux Terminal prompt.

  • To use the latest stable version of picapport:
    #> VERSION="stable"

  • To use the latest development beta:
    #> VERSION="latest"

  • Define a directory where your photos are (or where you want picapport to store its photos).
    #> PHOTOS="/home/$USER/Pictures/"
    Enter this to make sure the photo directory exists!
    #> [ -d "$PHOTOS" ] || mkdir -p "$PHOTOS"

  • Define a directory where picapport can store its configs and database. For this you may also use a previously created .picapport directory, just make sure that it is not used by two application instances at the same time!)
    #> PADATA="/home/$USER/.picapport"
    Enter this to make sure the data directory exists!
    #> [ -d "$PADATA" ] || mkdir -p "$PADATA"


The following command must be pasted in the Terminal on one line:
#> docker run -d -p 8080:8888 -v "$PHOTOS":/opt/picapport/photos -v "$PADATA":/opt/picapport/data --name picapport fionnb/picapport:$VERSION; docker logs -f picapport

This will download an ubuntu-minimal layer and on top of that the picapport application layer. Download may take several minutes, but only on the first start.


The first start of picapport can take up to 30-60 seconds to initialize all databases. Also, depending on how many pictures the application finds, it may take some time for them to appear in the GUI. Please be patient and have a look at the log output until a log line appears that says:
INFO:oejs.Server:main: Started.
After that, point your browser at "http://localhost:8080/" to access the web GUI of picapport.


You may stop and start your picapport application at any time by issuing the following commands:
#> docker stop picapport
#> docker start picapport

To inspect the output of the picapport application (e.g. for errors) use:
#> docker logs [-f] picapport


Before you update your picapport version or pull a new release, please make sure that you have stopped (and possibly removed) any previous version that you had!
Running TWO picapport instances on the same data directory at the same time is NOT a good idea!

Docker Pull Command