StardropHost

Your always-on Stardew Valley co-op server, managed entirely from your browser.
One install command and no terminal needed again.
Set it up once, play whenever.
Free, open source, and fully featured.

192.168.0.100:18642

−□×

192.168.0.100:18642

Interactive Demo

Explore the dashboard live — no download or account required. See exactly what managing your server looks like.

Download & Install

Get StardropHost running on your own machine. One install command, guided setup wizard, and you're online.

Simple Setup

One command run on your server, then follow the setup wizard in a browser on your local network - even from your phone. It walks you through everything: admin password, game files, farm config, and launch. Most servers are up in under 5 minutes.

Steam & GOG Supported

The setup wizard can download Stardew Valley via Steam or GOG. Credentials are never stored - used once to download, then discarded. You can also copy your existing game files across manually.

Live Dashboard & World Controls

Real-time server status, player count, uptime, and resource usage at a glance. Set the time, season, shared money, and build permissions - freeze time, trigger events, and clear debris, all from the browser.

Player Management & Chat

Kick, ban, or manage up to 16 players. View connected players in real time and block or allowlist by name or IP. Read and send in-game chat directly from the panel - broadcast announcements to the whole server without being in-game.

Save Management & Mod Support

Upload existing saves to migrate from a local game. Auto-backups run every 24 hours and before every stop or update. Upload and manage SMAPI mods through the panel - any mod that works in multiplayer works here.

Remote Access & Multi-Instance

Install and run entirely from a single browser tab. Connect a tunnel to share your game and access the dashboard from anywhere - no port forwarding required. Run multiple independent server instances, each with their own save, mods, and settings.

Built on Docker & SMAPI

StardropHost runs completely in Docker using a Linux runtime with the SMAPI modding platform. It provides persistent volumes for saves and configuration, ensuring you never lose data - even across restarts and updates.

Coming Soon

Mod ManagerAllow or block mods on the server, enforce required mods for clients, and manage host-side vs client-side mod compatibility.
Discord Bot IntegrationShare your game chat, server status, and in-game events directly with a Discord bot in your community server.
Lobbies & Advanced Player ManagementPassword protected servers, invite-only lobbies, and deeper per-player permission controls.
Player DashboardA dashboard your players can log into to track their own game progress, stats, farm screenshots, and more.

All of these and more are currently in the works — releases coming very soon.

Have a feature request? Join the community on Discord and let us know.

Setup Guides

Everything you need to get your server running. Follow in order for a smooth setup.

1. Pre-requisites & System Requirements

Hardware requirements:

Minimum: 2 GB RAM, 2 CPU core, 4 GB free storage

Actual RAM and CPU usage depends on the number of players online and the amount and type of mods uploaded to the server.

Supported environments:

Linux (Recommended) — Ubuntu 22.04/24.04 or Debian 12 on bare metal or a VM
Proxmox — Deploy as a dedicated VM (recommended for home servers)
TrueNAS SCALE — Use the Apps section with a custom Docker Compose
Windows / macOS — Supported for testing only; not recommended for 24/7 hosting

Virtual Machine (recommended): For home servers running Proxmox or similar, spin up a dedicated Debian/Ubuntu VM before installing. This keeps StardropHost isolated and easy to snapshot or wipe.

You need a copy of Stardew Valley. The setup wizard can download it via Steam or GOG, or you can copy your existing game files across manually.

2. Installation

Option A — One-command install (recommended):

Open a terminal on your Linux server or VM.
Run the install command from the Download page.
The script handles everything — dependencies, Docker, the repo, directories, and starting the containers.
Once done, the installer will print the panel URL: http://your-server-ip:18642

Option B — Manual install:

Clone the GitHub repository: git clone https://github.com/Tomomoto10/StardropHost
Change into the directory: cd StardropHost
Run ./install.sh to set up dependencies and start the containers.
Navigate to http://your-server-ip:18642 to access the panel.

3. First-Run Setup Wizard

On first launch, StardropHost walks you through a short setup wizard.

Open the panel — Navigate to http://your-server-ip:18642 in your browser. The wizard starts automatically.
Set your admin credentials — Choose a secure username and password for the dashboard. These are what you'll use to log in each time.
Game files — Choose how to provide the game: download via Steam or GOG through the wizard, or skip and copy your existing game files across manually.
Farm setup — Choose to create a new farm, or upload an existing .zip save file. Uploading allows you to migrate a local save to the server.
Start the server — Click Launch. The server will start and you'll land on the Dashboard. Your farm is live!

