Sign inSign up

vloschiavo/clonehero-standalone-server

By vloschiavo

•Updated 4 months ago

This is a fork of https://gitlab.com/CorySanin/clone-hero-server-docker; updated to v1.1.0.6085

Image
0

2.0K

vloschiavo/clonehero-standalone-server repository overview

⁠clonehero-standalone-server 🎸 🥁 🐳

Change Log: 2026-05-03:

  • Moved to Alpine Linux container base
  • Added a single multi-arch docker image to support arm, arm64, linux-x86, and linux-musl in addition to x86-64.
  • Added Individual architecture images & tags as well for those that want to specify a particular cpu architecture.

Docker image for Clone Hero dedicated server software. Available on Docker Hub⁠ Built with version: v1.1.0.6085 (May 01, 2026)

This was forked from: https://gitlab.com/CorySanin/clone-hero-server-docker⁠ / https://hub.docker.com/r/corysanin/clone-hero-server⁠.

I moved the containers to Alpine for smaller image size and grabbed the latest Clone Hero Server binaries from https://github.com/clonehero-game/releases/releases/tag/v1.1.0.6085-final⁠.

⁠Docker Compose:

docker compose up -d

The Docker image exposes port 14242 for network communication by default. This can be configured in the docker-compose.yml environment variables which you can find here: https://github.com/vloschiavo/clonehero-standalone-server⁠

Here is an example docker-compose.yml

services:
  clone-hero-server:
    image: vloschiavo/clonehero-standalone-server:latest
    container_name: clone-hero-server
    restart: unless-stopped
    user: "1000:1000"

    # Server Options
    environment:
      - CH_NAME=My Clone Hero Server       # Set server name
      - CH_PORT=14242                      # Set single server port
      - CH_ADDRESS=0.0.0.0                 # Set server binding address
      - CH_LOG_LEVEL=4                     # Set max logging level. default 4, range: 0-4
      - CH_PASSWORD=                       # Set server password or leave CH_PASSWORD= blank and set CH_NO_PASS=true
      - CH_NO_PASS=true                    # Don't set a Server Password
      - CH_ALLOW_RESET=true                # When the server becomes empty, game values are set to default
      - CH_USE_DEFAULTS=false              # Skip address and port setup and startup a server with default settings
      # Use these two variables to spin up one or more servers.  You'll need to change the ports section below to match
      - CH_INSTANCE_COUNT=1                # Set max server instance count
      - CH_PORTRANGE=14242-14251           # Set multi server port range
    
    ports:
      - "14242:14242/udp"
      #- "14242-14251:14242-14251/udp" 

    volumes:
      - ./settings.ini:/usr/src/clonehero/settings.ini
      - ./cache:/tmp/CloneHeroServer       # Used for persistent cache of your users' song lists.  This speeds up subsequent connections to your server between restarts.
    
    # Optional: Give the container more resources if you expect many players or are launching multiple instances
    deploy:
      resources:
        limits:
          cpus: '1.0'
          memory: 256M

Here is a valid default for settings.ini

[online]
defaultgamemode = quickplay
minrequiredplayers = 1
maxplayers = 4
onlyhostchoosesongs = 0
maxspectators = 4
servertickrate = 30
lowsongspeed = 50
maxsongspeed = 250
clientremovesongs = 0
songsperclient = 1

[redis]
redis_enable = 0
redis_db_id = 0
redis_password = 
redis_hostname = localhost

Tag summary

Content type

Image

Digest

sha256:2eeddb52e…

Size

23.7 MB

Last updated

4 months ago

docker pull vloschiavo/clonehero-standalone-server