`options.yml`¶

As an alternative to configuring your instance with environment variables, it may be more convenient to use an options.yml file located in your config path, for example if PhotoPrism was installed through an app store or with the installation packages we provide.

You can specify a custom config path by adding the ConfigPath option to a ↪ defaults.yml file in the /etc/photoprism directory (requires root privileges). It is also possible to use the command flag --config-path or the environment variable PHOTOPRISM_CONFIG_PATH for this. By default, it is a subdirectory of the storage path.

If you use a third-party integration or package, you should find the exact location of the configuration files in the corresponding documentation.

Note that changes to the options.yml file require a restart to take effect and that config values changed through the web interface will also be saved to this file. We therefore recommend that you only edit it manually while your instance is stopped.

File Format¶

You can use any text editor to create or modify YAML config files. When specifying values, make sure that their data type matches the documentation, e.g. bool values must be either true or false (without quotes, unlike in docker-compose.yml files) and int values must be whole numbers, as shown in this example:

Debug: false
AdminUser: "admin"
AdminPassword: "insecure"
DatabaseUser: "photoprism"
DatabasePassword: "insecure"
DatabaseName: "photoprism"
DatabaseDriver: "mysql"
DatabaseServer: "localhost:3306"
HttpPort: 2342
SiteCaption: "AI-Powered Photos App"
SiteDescription: ""
SiteAuthor: ""
SiteUrl: "http://localhost:2342/"

To avoid ambiguity, it is recommended to enclose text strings in " (double quotes), especially if they contain spaces, a colon, or other special characters.

File and directory paths may be specified using ~ as a placeholder for the home directory of the current user, e.g. ~/Pictures. Relative paths can also be specified via ./pathname. If no explicit originals, import and/or assets path has been configured, a list of default directory paths will be searched and the first existing directory will be used for the respective path.

Global Defaults¶

Global configuration defaults, including the storage paths to be used, can optionally be specified in a ↪ defaults.yml file.

Current Values¶

Run photoprism --help in a terminal to get an overview of the command flags and environment variables available for configuration. Their current values can be displayed with the photoprism config command.

Below are the corresponding names of the config options that you can use in the options.yml and defaults.yml files, grouped by purpose.

Config Options¶

Authentication¶

Name	Type	CLI Flag
AuthMode	string	--auth-mode
Public	bool	--public
AdminUser	string	--admin-user
AdminPassword	string	--admin-password
PasswordLength	int	--password-length
PasswordResetUri	string	--password-reset-uri
RegisterUri	string	--register-uri
LoginUri	string	--login-uri
SessionMaxAge	int64	--session-maxage
SessionTimeout	int64	--session-timeout
SessionCache	int64	--session-cache

Logging¶

Name	Type	CLI Flag
LogLevel	string	--log-level
Prod	bool	--prod
Debug	bool	--debug
Trace	bool	--trace

Storage¶

Name	Type	CLI Flag
ConfigPath	string	--config-path
OriginalsPath	string	--originals-path
OriginalsLimit	int	--originals-limit
ResolutionLimit	int	--resolution-limit
UsersPath	string	--users-path
StoragePath	string	--storage-path
SidecarPath	string	--sidecar-path
BackupPath	string	--backup-path
CachePath	string	--cache-path
ImportPath	string	--import-path
ImportDest	string	--import-dest
AssetsPath	string	--assets-path
TempPath	string	--temp-path

Index Workers¶

Name	Type	CLI Flag
Workers	int	--workers
WakeupInterval	time.Duration	--wakeup-interval
AutoIndex	int	--auto-index
AutoImport	int	--auto-import

Feature Flags¶

Name	Type	CLI Flag
ReadOnly	bool	--read-only
Experimental	bool	--experimental
DisableSettings	bool	--disable-settings
DisableRestart	bool	--disable-restart
DisableBackups	bool	--disable-backups
DisableWebDAV	bool	--disable-webdav
DisablePlaces	bool	--disable-places
DisableTensorFlow	bool	--disable-tensorflow
DisableFaces	bool	--disable-faces
DisableClassification	bool	--disable-classification
DisableFFmpeg	bool	--disable-ffmpeg
DisableExifTool	bool	--disable-exiftool
DisableSips	bool	--disable-sips
DisableDarktable	bool	--disable-darktable
DisableRawTherapee	bool	--disable-rawtherapee
DisableImageMagick	bool	--disable-imagemagick
DisableHeifConvert	bool	--disable-heifconvert
DisableVectors	bool	--disable-vectors
DisableJpegXL	bool	--disable-jpegxl
DisableRaw	bool	--disable-raw
RawPresets	bool	--raw-presets
ExifBruteForce	bool	--exif-bruteforce
DetectNSFW	bool	--detect-nsfw
UploadNSFW	bool	--upload-nsfw

