A cross-platform SSH server manager
MaidKit is a collection of tools used by LittleSheep when acting as a "maid" for servers (i.e., performing server maintenance). The goal is to provide a more convenient way to maintain servers that is non-intrusive — being 100% SSH-based, without installing any software on the server or increasing security risks.
Built with Flutter, MaidKit runs on desktop and mobile platforms alike. Inspired by the Island project's desktop-native approach, it brings the same calm, functional philosophy to server administration.
| Feature | Description |
|---|---|
| Dashboard | Grid of server cards with live status, load, memory, and uptime |
| Activity | Real-time performance charts (CPU, memory, network, disk) |
| Terminal | Full SSH terminal with split panes, drag-and-drop tabs, and command palette |
| File Management | Dual-pane SFTP browser with drag-and-drop transfers and in-app editor |
| Processes | List and kill running processes |
| Services | Systemd unit management (start/stop/enable/disable) |
| Web Servers | nginx and Caddy configuration management |
| Crontab | Edit scheduled tasks |
| Packages | Package management (apt, dnf, and more) |
| Firewall | UFW, firewalld, nftables, and iptables management |
| Port Forwarding | Local and remote tunnel configuration |
- Docker and Podman container management
- Start, stop, restart, pause, kill, and remove containers
- Compose project grouping
- Container image management
- Runtime installation assistance
- Deployment project catalog
- Group compose stacks, web servers, and containers
- Import and export as TOML
- Create and edit reusable shell scripts
- Execute on one or more connected servers
- Streaming output with progress tracking
- AES-GCM 256-bit encrypted credential vault
- PBKDF2 key derivation (310,000 iterations)
- Biometric unlock support
- Encrypted backup archives (.mkb)
- Theme (system/light/dark)
- Language (English / 简体中文)
- Terminal renderer selection (Ghostty libghostty-vt or xterm)
- Connect on startup
- Metrics refresh intervals
- Data export and import
- Flutter SDK installed (SDK ^3.12.2)
- For iOS App Store archives, install Zig 0.15.2 for the vendored Ghostty
terminal library. The current Ghostty source is not compatible with Zig 0.16:
brew install zig@0.15
- For Windows development, install NASM (required by
webcryptonative assets):winget install NASM.NASM
- For Linux development, install additional dependencies:
sudo apt-get update -y sudo apt-get install -y \ ninja-build \ libgtk-3-dev \ libayatana-appindicator3-dev \ keybinder-3.0 \ libnotify-dev
# Install dependencies
flutter pub get
# Run in debug mode
flutter run
# Build release version
flutter build <platform>The bundled Ghostty terminal library is compiled from source for iOS so the
binary is linked by Apple's linker and includes the encryption metadata
required by App Store Connect. After installing zig@0.15, the build hook
selects it automatically when creating an IPA:
flutter clean
flutter pub get
flutter build ipaThe build stops if the generated Ghostty framework lacks
LC_ENCRYPTION_INFO_64, preventing an invalid IPA from being produced.
After changing route annotations or Drift schema:
dart run build_runner buildRun checks before committing:
dart format lib test
flutter analyze
flutter testFeatures are flat and live directly under lib/<feature>/. The app uses:
- Riverpod for state management with
ConsumerWidgetfor reactive views - auto_route for declarative nested navigation
- Drift for local SQLite persistence
- dartssh2 for SSH connections
- island_ui_foundation for the desktop window frame
See docs/architecture.md for the full architecture guide.
| Layer | Technology |
|---|---|
| Framework | Flutter with Material 3 |
| State | Riverpod + flutter_hooks |
| Navigation | auto_route |
| Database | Drift (SQLite) |
| SSH | dartssh2 |
| Encryption | cryptography (AES-GCM, PBKDF2) |
| Terminal | libghostty-vt / xterm |
| Desktop | window_manager + island_ui_foundation |
Contributions are welcome! Please feel free to submit issues or pull requests.
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).
If you deploy an instance, fork this project, or redistribute modified versions of this software, you must comply with the AGPL-3.0 license terms, including:
- Including a copy of the original license
- Preserving existing copyright notices and attribution
- Clearly stating any modifications you made
- Providing corresponding source code to users interacting with the service over a network
Original authorship and copyright attribution to LittleSheep, Solsynth, and this project's contributors must be retained where applicable.
Please note that the AGPL-3.0 license applies to the software source code only. Certain assets, logos, icons, branding materials, and trademarks may be licensed separately and are not automatically covered under the same terms.
See LICENSE.txt for the full license text.
Made by LittleSheep with ❤️