MeepleStats---Backend

Overview

A self-hosted web application designed to track board game statistics for your group of friends! It allows users to log game sessions, analyze player performance, and manage a wishlist of games. This is the backend component.

Requirements

Requires separate MongoDB and MeepleStats - Frontend containers.

Runtime arguments

Network: bridge
Privileged: false

Template configuration

API PortPorttcp

Container Port: 5000

Target: 5000
Default: 5000
Value: 5000

BoardGameGeek UsernameVariable

Your BoardGameGeek username for fetching game data

Target: BGG_USERNAME

Database - URLVariable

MongoDB connection string

Target: MONGO_URI
Default: mongodb://root:password@IP_ADDRESS:27017/meeplestats?authSource=admin

Database - NameVariable

Name of the MongoDB database to use

Target: DB_NAME
Default: meeplestats

Secret KeyVariable

Use `openssl rand -base64 32`

Target: SECRET_KEY

CORS OriginsVariable

Comma-separated list of allowed CORS origins (e.g. http://localhost:3000)

Target: CORS_ORIGIN

JWT - Secret KeyVariable

Use `openssl rand -base64 32`

Target: JWT_SECRET_KEY

JWT - Expiration (seconds)Variable

Expiration time for JWT access tokens in seconds

Target: JWT_ACCESS_TOKEN_EXPIRES
Default: 28
Value: 28

JWT - StorageVariable

Storage method for JWT tokens

Target: JWT_STORAGE
Default: localstorage|cookie

JWT - Token LocationVariable

Token location, e.g. headers, cookies

Target: JWT_TOKEN_LOCATION

JWT - Secure CookiesVariable

Whether to use secure cookies for JWT

Target: JWT_COOKIE_SECURE
Default: True|False

JWT - Access Cookie NameVariable

Name of the JWT access cookie

Target: JWT_ACCESS_COOKIE_NAME
Default: meeplestats
Value: meeplestats

JWT - CRSF ProtectionVariable

Whether to enable CSRF protection for JWT cookies

Target: JWT_COOKIE_CSRF_PROTECT
Default: True|False

JWT - StorageVariable

Storage method for JWT tokens

Target: JWT_STORAGE
Default: localstorage|cookie

Storage - TypeVariable

Type of storage to use for file uploads

Target: STORAGE_TYPE
Default: local|s3

Storage - S3 EndpointVariable

S3 endpoint URL (required if using S3 storage)

Target: S3_ENDPOINT

Storage - S3 Access KeyVariable

S3 access key (required if using S3 storage)

Target: S3_ACCESS_KEY

Storage - S3 Secret KeyVariable

S3 secret key (required if using S3 storage)

Target: S3_SECRET_KEY

Storage - S3 Bucket NameVariable

S3 bucket name (required if using S3 storage)

Target: S3_BUCKET_NAME

Rulesbooks Chat (RAG) - EnableVariable

Enable Rulesbooks Chat (RAG) integration

Target: ENABLE_RAG
Default: True|False

Rulesbooks Chat (RAG) - Pinecone API KeyVariable

Pinecone API key for RAG integration

Target: PINECONE_API_KEY

Rulesbooks Chat (RAG) - Pinecone Index NameVariable

Pinecone index name for RAG integration

Target: PINECONE_INDEX_NAME

Rulesbooks Chat (RAG) - Embedding TypeVariable

Embedding type for RAG integration

Target: EMBEDDING_TYPE
Default: gemini|local

Rulesbooks Chat (RAG) - Embedding ModelVariable

Embedding model for RAG integration. Example: BAAI/bge-small-en-v1.5

Target: EMBEDDING_MODEL

Rulesbooks Chat (RAG) - Gemini API KeyVariable

Gemini API key for RAG integration

Target: GEMINI_API_KEY

Rulesbooks Chat (RAG) - Pinecone DimensionVariable

Chunk size for RAG document processing

Target: PINECONE_DIMENSION
Default: 384
Value: 384

Rulesbooks Chat (RAG) - OpenRouter API KeyVariable

OpenRouter API key for RAG integration

Target: OPENROUTER_API_KEY

Rulesbooks Chat (RAG) - LLM ModelVariable

LLM model for RAG integration. Example: qwen/qwq-32b:free

Target: LLM_MODEL

Data FolderPath

Path to the data folder

Target: /data
Default: /mnt/user/appdata/meeplestats/backend/data
Value: /mnt/user/appdata/meeplestats/backend/data

Internal Upload FolderVariable

Path inside the container for uploaded files

Target: UPLOAD_FOLDER
Default: /data

Links

Template Support GHCR Project

Details

Repository

ghcr.io/tommythehuman/meeplestats/backend:latest

Registry

https://registry.hub.docker.com/r/ghcr.io/tommythehuman/meeplestats/backend

Last Updated2026-05-31

First Seen2025-12-24

Run MeepleStats---Backend on Unraid.

MeepleStats---Backend is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS