App Settings
Global application settings, Java runtimes, network configuration, and daemon logs.
The App Settings panel (accessible from the bottom of the sidebar) controls global Cliff configuration that applies to all servers.
General tab
CurseForge API
CurseForge integration is planned for a future update. The General tab shows a placeholder for this section. Modrinth — the currently supported mod source — works without any API key.
Versions
The General tab displays cached Minecraft version information:
- Latest release — The newest stable Minecraft version
- Latest snapshot — The newest snapshot version
- Total Mojang versions — How many versions are available
- Per-type counts — Supported version counts for Vanilla, Paper, Purpur, Folia, and each modded loader (Fabric, Forge, NeoForge)
Click Refresh versions to force a re-download of the latest version lists from Mojang and the loader providers.
Java Runtimes
Cliff can detect and manage Java installations on your machine. The Java tab shows all detected runtimes with their version and path.
Installing a runtime
- Click Install runtime
- Select a Java version (17 or 21 recommended for modern Minecraft)
- Cliff downloads and installs the runtime
This is useful if your machine doesn't have Java installed, or if you need a specific version for an older Minecraft version.
Uninstalling a runtime
- Find the runtime in the list
- Click Uninstall
- Confirm
Note
You can't uninstall a runtime that's currently in use by a running server.
Java version requirements
| Minecraft version | Required Java |
|---|---|
| 1.20.5+ | Java 21+ |
| 1.18 – 1.20.4 | Java 17+ |
| 1.17 | Java 16+ |
| 1.16.5 and below | Java 8+ |
Network & Storage
Paths
Shows where Cliff stores its data on disk:
- Server storage root — The directory containing all your server folders
- Panel data directory — Where Cliff stores its own configuration and metadata
Storage
A summary of disk usage:
- Root — Total size of the server storage root
- Snapshots — Space used by all snapshots across servers
- Free — Available disk space
- Registered servers — Combined size of registered servers
- Backups — Number of backups stored
- Disk total — Total disk capacity
Network access
Shows the addresses where the dashboard is reachable:
- Dashboard addresses — One entry per detected LAN IPv4 address, in the form
<ip>:<port>(e.g.192.168.1.100:8080) - Backend — The URL the dashboard frontend uses to communicate with the daemon
If no LAN IPv4 address is detected, a warning is shown.
Logs
The logs tab shows the Cliff daemon's internal logs, which are useful for debugging.
- Live buffer — Shows the recent in-memory log buffer
- Full log file — Loads the complete log file from disk
The toolbar provides three actions:
- Copy — Copies the current log lines to your clipboard
- Refresh — Reloads the log buffer
- Download — Exports the daemon logs as a text file (useful when reporting issues or seeking support)
If a log file path is configured, it's shown at the top of the panel.
Account settings
Accessible from the sidebar separately from App Settings:
- Change username — Update your admin account username
- Change password — Set a new password (requires current password, minimum 10 characters)