selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
puppy-stardew-server logo

Self-host puppy-stardew-server

v1.1.1

Stardew Valley multiplayer server in Docker with web panel

ReleaseOpen SourceOther
Updated14 hours ago
LanguageShell
Setup difficultyModerate
ThemeDark mode
Stars
45
CPU
1+ cores (2+ recommended for 4+ players)
RAM
2GB minimum (4GB recommended for 4+ players)
Storage
2GB free space
Ports
24642 (Game server (UDP)), 5900 (VNC remote desktop (TCP)), 9090 (Prometheus metrics (TCP)), 18642 (Web management panel (TCP))
Docker
truemanlive/puppy-stardew-server
Install with Docker Compose
Web panel dashboard showing server status, join details, runtime metrics, and health signalsInstant sleep demo showing automated day-night transition without visible host client

What is puppy-stardew-server?

This Docker project runs a persistent Stardew Valley multiplayer world on your own server. It combines the game, the SMAPI mod loader, and a set of server-focused mods into a single container. A web dashboard lets you check status, view logs, manage saves, edit settings, run backups, and handle mods without touching the command line. The included mods automate headless play, instant sleep transitions, and automatic save loading on startup. You can get started with a single bootstrap command or use Docker Compose for more control. All persistent data — saves, game files, Steam cache, logs, backups, panel settings, and custom mods — lives in bind-mounted directories on the host. Network ports: web panel on 18642, game traffic on UDP 24642, VNC on 5900 for first-time setup, and Prometheus metrics on 9090. Known constraints: festival and non-skippable event handling isn't automated, and a container restart requires a manual save reload through VNC to bring multiplayer back online. The code is MIT-licensed.

Should you self-host puppy-stardew-server?

puppy-stardew-server scores 41/100 on selfhost.directory (how scoring works) and ranks #51 of 62 in Game Servers. It has 45 GitHub stars.

It shipped 2 stable releases in the past year. The latest, v1.1.1, came out on 16 September 2026. New versions land roughly every 5 months.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Other-licensed and written mostly in Shell.

Its closest alternative on selfhost.directory is minecraft (78/100, 14 491 stars). It scores higher overall, so compare the two before you pick. See puppy-stardew-server vs minecraft side by side.

Features

  • Auto-backupDisabled by default; enable via ENABLE_AUTO_BACKUP=true
  • Automatic save loadingContainer restart requires manual save reload via VNC to re-initialize multiplayer
  • Backup and Restore
  • Crash Auto-Restart
  • Custom mods support
  • Docker secrets supportRequires Docker Swarm mode for native secrets
  • Headless operation with VNC
  • Log monitoring and rotation
  • Mod Management
  • One-command deployment
  • Player Access Control
  • Prometheus MetricsBound to localhost by default; set METRICS_BIND_HOST=0.0.0.0 to expose externally
  • Save selector
  • Web management panel

puppy-stardew-server README

How to install puppy-stardew-server

Install puppy-stardew-server with Docker Compose

Environment variables
STEAM_USERNAME, STEAM_PASSWORD, ENABLE_VNC, VNC_PASSWORD, and many advanced options

git clone https://github.com/AmigaMeow/puppy-stardew-server.git cd puppy-stardew-server cp .env.example .env nano .env # edit with Steam credentials ./init.sh docker compose up -d

Requires Docker and Docker Compose installed

puppy-stardew-server releases & version history

More in Docker

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…