Configuration parameters may be specified in this file, or as environment variables. Settings here will be overridden by environment variables in docker-compose.yml. This an example configuration file with just the essential settings.
# Example configuration for PicInch Gallery server. # - Edit and rename to configuration.yml # - Take care to keep indentation unchanged when editing. Do not use tabs. db-password: <server password> # The following is needed for certificate registration with Let's Encrypt domains: - our-domain.com - www.our-domain.com # Address to be notified of problems with certificates certificate-email: email@example.com # A random 32 character key used to encrypt users session data # For example, start with this one and change a lot of the individual characters. session-secret: Hk4TEiDgq8JaCNR?WaPeWBf4QQYNUjMR # Administrator, to be added to the database admin-name: firstname.lastname@example.org admin-password: <your-password>
Set the following items as needed. Default values are as shown.
A database connection is requested with DSN
db-user:db-password@db-source?parseTime=true . A MariaDB or MySQL database is required.
domains List of domains for which Let’s Encrypt certificates will be requested on first access.
" - "as shown in the example above.
This is intended for testing and is not recommended for production.
certificate-email Address given to Let’s Encrypt, for notification of problems with certificates.
session-secret A random 32 character key used to encrypt users session data.
Specifies the username and password for an PicInch administrator if the username does not exist in the database. These items may be removed after setup if desired.
admin-name E.g. email@example.com.
Photos uploaded are resized to fit these dimensions.
1600 stored image width
1200 stored image height
278 thumbnail width
208 thumbnail height
32 maximum image or video upload, in megabytes
12 highlights shown on home page, and on user’s page
32 total slides highlights slideshow
16 highlights available for parent website
16 slideshows shown on home page
2 highlights shown on home page
50 slides shown in a slideshow
2 club slideshows on home page
1 public slideshows on home page
fbclid ignored query names in URL. Other queries trigger an IP ban.
false apply IP ban to requests for missing files.
geo-block ` ` blocked countries, specified by ISO 3166-1 alpha-2 codes. For example,
8h time limit to save a slideshow update, after uploading images. Units m(inutes) or h(ours).
1h refresh interval for topic thumbnails. Units m(inutes) or h(ours).
1 anonymisation of user IDs: 0 = daily, 1 = immediate.
Options to change the operation of the website.
home-switch switches the home page to a specified template, for example,
disabled to show
disabled.page.tmpl when the website is offline.
misc path in URL for miscellaneous files, as in
3s time within video for snapshot thumbnail. Units s(econds), -ve for no snapshots.
video-types ` ` acceptable video file types, such as
:8000 site HTTP address
:4000 site HTTPS address