2021-08-05 16:49:30 +00:00
|
|
|
PhotoPrism for Cloud Servers running Ubuntu 20.04 LTS (Focal Fossa)
|
|
|
|
|
===================================================================
|
|
|
|
|
|
2021-08-05 16:54:22 +00:00
|
|
|
Run this script as root to install PhotoPrism on a cloud server e.g. at DigitalOcean:
|
2021-08-05 16:49:30 +00:00
|
|
|
|
2021-08-05 20:41:53 +00:00
|
|
|
bash <(curl -s https://dl.photoprism.org/docker/cloud/setup.sh)
|
2021-08-05 16:49:30 +00:00
|
|
|
|
2021-08-05 16:55:58 +00:00
|
|
|
This may take a while to complete, depending on the performance of your
|
|
|
|
|
server and its internet connection.
|
2021-08-05 16:54:22 +00:00
|
|
|
|
2021-08-05 16:55:58 +00:00
|
|
|
When done - and you see no errors - please open
|
2021-08-05 16:49:30 +00:00
|
|
|
|
2021-08-05 19:35:36 +00:00
|
|
|
https://<YOUR SERVER IP>/
|
2021-08-05 16:49:30 +00:00
|
|
|
|
2021-08-05 19:35:36 +00:00
|
|
|
in a Web browser and log in using the initial admin password shown
|
2021-08-06 07:11:07 +00:00
|
|
|
by the script. You may also see the initial password by running
|
2021-08-05 16:54:22 +00:00
|
|
|
|
2021-08-05 19:35:36 +00:00
|
|
|
cat /root/.initial-password.txt
|
2021-08-05 16:49:30 +00:00
|
|
|
|
2021-08-06 07:11:07 +00:00
|
|
|
as root on your server. To open a terminal:
|
|
|
|
|
|
|
|
|
|
ssh root@<YOUR SERVER IP>
|
2021-08-05 19:35:36 +00:00
|
|
|
|
2021-08-05 20:41:53 +00:00
|
|
|
Data and all config files related to PhotoPrism can be found in
|
|
|
|
|
|
|
|
|
|
/opt/photoprism
|
|
|
|
|
|
2021-08-05 19:35:36 +00:00
|
|
|
The main docker-compose config file for changing config options is
|
|
|
|
|
|
2021-08-05 20:41:53 +00:00
|
|
|
/opt/photoprism/docker-compose.yml
|
2021-08-05 19:35:36 +00:00
|
|
|
|
|
|
|
|
The server is running as "photoprism" (UID 1000) by default. There's no need
|
|
|
|
|
to change defaults unless you experience conflicts with other services running
|
|
|
|
|
on the same server. For example, you may need to disable the Traefik reverse
|
|
|
|
|
proxy as the ports 80 and 443 can only be used by a single web server / proxy.
|
|
|
|
|
|
2021-08-05 20:41:53 +00:00
|
|
|
Configuring multiple apps on the same server is beyond the scope of this base
|
|
|
|
|
config and for advanced users only.
|
2021-08-05 16:49:30 +00:00
|
|
|
|
|
|
|
|
## System Requirements ##
|
|
|
|
|
|
|
|
|
|
We recommend hosting PhotoPrism on a server with at least 2 cores and
|
|
|
|
|
4 GB of memory. Beyond these minimum requirements, the amount of RAM
|
|
|
|
|
should match the number of cores. Indexing large photo and video
|
|
|
|
|
collections significantly benefits from fast, local SSD storage.
|
|
|
|
|
|
2021-08-06 07:23:01 +00:00
|
|
|
RAW file conversion and automatic image classification using TensorFlow
|
2021-08-08 09:24:50 +00:00
|
|
|
will be disabled on servers with less than 2 GB of physical memory.
|
|
|
|
|
|
|
|
|
|
## Using Let's Encrypt as HTTPS certificate resolver ##
|
|
|
|
|
|
|
|
|
|
By default, a self-signed certificate will be used for HTTPS connections.
|
|
|
|
|
Browsers are going to show a security warning because of that. Depending
|
|
|
|
|
on your settings, they may also refuse connecting at all.
|
|
|
|
|
|
|
|
|
|
To get an official, free HTTPS certificate from Let's Encrypt, your server
|
|
|
|
|
needs a fully qualified public domain name first, e.g. "photos.yourdomain.com".
|
|
|
|
|
You may add a static DNS entry (on DigitalOcean go to Networking > Domains),
|
|
|
|
|
or use a Dynamic DNS service of your choice.
|
|
|
|
|
|
|
|
|
|
Once your server has a public domain name, please disable the self-signed
|
|
|
|
|
certificate and enable domain based routing in docker-compose.yml and
|
|
|
|
|
traefik.yaml (see inline instructions in !! UPPERCASE !!):
|
|
|
|
|
|
|
|
|
|
ssh root@<YOUR SERVER IP>
|
|
|
|
|
nano /opt/photoprism/docker-compose.yml
|
|
|
|
|
nano /opt/photoprism/traefik.yaml
|
|
|
|
|
|
|
|
|
|
Then restart services in a terminal for the changes to take effect:
|
|
|
|
|
|
|
|
|
|
docker-compose stop
|
|
|
|
|
docker-compose up -d
|
|
|
|
|
|
|
|
|
|
To check logs for errors:
|
|
|
|
|
|
|
|
|
|
docker-compose logs -f
|
