Skip to content

FleetPilot v1.8.0 Beta 1

Pre-release
Pre-release

Choose a tag to compare

@ChristianHandy ChristianHandy released this 15 Oct 02:22
· 94 commits to main since this release
3960203

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

  1. Download FleetPilot-android-1.7.1-beta.1.apk below (Assets) and open it on your phone. Android asks you to allow installing apps from your browser or file manager.
  2. In FleetPilot, create an API token: Sign-in & security → API tokens.
  3. In the app, enter your FleetPilot address (for example https://192.168.1.62) and the token.
  4. 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.

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