`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 compose.yaml 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
OIDCUri	string	--oidc-uri
OIDCClient	string	--oidc-client
OIDCSecret	string	--oidc-secret
OIDCScopes	string	--oidc-scopes
OIDCProvider	string	--oidc-provider
OIDCIcon	string	--oidc-icon
OIDCRedirect	bool	--oidc-redirect
OIDCRegister	bool	--oidc-register
OIDCUsername	string	--oidc-username
OIDCWebDAV	bool	--oidc-webdav
DisableOIDC	bool	--disable-oidc
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
ImportPath	string	--import-path
ImportDest	string	--import-dest
CachePath	string	--cache-path
TempPath	string	--temp-path
AssetsPath	string	--assets-path

Sidecar Files¶

Name	Type	CLI Flag
SidecarPath	string	--sidecar-path
SidecarYaml	bool	--sidecar-yaml

Backup¶

Name	Type	CLI Flag
BackupPath	string	--backup-path
BackupSchedule	string	--backup-schedule
BackupRetain	int	--backup-retain
BackupDatabase	bool	--backup-database
BackupAlbums	bool	--backup-albums

Indexing¶

Name	Type	CLI Flag
IndexWorkers	int	--index-workers
IndexSchedule	string	--index-schedule
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
DisableBackups	bool	--disable-backups
DisableRestart	bool	--disable-restart
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
DisableVips	bool	--disable-vips
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
DefaultLocale	string	--default-locale
DefaultTimezone	string	--default-timezone

Customization¶

Name	Type	CLI Flag
DefaultTheme	string	--default-theme
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 Conversion¶

Name	Type	CLI Flag
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
SipsBin	string	--sips-bin
SipsExclude	string	--sips-exclude
DarktableBin	string	--darktable-bin
DarktableCachePath	string	--darktable-cache-path
DarktableConfigPath	string	--darktable-config-path
DarktableExclude	string	--darktable-exclude
RawTherapeeBin	string	--rawtherapee-bin
RawTherapeeExclude	string	--rawtherapee-exclude
ImageMagickBin	string	--imagemagick-bin
ImageMagickExclude	string	--imagemagick-exclude
HeifConvertBin	string	--heifconvert-bin
RsvgConvertBin	string	--rsvgconvert-bin

Security Tokens¶

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

Preview Images¶

Name	Type	CLI Flag
ThumbLibrary	string	--thumb-library
ThumbColor	string	--thumb-color
ThumbFilter	string	--thumb-filter
ThumbSize	int	--thumb-size
ThumbSizeUncached	int	--thumb-size-uncached
ThumbUncached	bool	--thumb-uncached

Image Quality¶

Name	Type	CLI Flag
JpegQuality	int	--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