haxxnet/compose-examples

★ 7,087Audience · ops devopsComplexity · 2/5Setup · easy

Mindmap

mindmap
  root((compose-examples))
    App categories
      Media servers
      Password managers
      DNS and identity
      LLM tools
    How to use
      Clone repo
      Edit paths and passwords
      Run docker compose up
    Best practices
      Change default passwords
      Use secrets file
      Add reverse proxy
    Targets
      Home server
      VPS
      Cloud VM

mindmap root((compose-examples)) App categories Media servers Password managers DNS and identity LLM tools How to use Clone repo Edit paths and passwords Run docker compose up Best practices Change default passwords Use secrets file Add reverse proxy Targets Home server VPS Cloud VM

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Self-host a media server like Jellyfin on your own hardware without manually writing a Docker Compose configuration.

USE CASE 2

Deploy a private password manager or note-taking app using a pre-written compose file and a single docker compose up.

USE CASE 3

Set up a DNS server or identity system on your home network from a tested, ready-made configuration.

Tech stack

DockerDocker Compose

Getting it running

Difficulty · easy Time to first run · 30min

Volume paths default to /mnt/docker-volumes/ and must be changed to match your storage layout before running.

In plain English

Compose-Examples is a collection of ready-to-use Docker Compose configuration files for self-hosted open-source and proprietary software. Docker Compose is a tool that lets you define and run applications in containers with a single configuration file, and this repository provides those files pre-written for a large number of popular applications. If you want to run your own instance of a media server, password manager, note-taking app, or dozens of other tools on your own hardware or a private server, you can grab the relevant file here and start without building the configuration from scratch. The repository covers a wide range of categories. You will find configurations for analytics platforms, document managers, DNS servers, identity and single sign-on systems, large language model tools, game servers, recipe managers, URL shorteners, and more. Each entry lives in its own subdirectory under examples/ and includes the compose file along with any sample configuration files the application needs to start. Getting started follows the same pattern for every project: clone the repository, navigate to the folder for the application you want, review the notes and adjust file paths and credentials, then run docker compose up. The repository notes that volume paths default to /mnt/docker-volumes/ but can be changed with an environment variable to match your own storage layout. The examples are meant for learning and experimentation as well as actual self-hosting deployments. The maintainers recommend adjusting all default passwords, using a separate file for secret management, setting up a reverse proxy for HTTPS, and having a backup plan before exposing anything to the internet. An online web version of the repository is also available for browsing the full list of supported projects. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1

I want to self-host Jellyfin using haxxnet/compose-examples. Walk me through picking the right compose file, adjusting volume paths, and running it securely.

Prompt 2

Using compose-examples, help me set up a reverse proxy with HTTPS so my self-hosted apps are accessible from the internet safely.

Prompt 3

How do I change the default volume path from /mnt/docker-volumes/ to /data/ across a compose file from this repo?

Prompt 4

Help me add a separate secrets file to a compose-examples configuration so passwords are not stored in plain text.

Open on GitHub → Explain another repo

← haxxnet on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.