Repository navigation
Releases
v1.4.0 — Reverse proxy authentication
What's new
Reverse proxy authentication (#8)
If your TrueNAS is behind an authenticating reverse proxy, open "Reverse proxy (advanced)" on the login screen and choose:
- Basic auth: Pangolin header auth, nginx, Traefik, Caddy, Authelia…
- Cloudflare Access: service token (Client ID + Client Secret)
The credentials are sent only as headers on the WebSocket handshake to your server (again on every reconnect), over HTTPS only. They are never sent to the app icon CDN.
Clearer errors
When the proxy refuses the connection or shows its own login page, the app now says so explicitly instead of the generic "Couldn't reach the server". This case no longer triggers the local network permission notice by mistake.
Requirements
- TrueNAS Scale 25.04 or later (unchanged since 1.3.0)
- Android 15+ (minSdk 35)
Full Changelog: v1.2.2...v1.4.0
v1.3.0 — WebSocket JSON-RPC API (TrueNAS 25.04+)
⚠️ Breaking change: TrueNAS SCALE 25.04 or later required
The app now talks to TrueNAS over its WebSocket JSON-RPC API (/api/current) instead of the REST
API (/api/v2.0). TrueNAS deprecated REST in 25.04 and removes it in TrueNAS 27, and 25.10.1+
already warns about its use.
TrueNAS SCALE 24.10 and earlier can no longer connect. If your server runs one of these
versions, stay on v1.2.2 until you upgrade it.
Tested on TrueNAS SCALE 25.10.
What's new
- API key login: paste a TrueNAS API key in the password field to log in with it instead of
your password. Only over HTTPS: an API key is never sent over an unencrypted connection. - More robust connection: a single authenticated session per login, which reconnects on its
own after a network drop. If the server refuses your credentials on reconnect (password
changed, API key revoked), you are signed out instead of silently retrying. - Apps: the Start/Stop button alone now shows whether an app is running (the status dot is
gone; still announced to screen readers).
Under the hood
- All dashboard, reporting, alerts, apps and system calls moved to their JSON-RPC equivalents.
- The Android 17 local network notice from 1.2.2 still works with the new connection.
- New unit tests for the RPC client and the local network regression.
Thanks
Huge thanks to @naorleizer, who proposed and built this migration (#6) and tested it end-to-end
on TrueNAS SCALE 25.10 and Android 17.
Full changelog: v1.2.2...v1.3.0
v1.2.2 – Android 17: local network permission fix
Bug-fix release for Android 17.
🛜 Reaching a NAS on your local network on Android 17
Android 17 introduces Local Network Protections: apps targeting SDK 37 can't open connections
to LAN addresses (e.g. 192.168.x.x, 10.x.x.x) until the user grants the new
ACCESS_LOCAL_NETWORK permission ("Nearby devices / local network"). As a result, logging in
to a TrueNAS server on the local network simply timed out, with no explanation (#5).
What changes:
- The permission is declared, and requested the first time you tap "Log in"
- Login is never blocked by it: an address reached over the Internet or a VPN doesn't need it,
so the login attempt goes ahead whatever your answer - If a NAS on your local network can't be reached while the permission is missing, a notice
explains why, with an "Allow access" button (or "Open settings" if the system no longer
shows the prompt), on both the login screen and the dashboard - No change on Android 16 and earlier, where this permission doesn't exist
🧹 Under the hood
- The "Log in" button can no longer start a connection with empty fields
- New unit tests for detecting network errors
Full Changelog: v1.2.1...v1.2.2
v1.2.1 – Security: Android Keystore encryption & HTTPS-only app icons
Security-focused maintenance release. No new features.
🔐 Saved credentials now encrypted with the Android Keystore
The deprecated, no-longer-maintained androidx.security:security-crypto library has been removed
(it also pulled in an old Tink 1.8.0). Credentials saved with "Stay logged in" are now encrypted
directly by the app with AES-256-GCM, using a non-extractable key stored in the Android Keystore.
The app no longer uses any third-party crypto library.
⚠️ One-time re-login required: if "Stay logged in" was checked, the old saved session is
deleted on first launch after the update, so you'll need to log in once more.
The new session file stays excluded from cloud backup and device transfer: a restored copy
couldn't be decrypted on another device anyway.
🖼️ App icons are only downloaded over HTTPS
http://icon URLs are automatically upgraded tohttps://- Any other scheme is refused
- HTTPS → HTTP redirects are blocked
(Icons still go through a separate HTTP client that never sends your NAS credentials.)
🧹 Under the hood
- Tink and its R8 keep rule are removed from the release build
- Dependency audit: 114 runtime dependencies checked against OSV.dev, no known CVE
- New unit tests for the session encryption and the icon URL handling
Full Changelog: v1.2.0...v1.2.1
v1.2.0 - Start/Stop application
New
- Apps screen: start and stop apps directly from the list — ■ to stop a running app, ▶ to
start a stopped one. Stopping asks for confirmation first. - App status is now shown as a green (running) / red (stopped) dot.
Full changelog: v1.1.0...v1.2.0
Avant de publier :
- APK signé : construis le build release signé, comme pour la 1.1.0. Ta procédure de signature est notée dans SECURITY_TODO.md.
- Version : l'écran « À propos » ou les infos de l'app sur le téléphone doivent afficher 1.2.0 (code 4).
- Changelogs : les fichiers 4.txt sont sur main, donc F-Droid et les stores qui lisent fastlane les récupéreront automatiquement.
v1.1.0 - System services & app branding
New:
• System screen: new Services section listing the TrueNAS services (SMB, NFS, SSH, FTP, iSCSI, NVMe-oF, SNMP, UPS), each with a status dot and two switches:
– Running: start or stop the service now
– Start auto: start the service automatically at boot
• Changes are only applied when you tap Save modifications, pinned to the bottom of the screen. Unsaved changes are dropped when you leave the screen.
• Login screen and menu: app logo, license (GPL-3.0-or-later) and a link to the source code
Note: this is the first version that can change your NAS configuration (starting/stopping services). The other System sections (General, Network, Boot) are still read-only.
Full Changelog: v1.0...v1.1.0
v1.0.1 – SVG app icons fix
Bug fixes:
• App icons served as SVG (Immich, Jellyfin, Nextcloud...) are now displayed instead of the generic icon
• App icon downloads are now size-limited
Full Changelog: v1.0.1...v1.0.1