Repository navigation
Releases
v0.4.1 - Honest Update Instructions
Important: Update From the Command Line 🔄
Update Now in v0.4.0 and older doesn't work on standard Docker installs. It restarts the old version, then the dashboard reports the new one. If you clicked it to get v0.4.0, you're probably still on your previous version, without the login. Use the commands under Upgrade Instructions, which also apply the non-privileged settings from v0.4.0.
Bug Fixes 🐛
- The dashboard now reports the version it's actually running, and ignores the version older releases saved (#170).
- When Isopod can't update itself, Settings > Updates shows the commands to run on the host in place of Update Now (#170).
Security 🔒
- Security audit: passed (0 high/critical; release diff reviewed).
Upgrade Instructions 📦
Back up your servers first. Upgrades from older versions haven't been tested on a real install. Then, in the folder you cloned Isopod into, on the machine hosting it:
git pull
docker compose -f isopod-compose.yml up -d --buildOn macOS, leave out -f isopod-compose.yml.
Coming from v0.3.0 or older? Isopod now requires a login, and the first person to open the dashboard creates the admin account, so open it right after upgrading.
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.
v0.3.0 - Backups, Crash Watchdog & Live Player Management
What's New 🚀
- World Backups: Scheduled and on-demand world backups with a configurable backup folder, retention, and a clearer restore flow (#32).
- Automatic Snapshots: Instances are snapshotted before mod, loader, and version changes, so a bad change can be rolled back (#91).
- Crash Watchdog: Crashed servers restart automatically with crash-loop protection, and a crash report inspector shows what went wrong (#67, #57).
- Live Player Management: See who's online and kick, ban, op, whitelist, message, or teleport them. The ban list now supports unbanning (#90).
- Resource Usage: CPU and RAM usage per server and across all servers (#38).
- Purpur & Folia: Two new server types. Paper-family servers are now treated as plugin servers (#85, #86).
- Multi-Select Mods: Ctrl/Shift click to select several mods and act on them at once (#70).
- Modrinth Modpacks: Modpack mods are listed before the server's first start, and mods itzg skipped are hidden once the pack is installed (#69).
- macOS Support: Run Isopod on macOS (including Apple Silicon) via a compose overlay, without affecting CasaOS (#92).
- MEOW: A cat button, as a homage to Prism Launcher, that toggles a MEOW background (#18).
Bug Fixes 🐛
- Show a lost-connection state when the backend is unreachable (#103).
- Report failures from instance actions instead of failing silently (#102).
- The Edit window has one save model per tab and asks before discarding changes (#101).
- Remove a hardcoded player list from User Management autocomplete (#111).
- The Folders browser no longer crashes on a response without a path (#78).
- The Add Instance group dropdown works, and groups load on startup (#72).
- Console command output always shows in Simplified log mode (#95).
- Whitelist/ops UUIDs are saved in dashed form (#93).
- Backup schedule changes save immediately.
Security 🔒
- A security audit (dependency audits, Bandit, CodeQL, gitleaks, Trivy, zizmor) now runs on every PR and release (#118).
- The container image ships a current Docker CLI and no longer includes pip/setuptools.
- Security audit: passed (0 high/critical; release diff reviewed).
Upgrade Instructions 📦
Pull the latest code and rebuild:
git pull && docker compose -f isopod-compose.yml up -d --buildOr use the in-dashboard updater from Settings > Updates.
v0.2.0 - Update World & Self-Updating Dashboard
What's New 🚀
- Update World: When a newer Minecraft release is available for an instance, an Update button now appears so you can upgrade in one click (#30).
- Self-Updating Dashboard: The system updater shows a progress overlay, automatically reloads once the new version's health check passes, and syncs the displayed version afterward (#60).
- Context-Aware Help Buttons: Help buttons deep-link into the wiki for the section you're working in (#28).
- Windows Launch Helper:
scripts\start-isopod.ps1opens the dashboard in your default browser once Docker Compose is up (#13). - Pointer Cursor: All clickable elements now show the hand cursor (#74).
Bug Fixes 🐛
- Fix mod search returning no results when adding mods to a modpack (#48).
- Fix New Instance icon picker not responding to clicks (#47).
- Fix instance name and icon not updating when a modpack is reselected (#33).
- Fix newly created or imported instances not being auto-selected (#36).
- Fix search results not refreshing when filters change (#35).
- Fix the New Instance Help button to open the Isopod documentation (#28).
- Fix updater not following redirects when checking GitHub releases.
- Fix updater version not persisting after an update.
Developer Changes 🛠
- Added a Playwright E2E suite covering the dashboard, settings, and add-instance modal (#71).
Upgrade Instructions 📦
Pull the latest code and rebuild:
git pull && docker compose -f isopod-compose.yml up -d --buildOr use the in-dashboard updater from Settings > Updates.
v0.1.0 - Desktop-Grade File Explorer
What's New 🚀
-
Desktop-Grade File Explorer (#59):
- Right-Click Context Menu: Full context menu with actions for New File, New Folder, View/Open, Rename, Delete, Cut, Copy, Paste, and Download.
- Drag-and-Drop Operations: Internal moves onto folder rows or breadcrumb segments with clear drop target highlighting, plus direct drag-and-drop uploads from desktop file explorers.
- Inline Editing: Desktop-grade in-place renaming and file/folder creation directly within table rows (
Enterto save,Escto cancel). - Multi-Selection & Batch Actions: Multi-select support (
Ctrl+A,Shift+Click,Ctrl/Cmd+Click) with batch download, cut, copy, and delete. - Conflict Handling: Conflict modal prompts to Overwrite, Keep Both (Auto-Rename), or Cancel on naming collisions.
- Keyboard Accessibility: Shortcuts for
Del,F2,Ctrl+C,Ctrl+X,Ctrl+V,Ctrl+A, andEsc. - Global & Instance Parity: Fully supported in both the Server Editor Files tab and the Global Folders browser.
-
Backend File Management APIs:
- Path-traversal protected endpoints for creating, renaming, moving, copying, deleting, uploading, and on-the-fly ZIP compression downloads.
-
Documentation Updates:
- Added File Explorer features and keyboard shortcuts to
README.mdandDocumentation/everyone/getting-started.md. - Enhanced GitHub Releases skill to include automatic documentation synchronization on release.
- Added File Explorer features and keyboard shortcuts to
Upgrade Instructions 📦
Pull the latest image or rebuild your containers:
docker compose -f isopod-compose.yml up -d --build