Self-host puppy-stardew-server
v1.1.1Stardew Valley multiplayer server in Docker with web panel
- 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))
truemanlive/puppy-stardew-serverWhat 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
More in Docker
redroidSelf-hosted open-source Android-in-Cloud solution running GPU-accelerated Android containers on Linux via Docker, supporting arm64 and amd64 with Android 8.1 through 16.
sablierAn open-source, self-hosted scale-to-zero API: Sablier starts sleeping containers, deployments or LXC guests when a request arrives, and stops them once they go idle.
satisfactoryA Dockerized version of the Satisfactory dedicated server
swarm-cronjobOpen-source, self-hosted cron scheduler for Docker Swarm that turns services into recurring jobs via labels, with automatic discovery and time-zone support.
TorolloOpen-source, self-hosted system design and networking lab: draw an architecture and every node runs as a real Docker container, with graded learning roadmaps.
uncloudSelf-hosted, open-source Docker clustering tool: WireGuard mesh, Compose deploys, automatic HTTPS — an alternative to Kubernetes and Swarm.
Unifi-Network-ApplicationSelf-hosted Docker deployment scripts and compose files for UniFi Network Application with MongoDB, supporting generic systems, DietPi, and CasaOS.
UnregistryAn open-source, self-hosted container registry that stores images in Docker's containerd store and pushes them to remote servers over SSH with the docker pussh plugin.
woodpecker-ciSelf-hosted, open-source Apache-2.0 CI/CD engine: pipeline steps run in Docker containers and workflows trigger from forges like GitHub, Gitea, GitLab or Bitbucket.
assemblrrassemblrr is an open-source, self-hosted automation suite that provisions a complete media stack with VPN-first networking and a unified CLI.
caddy-docker-proxySelf-hosted Caddy plugin, shipped as ready-to-run Docker images, that reads container labels to build its proxy config with zero-downtime reloads and automatic HTTPS.
containernetwork-autofixContainerNetwork AutoFix auto-recreates Docker containers using --net=container: networking when the master container restarts, preserving state. For Unraid and Docker.


0 comments