Word Mastermind

Self-Hosted

Open-source word guessing game for self-hosted play

Overview

Word Mastermind is an open-source word puzzle game inspired by classic word guessing formats like Wordle. It allows users to host their own instance for personal or community use, with support for custom word lists, adjustable difficulty levels, and optional multiplayer sessions. Deployment is simple—use Docker for a quick, isolated setup or host via a static web server with a lightweight backend for persistent player stats. It prioritizes privacy by keeping all game data local to your server and offers theme customization to match your preferences.

Self-Hosting Resources

Find Official Image on Docker Hub View Source & Docs

Below is a reference structure for docker-compose.yml. ⚠️ Do NOT run blindly. Replace placeholders with official values.

docker-compose.template.yml TEMPLATE


version: '3'
services:
  word_mastermind:
    image: <OFFICIAL_IMAGE_NAME>:latest
    container_name: word-mastermind
    ports:
      - "8080:<APP_INTERNAL_PORT>"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

Key Features

Custom word list support
Docker one-click deployment
Privacy-focused local data storage
Adjustable difficulty and theme options

Frequently Asked Questions

? Is Word Mastermind hard to install?

No—Word Mastermind provides a Docker image for straightforward deployment, or you can host it using a static web server with a simple backend. Basic familiarity with Docker or web hosting is enough to get started.

? Is it a good alternative to Wordle?

Yes—It replicates core word guessing mechanics while adding self-hosting benefits like privacy, custom word lists, and no reliance on external services, making it ideal for those who want control over their game experience.

? Is it completely free?

Yes—Word Mastermind is open-source under the MIT License, so it’s free to use, modify, and self-host without any subscription fees or hidden costs.

Top Alternatives

Wordle Search Google

Wordscapes Search Google

Tool Info

Pricing Free/Open Source

Category Games

Platform Self-Hosted

Pros

⊕ No external ads or tracking
⊕ Customizable game rules
⊕ Minimal server resource requirements

Cons

⊖ Requires basic server setup knowledge
⊖ Limited social features compared to SaaS alternatives
⊖ May need manual updates for new word lists