Players can connect via Co-op → Join LAN Game in Stardew Valley using the LAN IP shown in the Dashboard. For remote play, see the Remote Access guide below.

4. Remote Access with playit.gg

playit.gg creates a free tunnel so friends can join from anywhere - no port forwarding or static IP needed.

Free vs Premium: Free supports UDP (PC & mobile). Premium (~$5/mo) adds TCP which is required for console players (Switch, Xbox, PlayStation) and remote dashboard access.

Sign up at playit.gg.
In your playit.gg dashboard, go to Agents → Add Agent and select Docker install. Do not run the provided command. Instead, copy only the SECRET_KEY value shown.
In StardropHost, open the Remote tab. Paste the provided Docker Compose snippet into the config box, replacing the placeholder with your SECRET_KEY.
Click Apply & Connect. The panel spins up the tunnel agent container.
Back in playit.gg, go to Tunnels → Add Tunnel. Select UDP, port 24642, and assign it to your server's local IP.
playit.gg will generate a tunnel IP and port. Copy this into the Remote tab in StardropHost - it will display as your game connection address anytime. Share this IP:port with friends to enter in Stardew Valley's co-op join screen.

Remote Dashboard Access

To access your dashboard remotely, create a second tunnel - select TCP, port 18642 (Premium required). playit.gg will generate a domain for your dashboard. You can create a custom domain with a Premium subscription. Use this domain to reach your dashboard from anywhere.

5. Updating & Maintenance

Updating StardropHost panel: Go to the Dashboard and click Check for Updates. If an update is available, click Update Panel — the panel rebuilds itself and reloads automatically.

Updating the game: Game updates are checked automatically as part of the panel update process. After the panel restarts following an update, a game update prompt will appear in the Config tab if a new version is available (Steam and GOG only).

Backups: Backups are taken automatically every 24 hours and before every stop, restart, or update. You can also trigger a manual backup any time from the Saves tab.

Uninstalling: SSH into your server, cd into the StardropHost folder, and run ./uninstall.sh for complete removal of all containers, files, and data.

Server Guides

Coming Soon

In-depth guides for managing and customising your server.

📋 How to read, run, and change settings in each dashboard tab
🔧 Troubleshooting — SSH access, common errors, and manual fixes
🔄 Updating and routine maintenance

Detailed guides coming soon — check back or join the Discord for the latest.

Player Guides

Coming Soon

Everything client players need to get the most out of their server experience.

🌾 How to connect and get started on a StardropHost server
💬 Player commands — e.g. .move_cabin [type] to reposition and reskin your cabin

Detailed guides coming soon — check back or join the Discord for the latest.

Pre-Requisites

Minimum requirements for a 1–4 player server — more players or heavy mods will need additional RAM and CPU.

Requirements

✅ Dedicated server or always-on device (see below)
✅ 2 CPU cores minimum
✅ 2 GB+ RAM available
✅ 4 GB+ disk space
✅ A copy of Stardew Valley (Steam, GOG, or existing game files)

Operating System — VM Strongly Recommended

StardropHost is designed to run on a dedicated server or always-on device — not your main PC. Running it on a separate machine means the server stays online 24/7 without tying up your personal computer. A VM on a home server or spare machine is the ideal setup.

It is strongly recommended to run it inside a dedicated Virtual Machine — this keeps it isolated, easy to snapshot, and simple to reset without affecting the host system.

Recommended environments:

Proxmox VE — VM only
TrueNAS SCALE — via VM (not Apps/containers)
Any hypervisor — VirtualBox, VMware, Hyper-V
Bare metal Linux — Debian or Ubuntu recommended

Other Linux environments should work but have not all been tested. The install script handles Docker and all other dependencies automatically — no manual setup required.

Download & Install

Run the command below on your Linux terminal. The install script handles everything and launches the setup wizard automatically.

Install Command

sudo curl -sSL https://raw.githubusercontent.com/Tomomoto10/StardropHost-dev/main/quick-start.sh | bash

Once the script finishes, it will print the dashboard URL in the terminal. Copy it and open it in a browser on any device connected to the same local network to complete the setup wizard.

After Installing

Accessing Your Dashboard

