Repository navigation
v0.4.0 - Dashboard Login & Bedrock Edition
Important: Create Your Login Right After Upgrading 🔐
Isopod now requires a login. The first person to open the dashboard after upgrading creates the admin account, so open it yourself straight away.
What's New 🚀
- Dashboard Login: A single admin account protects the dashboard, API, and WebSockets. Change your password or log out in Settings > Account (#143).
- No More Privileged Mode: The Isopod container runs its own Docker engine without
privileged: true(#145). - Bedrock Servers: Run a native Bedrock Dedicated Server for phone, console, and Windows players (#66).
- Bedrock Cross-play: One switch installs Geyser and Floodgate on Paper, Purpur, Fabric, and NeoForge servers so Bedrock players can join Java worlds (#66).
- Bedrock Add-ons: Install
.mcpackand.mcaddonfiles, and turn them on or off per world, from the Add-ons tab (#138). - Bedrock Management: Manage the allowlist and operators (#135), see who's online (#136), and read command replies in the console (#137).
- Sleep When Empty: Idle Java servers pause and wake when someone connects (#62).
- CurseForge Modpacks: Create a server from a CurseForge modpack. This needs a free API key (#42).
- Closing Windows: Press Escape or click outside a window to close it (#71).
Bug Fixes 🐛
- Settings' X button now undoes unsaved changes, so a theme you were only trying out no longer stays applied (#71).
- Player names are encoded in avatar URLs (#135).
Security 🔒
- Cross-origin requests and WebSocket connections from other sites are blocked (#144).
- Fixed the CodeQL path, SSRF, and error-exposure alerts in the backend (#66).
- Security audit: passed (0 high/critical; release diff reviewed).
Keep port 8000 on your local network or behind a VPN. Until the admin account exists, anyone who can reach the port can create it, the dashboard uses plain HTTP, and the container's permissions are still enough to reach its host. Cross-play downloads the latest Geyser and Floodgate over HTTPS without a hash check.
Upgrade Instructions 📦
Pull the latest code and rebuild, which also applies the non-privileged compose settings:
git pull && docker compose -f isopod-compose.yml up -d --buildOr use the in-dashboard updater from Settings > Updates.
On CasaOS, older installs with privileged: true keep working. To drop privileged mode, follow the CasaOS guide. Add 19132-19152:19132-19152/udp to your ports if your compose file doesn't have it, or Bedrock players can't connect.
Upgrades from v0.3.0 weren't tested on a real install before this release, so back up your servers first.