Thank you to everyone that supports this project. For anyone that hasn't yet I would be grateful if you would show some support by "buying me a coffee" through the link below. Weddings are expensive and all proceeds from this project will be going towards paying off my wedding bills.
- BuyMeACoffee - https://buymeacoffee.com/cirx08
WeddingShare is a very basic site with only one goal. It provides you and your guests a way to share memories of and leading up to the big day. Simply provide your guests with a link to a gallery either via a Url or even better by printing out the provided QR code and dropping it on your guests' dinner tables. Doing so will allow them to view your journey up to this point such as dress/suit shopping, viewing the venue, doing the food tasting or cake shopping, etc.
You are not limited to a single gallery. You can generate multiple galleries all with their own sharable links. At this stage galleries are a bit unsecure, meaning anyone with the link has access to view and share images so I recommend keeping your share links private. To combat strangers gaining access to your galleries you can provide a secret key during setup but be advised this is a deterrent to make guessing Urls slightly harder and not an actual security catch all.
Warning. This is open-source software (GPL-V3), and while we make a best effort to ensure releases are stable and bug-free, there are no warranties. Use at your own risk.
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.
| Name | Value | Gallery Override |
|---|---|---|
| TITLE | WeddingShare | Yes |
| LOGO | https://someurl/someimage.png | Yes |
| BASE_URL | www.wedding-share.com | No |
| LANGUAGE | en-GB | No |
| FORCE_HTTPS | false | No |
| DEFAULT_THEME | default (default, dark) | No |
| LINKS_OPEN_NEW_TAB | true | No |
| SHOW_IDENTITY_REQUEST | true | No |
| DISABLE_HOME_LINK | false | No |
| DISABLE_DARK_MODE | false | No |
| DISABLE_GUEST_GALLERY_CREATION | true | No |
| SINGLE_GALLERY_MODE | false | No |
| DEFAULT_GALLERY_VIEW | 0 (Default), 1 (Presentation), 2 (Slideshow) | No |
| ALLOWED_FILE_TYPES | .jpg,.jpeg,.png | No |
| MAX_GALLERY_SIZE_MB | 1024 | Yes |
| MAX_FILE_SIZE_MB | 10 | No |
| THUMBNAIL_SIZE | 720 | No |
| HIDE_KEY_FROM_QR_CODE | false | No |
| IDLE_GALLERY_REFRESH_MINS | 5 (0 = disable) | No |
| EMAIL_REPORT | true | No |
| REQUIRE_REVIEW | true | Yes |
| SECRET_KEY | (optional) | Yes |
| GALLERY_COLUMNS | 4 (1, 2, 3, 4, 6, 12) | Yes |
| GALLERY_QUOTE | (optional) | Yes |
| DISABLE_REVIEW_COUNTER | false | Yes |
| DISABLE_UPLOAD | false | Yes |
| DISABLE_DOWNLOAD | false | Yes |
| DISABLE_QR_CODE | false | Yes |
| FULL_WIDTH_GALLERY | false | Yes |
| RETAIN_REJECTED_ITEMS | false | Yes |
Gallery Overrides:
Gallery overrides can be added by appending the gallery name to the end of the environment variable key. For example if the DISABLE_UPLOAD key is set to true but the DISABLE_UPLOAD_PUBLIC key is also present and set to false, the default gallery behaviour will be to hide the upload section for all galleries except the "Public" gallery.
| Name | Value |
|---|---|
| SLIDESHOW_INTERVAL | 10 (seconds) |
| SLIDESHOW_FADE | 500 (milliseconds) |
| SLIDESHOW_LIMIT | (optional) |
| SLIDESHOW_INCLUDE_SHARE_SLIDE | true |
| Name | Value |
|---|---|
| ACCOUNT_ADMIN_USERNAME | admin |
| ACCOUNT_ADMIN_PASSWORD | admin |
| ACCOUNT_ADMIN_LOG_PASSWORD | true |
| ACCOUNT_SHOW_PROFILE_ICON | true |
| ACCOUNT_LOCKOUT_ATTEMPTS | 5 |
| ACCOUNT_LOCKOUT_MINS | 60 |
| Name | Value |
|---|---|
| DIRECTORY_SCANNER_INTERVAL | */30 * * * * (cron) |
| EMAIL_REPORT_INTERVAL | 0 0 * * * (cron) |
| CLEANUP_INTERVAL | 0 4 * * * (cron) |
| Name | Value |
|---|---|
| ALERTS_FAILED_LOGIN | true |
| ALERTS_ACCOUNT_LOCKOUT | true |
| ALERTS_DESTRUCTIVE_ACTION | true |
| ALERTS_PENDING_REVIEW | true |
| Name | Value |
|---|---|
| SMTP_ENABLED | false |
| SMTP_RECIPIENT | (required) |
| SMTP_HOST | (required) |
| SMTP_PORT | 587 |
| SMTP_USERNAME | (required) |
| SMTP_PASSWORD | (required) |
| SMTP_FROM | (required) |
| SMTP_DISPLAYNAME | WeddingShare |
| SMTP_USE_SSL | true |
| Name | Value |
|---|---|
| NTFY_ENABLED | false |
| NTFY_ENDPOINT | (required) |
| NTFY_TOKEN | (required) |
| NTFY_TOPIC | WeddingShare |
| NTFY_PRIORITY | 4 |
| Name | Value |
|---|---|
| GOTIFY_ENABLED | false |
| GOTIFY_ENDPOINT | (required) |
| GOTIFY_TOKEN | (required) |
| GOTIFY_PRIORITY | 4 |
docker run --name WeddingShare -h wedding-share -p 8080:5000 -v /var/lib/docker/volumes/wedding-share-config/_data:/app/config:rw -v /var/lib/docker/volumes/wedding-share-thumbnails/_data:/app/wwwroot/thumbnails:rw -v /var/lib/docker/volumes/wedding-share-uploads/_data:/app/wwwroot/uploads:rw --restart always cirx08/wedding_share:latest
services:
wedding-share:
container_name: WeddingShare
image: cirx08/wedding_share:latest
ports:
- '${HTTP_PORT:-8080}:5000/tcp'
environment:
TITLE: 'WeddingShare'
LOGO: 'Url'
GALLERY_COLUMNS: 4
ALLOWED_FILE_TYPES: '.jpg,.jpeg,.png'
MAX_FILE_SIZE_MB: 10
SECRET_KEY: 'password'
volumes:
- data-volume-config:/app/config
- data-volume-thumbnails:/app/wwwroot/thumbnails
- data-volume-uploads:/app/wwwroot/uploads
network_mode: bridge
hostname: wedding-share
restart: always
volumes:
data-volume-config:
name: WeddingShare-Config
data-volume-thumbnails:
name: WeddingShare-Thumbnails
data-volume-uploads:
name: WeddingShare-Uploads
- Documentation - https://docs.wedding-share.org
- GitHub - https://github.com/Cirx08/WeddingShare
- DockerHub - https://hub.docker.com/r/cirx08/wedding_share
- BuyMeACoffee - https://buymeacoffee.com/cirx08