If you didn't catch the URL when the install finished, you can retrieve it by running:

docker logs stardrop

The dashboard URL may appear further up — scroll up through the logs if you don't see it immediately.

Or go directly to the dashboard using your server's local IP address:

http://<your-server-ip>:18642

For example: http://192.168.1.100:18642 — accessible from any device on your local network.

Not sure what the IP is? Run ip a or hostname -I on the server.

Need more help? The Guides page walks through the full setup from scratch — including the wizard, game files, remote access, and troubleshooting.

GitHub

Source code, issue tracking, and feature requests. Please use the appropriate labels when submitting issues.

View Source

Discord

Join our community to get help, discuss features, and connect with other server hosts.

Join Community

Server Status

Running

Remote Access

Active

Online Players

3/8

Uptime

12h 45m

Game Day

Summer 14, Year 2

Backups

Loaded Mods

System Resources

CPU25%

RAM840 / 2048 MB

Server Details

LAN IP

192.168.1.50

Enter this IP in Stardew Valley's Co-op join screen when playing on local network.

Local IP

127.0.0.1

Used for remote connection setups, or if Stardew Valley is running on the same machine as StardropHost.

Game Port

24642

Used for remote connection to Stardew Valley Game.

Dashboard Port

18642

Access the StardropHost dashboard from a browser on your network.

Remote Access

Remote Game

198.51.100.42:24642

Share with players to connect from anywhere via playit.gg.

Remote Dashboard

stardropfarm-panel.joinmy.game

Access StardropHost dashboard remotely via playit.gg TCP tunnel.

Quick Actions

Live Status

Date

Summer 14, Year 2

Time

1:20pm

Weather

Sunny

Game State

Playing

● CoolFarmer · Mines (Floor 40) ● SproutKing · Beach

Farm Info

Farm Name

Stardrop Farm

Farm Type

Standard

Shared Money

45,200g

Wallets

Shared

Community Center 35% · 2/6 rooms

Pantry✓ Complete

Crafts Room✓ Complete

Fish Tank3 / 5 bundles

Boiler Room2 / 3 bundles

Bulletin Board1 / 6 bundles

Vault0 / 4 bundles

World Controls

Commands sent directly to the running game via SMAPI.

Shared Money

Set Time

Set Day

Set Season

Set Year

Crop Saver

Pause the Game

Freeze Time

Build Permissions

Set to owned or on to allow players to use move_cabin [types]

types =

Upgrade Cabin

Clear

Online Players

2 / 4

CoolFarmer

Current IP: 192.168.1.115

Location

Mines Lv.40

Health

❤️ 80/100

Stamina

⚡ 132/180

SproutKing

Current IP: 192.168.1.208

Location

Beach

Health

❤️ 100/100

Stamina

⚡ 270/270

Connection Security

Players matching a blocked name or IP are kicked immediately on connection.

NAMEGrieferDude99Repeated griefing

IP10.0.0.42VPN hopper

Known Player IPs

Automatically recorded when players join. Used for IP-alias blocking. You can manually update a friend's IP if it changes.

Press the lock button to lock this user (Device/IP) to the Player. If another IP/Device tries to connect to that Player they will be kicked.

NameCoolFarmer192.168.1.115

NameSproutKing192.168.1.208

Farmhand Slots

Slot 1 — CoolFarmer's Cabin

Occupied

Slot 2 — SproutKing's Cabin

Occupied

Slot 3 — Unclaimed

Available

Slot 4 — Unclaimed

Available

Slot 5 — Unclaimed

Available

Slot 6 — Unclaimed

Available

Slot 7 — Unclaimed

Available

World Chat

Private Chat

FarmerJohn 1:18pmhey everyone, should we work on the fish tank bundles today?

CoolFarmer 1:19pmyes! heading to the mines first to get the gold fish

SproutKing 1:19pmI'll check the beach for largemouth bass 🎣

CoolFarmer 1:21pmfound a catfish in the river too!

add extra line...

Save Files

Your farm saves live here. Only one save is active at a time. Use Select to switch the active save (requires restart). Upload Save accepts a .zip containing a save folder.

Stardrop Farm Active

Summer 14, Year 2 · 4.2 MB · Saved 2 mins ago

Riverdale Farm

Spring 3, Year 1 · 1.1 MB · Uploaded 3 days ago

