MomentGrid - Self-hosted event photo Platform

MomentGrid — Self-hosted event photos with private selfie search

MomentGrid is a complete platform for event photographers. Publish galleries by QR, let guests find themselves with a selfie, and run the whole service as your own multi-photographer SaaS with editable plans, subscriptions and payments. Face recognition runs in one Node process on your server, with no Python, Redis or paid recognition API.

Live demo: demo.momentgrid.io/white-label — one-click access as photographer or administrator.

What makes MomentGrid different

• Private selfie search on your server. YuNet face detection and SFace embeddings run through onnxruntime-node. No external face-recognition service receives guest images.
• True white label. Change the platform name, logo, accent color, contact email, landing content, FAQ, Terms of Service and Privacy Policy from Admin.
• Multi-photographer SaaS. Editable plans, subscriptions, storage limits, event and photo quotas, feature flags and a business dashboard are included.
• Buyer-configurable payments. Stripe, PayPal and manual bank-transfer workflows are configured with the buyer's own credentials. Supported currencies include USD, EUR, GBP, CAD, AUD, NZD and MXN.
• Simple deployment. Run the Docker Compose stack on a supported Ubuntu 22.04 or 24.04 VPS, then finish setup through the web installer.
• English and Spanish UI. Interface strings, errors and emails are included in both languages.
• Guest privacy controls. Selfies are processed in memory and are not stored. Search results expire automatically after 30 minutes, and guests can delete their search data immediately.
• Mobile-first galleries. Responsive masonry layout, live camera capture, lightbox gestures, PIN protection, QR sharing and ZIP downloads.

Photographer features

• Drag-and-drop photo upload and multipart ZIP extraction
• Automatic 480 px thumbnails and 2048 px web versions
• Optional watermark applied at delivery
• Configurable selfie-search similarity threshold
• PIN-protected public galleries
• Downloadable gallery QR codes
• Guest selection and bulk ZIP download
• Draft, Live and Archived event states
• Local disk or S3-compatible object storage
• Visit, selfie-search and download counters
• SMTP support for verification and account emails

Included

• Full TypeScript source code: NestJS 11 and Angular 21
• Docker Compose configuration with PostgreSQL 15
• Web installation wizard
• English Buyer Guide and Deployment Guide
• Prisma schema and database migrations
• Third-party license summary

Server requirements

• Minimum: 2 GB RAM and 1 vCPU
• Recommended: 4 GB RAM and 2 vCPU
• Ubuntu 22.04 or 24.04 with Docker (recommended), or the documented direct setup with Node.js 22+ and PostgreSQL 15+
• HTTPS in production for browser camera access

Browser support

Latest two versions of Chrome, Safari, Firefox and Edge. The guest gallery and selfie flow support current iOS Safari and Android Chrome.

Support

12 months of support through the item's Codester support section. Support covers reproducible defects and clarification of documented features. It does not include installation, server configuration, third-party services, customizations or additional development. Support requests are answered within two business days.

If a reproducible product defect prevents MomentGrid from working as advertised in the supported environment, contact the author through Codester support first. Refund requests are handled under Codester's official refund policy.

Frequently asked questions

Do I need Python or a paid face-recognition account? No. Detection and embeddings run inside the Node process via onnxruntime-node.

Can I use shared hosting or cPanel? No. The supported environment is an Ubuntu 22.04 or 24.04 VPS with Docker and at least 2 GB of RAM. Shared hosting and cPanel-only hosting will not work. Other operating systems or hosting configurations may work, but are not part of the advertised supported environment.

Are guest selfies stored? No. Selfies are analyzed in memory. Search-result records expire after 30 minutes and guests also receive a one-click deletion control.

Does the software guarantee legal compliance? No. MomentGrid includes consent, retention and deletion controls plus editable legal pages, but the operator remains responsible for compliance in their jurisdiction.

Changelog

1.0.0 — Initial release.

Features

• Private on-server selfie search with no external paid face-recognition service
• White-label branding with editable name, logo, colors and legal pages
• Multi-photographer SaaS with editable plans, quotas and subscriptions
• Stripe, PayPal and manual bank-transfer payment workflows
• Docker Compose deployment for Ubuntu 22.04 or 24.04 VPS
• English and Spanish interface, errors and emails
• Responsive galleries with QR sharing, PIN protection and ZIP downloads
• Privacy controls with in-memory selfie processing and automatic expiration

Requirements

Server requirements

• Ubuntu 22.04 or 24.04 VPS
• Minimum: 2 GB RAM and 1 vCPU
• Recommended: 4 GB RAM and 2 vCPU
• Docker Engine and Docker Compose
• HTTPS in production for browser camera access
• For direct installation: Node.js 22+ and PostgreSQL 15+
• SMTP provider for account verification and transactional emails

Browser support

Latest two versions of Chrome, Safari, Firefox and Edge. The guest gallery and selfie capture support current iOS Safari and Android Chrome.

Optional payment services

• Stripe or PayPal account if online payments are enabled
• Manual bank-transfer payments can be managed without an external payment API

Instructions

Installation

1. Use an Ubuntu 22.04 or 24.04 VPS with at least 2 GB of RAM and 1 vCPU.
2. Install Docker Engine and Docker Compose on the server.
3. Extract the downloaded ZIP into a directory such as /opt/momentgrid.
4. Copy .env.docker.example to .env and configure the database password, JWT secret, encryption key and application URL.
5. Run docker compose up -d --build.
6. Open https://your-domain/install and complete the installation wizard.

Installation wizard

1. Complete the server check.
2. Create the administrator account.
3. Set the platform name, logo and accent color.
4. After setup, sign in at /login.

Initial configuration

1. Configure SMTP under Admin settings and send a test email.
2. Review plans, quotas and feature flags.
3. Configure Stripe, PayPal or manual payments if required.
4. Configure local storage or an S3-compatible provider.
5. Review and adapt the Terms and Privacy Policy pages for your jurisdiction.

Using MomentGrid

1. Create a photographer account and select a plan.
2. Create an event and upload the event photos.
3. Share the gallery URL, QR code or PIN with guests.
4. Guests can optionally use selfie search after granting consent.