Gallery
Gallery Overrides
All settings in the table below can have a gallery specific override by appending the gallery name to the end of the key. For example if the environment variable REQUIRE_REVIEW_PROPOSAL is specified it will override the value specified using the REQUIRE_REVIEW environment variable.
| Name | Value |
|---|---|
| TITLE | WeddingShare |
| LOGO | https://someurl/someimage.png |
| GALLERY_BANNER_IMAGE | (optional) |
| GALLERY_QUOTE | (optional) |
| GALLERY_SECRET_KEY | (optional) |
| GALLERY_COLUMNS | 4 (1, 2, 3, 4, 6, 12) |
| GALLERY_ITEMS_PER_PAGE | 50 |
| GALLERY_FULL_WIDTH | false |
| GALLERY_RETAIN_REJECTED_ITEMS | false |
| GALLERY_UPLOAD | false |
| GALLERY_DOWNLOAD | false |
| GALLERY_REQUIRE_REVIEW | true |
| GALLERY_REVIEW_COUNTER | true |
| GALLERY_PREVENT_DUPLICATES | true |
| GALLERY_QR_CODE_ENABLED | true |
| GALLERY_QR_CODE_DEFAULT_VIEW | (optional) |
| GALLERY_QR_CODE_DEFAULT_SORT | (optional) |
| GALLERY_IDLE_REFRESH_MINS | 5 (0 = disable) |
| GALLERY_MAX_SIZE_MB | 1024 |
| GALLERY_MAX_FILE_SIZE_MB | 10 |
| GALLERY_DEFAULT_VIEW | 0 (Default), 1 (Presentation), 2 (Slideshow) |
| GALLERY_UPLOAD_PERIOD | "2025-01-29 23:59" or "2025-01-01 00:00 / 2025-01-03 23:59" or "2025-01-01 00:00 / 2025-01-01 23:59, 2025-01-03 00:00 / 2025-01-03 23:59" |
| GALLERY_ALLOWED_FILE_TYPES | .jpg,.jpeg,.png,.mp4,.mov |
Media Formats
Not all image formats are supported in browsers so although you may be able to add them via the ALLOWED_FILE_TYPES environment variable they may not be supported. One such format is Apples .heic format. It is specific to Apple devices and due to its licensing, a lot of browsers have not implemented it.
Custom Image Resources
For any environment variable that accepts an image resource you have 2 options:
Option 1 - (Web Resource)
You can use a Url making sure to only use Urls that link directly to external resources.
The Url must adhere to the following rules:
- Hosted externally and publicly accessible.
- Not originate from the WeddingShare container. (It won't be available at boot time when the container tries to pull it locally)
- Contain a file extension. E.g., https://some.domain.com/some_random_path/my_image.png
Option 2 - (Local Resource)
You can use locally stored resources using volume mappings.
First add an additional mapping:
- /var/lib/docker/volumes/WeddingShare-CustomResources/_data:/app/wwwroot/images/custom_resources
Then link directly to the image:
GALLERY_BANNER_IMAGE="/images/custom_resources/my_image.png"