README

English | 简体中文

<h2 align="center">Flutter Server Box</h2> <div align="center"> <a href="https://cdn.lpkt.cn/donate"></a>

<a href="https://deepwiki.com/lollipopkit/flutter_server_box"></a>

</div> <p align="center"> A Flutter project which provides charts to display Linux, Unix and Windows server status and tools to manage servers.

Especially thanks to <a href="https://github.com/TerminalStudio/dartssh2">dartssh2</a> & <a href="https://github.com/TerminalStudio/xterm.dart">xterm.dart</a>.

</p>

🏙️ Screenshots

<table> <tr> <td></td> <td></td> <td></td> <td></td> </tr> </table>

📥 Installation

Platform	From
iOS	AppStore / GitHub (_NoSign.ipa, unsigned, you need to sign it yourself)
macOS	AppStore / GitHub (.dmg) / brew install --cask server-box
Android	GitHub / CDN / F-Droid / OpenAPK
Linux / Windows	GitHub / CDN

Please only download pkgs from the source that you trust!

🔖 Features

• Status chart (CPU, Sensors, GPU...), SSH Term, SFTP, Docker & Process & Systemd, S.M.A.R.T...
• Platform specific: Bio auth、Msg push、Home widget、watchOS App...
• English, 简体中文; Deutsch @its-tom, 繁體中文 @kalashnikov, Indonesian @azkadev, Français @FrancXPT, Dutch @QazCetelic, Türkçe @mikropsoft, Українська мова @CakesTwix; Español, Русский язык, Português, 日本語 (Generated by GPT)

🆘 Help

<div align="center"> <a href="https://qm.qq.com/q/daCGa7eShG"></a> <a href="https://t.me/lpktg"></a> <a href="https://discord.gg/SsVNbRhK7w"></a> </div>

• 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.

• Asking an AI agent? This repository ships a skill that orients one: installing and using the app, deploying and configuring the monitor agent, bootstrapping the Flutter + Rust + Node environment, and the few facts that explain most "why can't I do X on this server" questions. Add it to whichever agent you use with

  shCopy

  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.

Before you open an issue, please read the following:

1. Paste the entire log (click the top right of the home page) in the issue template.
2. Make sure whether the issue is caused by ServerBox app.
3. Welcome all valid and positive feedback, subjective feedback (such as you think other UI is better) 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

1. Setup Flutter and Rust environments.
2. Clone this repo, run make deps then make run to start the app.
3. Run dart run fl_build -p PLATFORM to build the app.

Translation

• Guide can be found in my blog.
• We need your help! Just feel free to open a PR.

💡 My other apps

• GPT Box - A third-party GPT Client for OpenAI API on all platforms.
• MFuse - a macOS app that exposes remote storage in Finder through File Provider, with a modular backend layer for multiple protocols.
• More - Tools & etc.

📝 License

AGPL v3 lollipopkit & all contributors