Repository navigation
FleetPilot v1.8.0 Beta 1
Pre-release
Pre-release
·
94 commits
to main
since this release
Android app 1.7.1-beta.1
Beta. The first FleetPilot app for Android that works with FleetPilot itself. Please report problems in Issues.
What it does
- Dashboard of your homelab:
- servers reachable
- VMs running
- disk health
- critical and high CVEs
- routers online
- backups OK
- Servers: state of every host; Wake-on-LAN and shutdown.
- Virtual machines: Proxmox VMs and containers; start, shut down, reboot, stop.
- Hardware monitor: live CPU, GPU, RAM, network and fan values; start or stop the stress test.
- Fans: temperatures and RPM; set the speed of each PWM channel.
What you can do depends on your token and your role:
- A read-only token only shows information.
- A read/write token also allows the actions your role permits. Operators can wake and shut down servers, run the stress test and set fans. Admins can also run VM actions.
Requirements
- Android 8.0 or newer.
- This FleetPilot release (1.8.0 Beta 1) or later on the server. The app uses API endpoints added there. With 1.7.0, the server list works without status, and the VM and fan screens report "not found".
Install
- Download
FleetPilot-android-1.7.1-beta.1.apkbelow (Assets) and open it on your phone. Android asks you to allow installing apps from your browser or file manager. - In FleetPilot, create an API token: Sign-in & security → API tokens.
- In the app, enter your FleetPilot address (for example
https://192.168.1.62) and the token. - FleetPilot creates its own certificate, so the app shows its SHA-256 fingerprint the first time:
- Compare it with the fingerprint your browser shows for FleetPilot, or run this on the server:
sudo openssl x509 -in /etc/fleetpilot/tls/fullchain.pem -noout -fingerprint -sha256 - If they match, tap Trust and sign in. From then on the app accepts only this certificate.
- Compare it with the fingerprint your browser shows for FleetPilot, or run this on the server:
Full guide: user guide → Android app.
Security
- The app signs in with a personal API token, never with your password. The token stays in the app's private storage and is excluded from Android backups.
- If the phone is lost, revoke the token under Sign-in & security.
- Nothing is sent to the server before you have confirmed its certificate.
Verify the download
sha256sum FleetPilot-android-1.7.1-beta.1.apk # compare with SHA256SUMS-android.txt
apksigner verify --print-certs FleetPilot-android-1.7.1-beta.1.apk
The APK is signed with FleetPilot's Android release key. Its certificate's SHA-256 is:
7D:45:C1:27:ED:F4:48:B6:D8:CA:47:B7:D3:A1:F3:52:0F:7F:B1:69:14:9D:1B:6A:EA:EB:04:BA:EF:52:17:20
Later versions are signed with the same key and install as updates over this one.
What's Changed
- Make FleetPilot work the community-scripts way (release tarball, root, no git) by @ChristianHandy in #60
- Fix code scanning findings: Duplicati sign-in, hash-pinned dependencies, fuzzing by @ChristianHandy in #61
- README refresh, live demo on GitHub Pages; fix 192.168.1.100 on Home and broken Server update page by @ChristianHandy in #62
- Test: parse <script> blocks with HTMLParser (CodeQL #347) by @ChristianHandy in #63
- Live demo: the real FleetPilot in the browser against an emulated homelab by @ChristianHandy in #64
- Vulnerability (CVE) scan for servers, containers, firewalls and FleetPilot by @ChristianHandy in #65
- Fuzz pull requests with ClusterFuzzLite (Scorecard: Fuzzing) by @ChristianHandy in #66
- Contributing guide, security policy fixes, OpenSSF Best Practices answers by @ChristianHandy in #67
- Harden CI and releases; describe the security and supply-chain measures by @ChristianHandy in #68
- chore(deps): bump androidx.compose:compose-bom from 2024.05.00 to 2026.09.00 in /FleetPilotAndroid by @dependabot[bot] in #69
- chore(deps): bump com.google.code.gson:gson from 2.11.0 to 2.14.0 in /FleetPilotAndroid by @dependabot[bot] in #72
- chore(deps): bump retrofit from 2.11.0 to 3.0.0 in /FleetPilotAndroid by @dependabot[bot] in #70
- chore(deps): bump org.jetbrains.kotlin.android from 1.9.24 to 2.4.20 in /FleetPilotAndroid by @dependabot[bot] in #71
- Project homepage on GitHub Pages; live demo moves to /demo/ by @ChristianHandy in #74
- Fix the CodeQL security-extended findings by @ChristianHandy in #75
- README: OpenSSF Best Practices badge by @ChristianHandy in #76
- Update README.md by @ChristianHandy in #78
- OpenSSF Baseline: governance, design, threat model, dependency and secrets policies by @ChristianHandy in #77
- Keep workflows and tests in the source tarball (Scorecard saw no workflows) by @ChristianHandy in #79
- OpenSSF silver: code of conduct, roadmap, review standards, assurance case by @ChristianHandy in #80
- Enforce the coding standard, strict warnings, SPDX license headers and test coverage by @ChristianHandy in #81
- Android app: make it build again and restore its missing data layer by @ChristianHandy in #83
- Android app: work with FleetPilot itself (API token, pinned certificate) — beta 1.7.1-beta.1 by @ChristianHandy in #84
- apk by @ChristianHandy in #85
Full Changelog: v1.7.0...1.8.0Beta1