Public Repository

Last pushed: 22 days ago
Short Description
Picapport container based on ubuntu-minimal
Full Description

NEWS

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.

DESCRIPTION

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.

PREPARATIONS

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"

STARTING

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.

USING

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.

STOPPING/RESUMING

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

ATTENTION

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
Owner
fionnb

Comments (3)
researchiteng
7 months ago

Hi,
thanks for creating this image.
Please note:

  • port is back to 80, you may want to update documentation
  • please expose the language as a variable, in the pa-start.sh java options, something similar to this:
    -Duser.language=${LANG:-de}
  • kindly share the Dockerfile and pa-start.sh project on github to propose fixes there.
fionnb
a year ago

dcraw and libjpeg-progs are included in all images

lanwin
a year ago

Dose this container has the requirements for the raw plugin baked in?

apt-get install dcraw
apt-get install libjpeg-progs