Backups 5

Backups are full snapshots of your entire game config — saves, preferences, and options. They are taken automatically every 24 hours and before every server stop, restart, or update. Use Backup Now before making any risky changes. Hit Restore on any backup to recover — the server will stop and you will need to restart it after.

stardrop-farm-auto-backup-20260407-132000.zip

Auto · 6.8 MB · Today 1:20 PM

stardrop-farm-pre-stop-20260406-201500.zip

Pre-stop · 6.5 MB · Yesterday 8:15 PM

stardrop-farm-auto-backup-20260406-090000.zip

Auto · 6.3 MB · Yesterday 9:00 AM

Bundled Mods

SMAPI v4.5.2

These mods are built into StardropHost and are required for the server to function. They cannot be removed.

Console Commands Bundled

v4.5.2 · SMAPI · Adds SMAPI console commands that let you manipulate the game.

Save Backup Bundled

v4.5.2 · SMAPI · Automatically backs up all your saves once per day into its folder.

StardropDashboard Bundled

v1.0.0 · StardropHost · Writes live game state to live-status.json every 10 seconds for the StardropHost web panel.

StardropHost.Dependencies Bundled

v1.0.0 · StardropHost · Combined server management mod for StardropHost. Handles game loading, host hiding, headless server operation, and new farm creation.

User Installed Mods

Most Client-side mods (visual, UI, or input mods) will work but all of the connected clients must also have the mod/s installed on their system.
Many mods are un-tested, but give it a try. (Make a Save Backup)
*Some mods may cause server issues or not work at all.

No user mods installed

SMAPI Console

Connecting to SMAPI… Type commands below — this is not a Linux shell.

[18:44:29 INFO StardropHost.Dependencies] [CabinStack] Building 16 cabin(s) to reach target of 16.

[18:44:29 INFO StardropHost.Dependencies] [StardropHost.Dependencies] Server ready for connections.

[18:44:29 INFO StardropHost.Dependencies] [CropSaver] Loaded 0 tracked crop(s).

[18:44:29 TRACE game] Warping to Desert

[18:50:24 TRACE game] Sending available farmhands to connection ID L_3239876009723315914

[18:50:32 TRACE SMAPI] Received connection for vanilla player -1282051730110708346.

[18:50:32 TRACE game] Approved request for farmhand -1282051730110708346

[18:50:33 DEBUG StardropHost.Dependencies] [CabinStack] Cabin for peer -1282051730110708346 shown at (52,14) client-side.

[19:05:08 INFO StardropHost.Dependencies] [HeadlessServer] Auto-sleep at 2600.

[19:05:08 INFO StardropHost.Dependencies] [HostBot] Going to bed at FarmHouse (9,9).

[2026-04-07 18:54:52] [18:54:33 TRACE game] Successfully loaded ContentHashes.json containing 3560 file(s);

[2026-04-07 18:54:52] [18:54:33 TRACE game] EnsureManifestInitialized() finished, elapsed = '00:00:00.0084244'

[2026-04-07 18:54:52] [18:54:34 TRACE game] setGameMode( 'playingGameMode (3)' )

[2026-04-07 18:54:52] [18:54:34 TRACE game] Starting server. Protocol version: 1.6.15

[2026-04-07 18:54:52] [18:54:34 TRACE game] Starting LAN server

[2026-04-07 18:54:52] [18:54:36 TRACE game] Window_ClientSizeChanged(); Window.ClientBounds={X:0 Y:0 Width:800 Height:600}

[2026-04-07 18:54:52] [18:54:36 TRACE game] SaveGame.Save() called.

[2026-04-07 18:54:52] [18:54:36 TRACE game] Saving without compression...

[2026-04-07 18:54:52] [18:54:38 TRACE game] SaveGame.Save() completed without exceptions.

[2026-04-07 18:54:52] [18:54:39 TRACE game] Warping to Desert

[2026-04-07 18:54:52] [18:54:40 TRACE game] Warping to Desert

[2026-04-07 18:55:22] [18:55:02 TRACE game] Sending available farmhands to connection ID L_-2588075101791555982

[2026-04-07 18:55:22] [18:55:08 TRACE game] Approved request for farmhand 5868778512659204619

[2026-04-07 18:55:22] [18:55:09 TRACE game] Warping to Desert

[2026-04-07 19:02:52] [19:02:35 TRACE game] Game has only local clients.

