Skip to content

Releases

v1.4.0 — Reverse proxy authentication

Choose a tag to compare

@Juju-archy Juju-archy released this 10 Nov 17:17
8e04034

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+)

Choose a tag to compare

@Juju-archy Juju-archy released this 08 Nov 09:49
1bdb22a

⚠️ 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

Choose a tag to compare

@Juju-archy Juju-archy released this 05 Nov 21:05

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

Choose a tag to compare

@Juju-archy Juju-archy released this 05 Nov 20:59
1bdb22a

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 to https://
  • 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

Choose a tag to compare

@Juju-archy Juju-archy released this 25 Oct 14:11
d5617cc

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

Choose a tag to compare

@Juju-archy Juju-archy released this 17 Oct 10:33

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

Choose a tag to compare

@Juju-archy Juju-archy released this 11 Oct 10:31

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