Installing and Running
The easiest way to run it is with Docker Compose using the pre-built image following these steps.
Installing Docker and Docker Compose
You'll first need to install Docker and Docker Compose if you don't already have them.
Installing these on recent versions of Debian, Ubuntu or Raspberry Pi OS can be done with the following commands and then logging out and back in.
sudo apt update sudo apt install docker.io docker-compose sudo usermod -aG docker $USER
usermod is not available on your system then you can do it the manual way and edit
/etc/group adding your username to end of the line that starts with
Finally check Docker is running and you have the right permissions by running the following. You should see some table headings beginning with
CONTAINER ID but you won't have any actual containers running yet.
If you still don't have permission, you may need to restart the whole machine.
Create a new directory to run inside.
mkdir photonix cd photonix
Download the example Docker Compose file. Currently there is a separate
docker-compose.yml file for our experimental ARM/Raspberry Pi build.
If you are on an x86/amd64-based machine get the relevant example file here.
curl https://raw.githubusercontent.com/damianmoore/photonix/master/docker/docker-compose.example.yml > docker-compose.yml
If you are on an ARM/Raspberry Pi-based machine you can use this file but it will soon change.
Make volume directories for data stored outside the container.
mkdir -p data/photos
Bring up Docker Compose which will pull and run the required Docker images.
A few seconds after starting you should be able to go to http://localhost:8888/ in your browser.
You'll need to create a username, password and library. Right now this needs to be done on the command-line so run this in a new terminal window. Replace
USERNAME with your own username.
docker-compose run photonix python photonix/manage.py createsuperuser --username USERNAME --email firstname.lastname@example.org docker-compose run photonix python photonix/manage.py create_library USERNAME "My Library"
You can move some photos into the folder
data/photos and they should get detected and imported immediately. Once you have finished trying out the system you can edit the volume in the
docker-compose.yml file where it says
./data/photos to mount wherever you usually keep photos. System database, thumbnails and other cache data is stored separately from the photos so shouldn't pollute the area. You are responsible for keeping your own backups in case of error.