Remote Access

Connect friends directly with a co-op IP or domain name — no in-game invite codes required.

Access your Stardew game or StardropHost dashboard from anywhere
Host multiple game instances on one VM easily (depends on the service used)
Recommended: playit.gg — tested and working. See the setup guide below.
Other services should work by following their own setup guides

Service Status

playit Active — running

Connection Addresses

Co-Op Game

Dashboard

playit.gg Setup Guide RECOMMENDED Paid / Free — No client setup needed

No client setup needed — friends join directly with an address
Multiplatform — PC, Mobile, Console (Console untested)

Premium is highly recommended. Free tier works but has no TCP — StardropHost/Stardew works on UDP (PC & Mobile only). Remote Dashboard access requires a TCP tunnel (Premium only).

Account Setup

Sign up for an account at playit.gg
Don't set up an agent yet — press "Exit Wizard" if prompted
Purchase a Premium subscription (~$5/mo) for TCP support (recommended)
Go to Setup → "New Account Wizard" → select Docker
Continue to Agent Setup below

Agent Setup

In playit.gg, go to Agents → Add Agent
Name your agent (e.g. StardropHost-1) then press Next
Copy the full docker compose snippet shown on the page
Paste it into the Compose Entry section and click Apply & Connect
The agent will show Connected in playit.gg once running

Tunnel Setup

Click Tunnels → Create Tunnel
Name it, select type UDP, port count 1
For Local IP & Port: use your server's LAN IP and port 24642
Select the region closest to you, then Create Tunnel
Copy the generated IP & Port — share with friends to enter in Stardew Valley's co-op join screen

Remote Dashboard Setup TCP — Premium required

In playit.gg → Tunnels → Create Tunnel
Select type TCP, port count 1
For Local IP & Port: use your server's LAN IP and port 18642
Select your agent, then Create Tunnel
Access your dashboard remotely at the generated domain and port

Compose Entry

Paste a docker-compose snippet from your tunnel provider and click Apply & Connect. The service will start automatically and status will update above.

Other Options

No client setup needed — similar to playit.gg, known to work for gaming:

Tailscale Funnel — free, good latency
Cloudflare Tunnel — free, TCP/UDP, no port forwarding
ngrok — free tier available, easy setup

Client setup needed — requires friends to install an app:

Tailscale — free, excellent latency, requires client
ZeroTier — free, virtual LAN, requires client

Advanced Docker Config ADVANCED

For services that need to run alongside StardropHost but aren't tunnel providers — for example Certbot (HTTPS), a reverse proxy, or other infrastructure tools. These are added directly to your docker-compose.yml via SSH on your host machine.

⚠ Advanced — modifying docker-compose.yml incorrectly can break your stack. Take a backup first.

Advanced docker features coming to the dashboard soon — no more SSH required.

Server

Server Status

Running

Remote Status

Connected

Updates

Update check interval

How often to check for panel and game updates (hours). Leave empty to disable.

Backup

Auto Backup

Max Backups

Backup Frequency (hours)

How often to back up saves. 24 = once a day.

Performance

CPU Limit

Memory Limit

Advanced Settings VNC · Stability · Monitoring · Admin

VNC & Display Settings

VNC Password

Max 8 characters

Disable Rendering when VNC is off

Turns off the display server when VNC is not active. Saves CPU.

Display Resolution

Target FPS

Cap the game frame rate. Leave blank for uncapped.

Stability

Auto Crash Restart

Max Restarts

Monitoring

Log Monitor

Metrics Port

Change Admin Credentials

New Username (optional)

Current Password

New Password

Confirm New Password

Requirements

• Username: at least 3 characters (letters, numbers, _ . -)

• Password: minimum 8 characters

• New passwords must match

Danger Zone

Delete Farm & Restart Setup

Permanently deletes all save data and relaunches the setup wizard. Game files and mods are kept.

Feedback & Support

Found a bug or have a feature request? Open an issue on GitHub.

Please select the appropriate label when submitting — Bug or Feature Request.

Join the StardropHost Discord for support, updates and community.

Current Instance

Stardrop Farm

Port 18642

Riverdale Farm

Online · 1 player

192.168.0.160

Port 18643

Chat

2m ago

Remote alias

Connect to Setup

—

192.168.0.160

Port 18644

Remote alias