Guestlist

Minimal guest list app with admin/maintainer login, guest access code and MongoDB.

Preview

Quick Start With Docker Compose

docker compose up -d --build

Open the app:

http://localhost:8080

On first startup:

http://localhost:8080/setup

Create the first admin user and the guest access code there.

Useful Commands

Show logs:

docker compose logs -f app

Stop:

docker compose down

Stop and delete MongoDB data:

docker compose down -v

Configuration

The app is configured in the container through environment variables:

Mongo__ConnectionString: mongodb://mongo:27017
Mongo__DatabaseName: guestlist
ASPNETCORE_URLS: http://+:8080

MongoDB data is stored in the Compose volume mongo_data.

When setup is reset in the admin area, the app first copies the current database into a new backup database using the pattern guestlist_backup_<timestamp>. After that, the active database is recreated and setup is open again. The latest database backup can be restored from the setup page.