Customization¶

Name	Type	CLI Flag
DefaultTheme	string	--default-theme
DefaultLocale	string	--default-locale
AppName	string	--app-name
AppMode	string	--app-mode
AppIcon	string	--app-icon
AppColor	string	--app-color
LegalInfo	string	--legal-info
LegalUrl	string	--legal-url
WallpaperUri	string	--wallpaper-uri

Site Information¶

Name	Type	CLI Flag
SiteUrl	string	--site-url
SiteAuthor	string	--site-author
SiteTitle	string	--site-title
SiteCaption	string	--site-caption
SiteDescription	string	--site-description
SitePreview	string	--site-preview
CdnUrl	string	--cdn-url
CdnVideo	bool	--cdn-video
CORSOrigin	string	--cors-origin
CORSHeaders	string	--cors-headers
CORSMethods	string	--cors-methods

Web Server¶

Name	Type	CLI Flag
HttpsProxy	string	--https-proxy
HttpsProxyInsecure	bool	--https-proxy-insecure
TrustedProxies	[]string	--trusted-proxy
ProxyProtoHeaders	[]string	--proxy-proto-header
ProxyProtoHttps	[]string	--proxy-proto-https
DisableTLS	bool	--disable-tls
DefaultTLS	bool	--default-tls
TLSEmail	string	--tls-email
TLSCert	string	--tls-cert
TLSKey	string	--tls-key
HttpMode	string	--http-mode
HttpCompression	string	--http-compression
HttpCachePublic	bool	--http-cache-public
HttpCacheMaxAge	int	--http-cache-maxage
HttpVideoMaxAge	int	--http-video-maxage
HttpHost	string	--http-host
HttpPort	int	--http-port

Database Connection¶

Name	Type	CLI Flag
DatabaseDriver	string	--database-driver
DatabaseDsn	string	--database-dsn
DatabaseName	string	--database-name
DatabaseServer	string	--database-server
DatabaseUser	string	--database-user
DatabasePassword	string	--database-password
DatabaseTimeout	int	--database-timeout
DatabaseConns	int	--database-conns
DatabaseConnsIdle	int	--database-conns-idle

File Converters¶

Name	Type	CLI Flag
SipsBin	string	--sips-bin
SipsBlacklist	string	--sips-blacklist
FFmpegBin	string	--ffmpeg-bin
FFmpegEncoder	string	--ffmpeg-encoder
FFmpegSize	int	--ffmpeg-size
FFmpegBitrate	int	--ffmpeg-bitrate
FFmpegMapVideo	string	--ffmpeg-map-video
FFmpegMapAudio	string	--ffmpeg-map-audio
ExifToolBin	string	--exiftool-bin
DarktableBin	string	--darktable-bin
DarktableCachePath	string	--darktable-cache-path
DarktableConfigPath	string	--darktable-config-path
DarktableBlacklist	string	--darktable-blacklist
RawTherapeeBin	string	--rawtherapee-bin
RawTherapeeBlacklist	string	--rawtherapee-blacklist
ImageMagickBin	string	--imagemagick-bin
ImageMagickBlacklist	string	--imagemagick-blacklist
HeifConvertBin	string	--heifconvert-bin
RsvgConvertBin	string	--rsvgconvert-bin

Security Tokens¶

Name	Type	CLI Flag
DownloadToken	string	--download-token
PreviewToken	string	--preview-token

Image Quality¶

Name	Type	CLI Flag
ThumbColor	string	--thumb-color
ThumbFilter	string	--thumb-filter
ThumbSize	int	--thumb-size
ThumbSizeUncached	int	--thumb-size-uncached
ThumbUncached	bool	--thumb-uncached
JpegQuality	string	--jpeg-quality
JpegSize	int	--jpeg-size
PngSize	int	--png-size

Daemon Mode¶

If you start the server as a daemon in the background, you can additionally specify a filename for the log and the process ID:

Name	Type	CLI Flag
PIDFilename	string	--pid-filename
LogFilename	string	--log-filename
DetachServer	bool	--detach-server

options.yml¶