ServerBox

English | 简体中文

Flutter Server Box

A Flutter project which provides charts to display Linux, Unix and Windows server status and tools to manage servers.
Especially thanks to dartssh2 & xterm.dart.

Read the documentation site for user guides, architecture notes, and development instructions.

Screenshots

iPhone — 11 screenshots

iPad — 10 screenshots

macOS — 10 screenshots

Installation

Platform	Download
iOS	AppStore / GitHub (_NoSign.ipa, unsigned, you need to sign it yourself)
macOS	App Store (Apple silicon only) / GitHub (architecture-specific .dmg) / brew install --cask server-box
Android	GitHub / CDN / F-Droid / OpenAPK
Linux / Windows	GitHub / CDN

Download packages only from sources you trust.

Features

• Status charts for CPU, sensors, GPU, and other metrics; an SSH terminal; SFTP; RDP and VNC through SSH; Docker, process, and service management; and S.M.A.R.T.
• Platform features include biometric authentication, push notifications, home-screen widgets, watchOS support, and system color themes.
• 16 languages. The current list is in lib/l10n/; its git history records the translators.

Help

• ServerBox Monitor is an agent you install on your servers. It is required for anything that has to work while the app is closed — message push, home widgets and the watch app — and it is also a second way to add a server: the app can reach it over HTTP instead of SSH, which suits hosts whose SSH port you would rather not expose, and gives charts a history from before the app ever connected. It serves a web panel of its own too. See its README for setup and for what each remote-access switch grants.

• Common issues can be found in app wiki.

• Agent onboarding: This repository includes a skill for installing and using the app, deploying and configuring Monitor agent, setting up the Flutter + Rust + Node environment, and answering common server-management questions. Add it to your agent with

  npx skills add lollipopkit/flutter_server_box
  

  The source is .claude/skills/serverbox-onboarding, so you can read what it will tell your agent before installing it.

Check these points before opening an issue:

1. Paste the entire log (click the top right of the home page) in the issue template.
2. Confirm that the issue is caused by ServerBox.
3. Concrete, constructive feedback is welcome. Subjective requests, such as preferring another UI, may not be accepted.

After you read the above, you can open an issue.

Contributions

Any positive contribution is welcome. CONTRIBUTING.md covers the development setup, the commit convention, the checks to run, and how translations work.

Contributors sign the CLA (中文) once, by leaving a single comment on their first pull request. It grants the right to ship your work in the App Store builds alongside the AGPLv3 source — you keep the copyright to what you wrote.

If I forgot to add your name to the contributors list, please add a comment in the issue or PR you opened to let me know, I will add it as soon as possible.

Development

• Read the development guide.
• Follow the build guide for platform requirements and release builds.
• See CONTRIBUTING.md for local setup, checks, commits, and translations.

Translation

• Translation contributions are welcome. See CONTRIBUTING.md for the workflow.

License

AGPL v3 lollipopkit & all contributors