Wishlist logo

Wishlist

Self-hosted wishlist app to share with friends and family

Alternative to: amazon wish list, elfster

Wishlist screenshotWishlist screenshot

Wishlist is a self-hosted application for creating and sharing gift wish lists with friends and family. Users add items they'd like to receive, and others can view the list and claim items to avoid duplicate gifts, all without spoiling the surprise for the list owner. It runs as a single container backed by SQLite.

Wishlist Docker Compose example

Self-host Wishlist on your own server, homelab, or VPS starting from this Docker Compose example. It runs Wishlist in Docker containers using the official ghcr.io/cmintey/wishlist:latest image, with persistent volumes and automatic restarts preconfigured. Review the environment variables and adjust them to your setup, save the file as compose.yml (or docker-compose.yml), and start the stack with docker compose up -d.

services:
  wishlist:
    image: ghcr.io/cmintey/wishlist:latest
    volumes:
      - uploads:/usr/src/app/uploads
      - data:/usr/src/app/data
    restart: unless-stopped
    environment:
      # The URL your users will connect to, e.g. https://wishlist.example.com. If this is an IP address it must include the exposed port.
      ORIGIN: "changeme"
      # Hours until signup and password reset tokens expire.
      TOKEN_TIME: "72"
      # Global default currency (ISO 4217 code). Can still be changed per item.
      DEFAULT_CURRENCY: "USD"
      # Maximum uploadable image size, in bytes (default 5MB).
      MAX_IMAGE_SIZE: "5000000"

volumes:
  uploads:
  data:

Values set to changeme are required — replace them with your own values before starting Wishlist.

Prefer a managed setup? WinterFlow installs, configures, and updates Wishlist for you using this same Docker Compose configuration.