Stelloauth for Home Assistant
A Home Assistant app (formerly known as an add-on) that runs Stelloauth and
CloakBrowser locally for OAuth setup of the Stellantis Vehicles integration.
The repository supports amd64 and aarch64.
Home Assistant Core
|
| POST http://0031621f-stelloauth:8080/worker
v
+--------------------------------------------------+
| One app / one container |
| |
| Stelloauth 0.0.0.0:8080 |
| | |
| | CDP http://127.0.0.1:9222 |
| v |
| CloakBrowser 127.0.0.1:9222 |
+--------------------------------------------------+
Running both processes in one app gives them the same Supervisor lifecycle and keeps CloakBrowser's CDP port on the container's loopback interface. The app builds locally from source because the CloakBrowser Binary License does not allow this repository to redistribute a derived image containing the proprietary CloakBrowser binary. No prebuilt images are published.
Installation
- Go to Settings → Apps → Install app → ⋮ → Repositories and add
https://git.radixadm.dk/dennis/homeassistant-stelloauth-addon.git. - Install Stelloauth, enable Start on boot and Watchdog, then start the app.
- Follow the complete guide in stelloauth/DOCS.md.
Pinned upstream sources
| Component | Version | Commit / OCI index digest |
|---|---|---|
| Stelloauth | v0.6.0 |
367d4f8c02a3b072c59142c49dffc129edc8548b |
| Stelloauth image contract | v0.6.0 |
sha256:51b2194ec9b80cc484d11c016ec5436a12161277a493afdab7078959966d5aa9 |
| CloakBrowser | 0.5.10 |
f04c23da285b3b3d3cf10c8f9d282e7adc1d52ce / sha256:2ed5b2d047cbdde22cde7ef1a796526c716aadaa5bccbe1db5ade49282b64a76 |
| Go builder | 1.27.1-bookworm |
sha256:69a7b9788769bec032d238959b61854e9ae87f57be9029ec04e9885fabf99195 |
| Stellantis Vehicles | 2026.9.4 |
9e0ef96f8fe478af291da4c38c923ada78d0ebf6 |
The Dockerfile and patches define the build. Supervisor downloads the official CloakBrowser image and builds a local image for internal use only.
License
The repository's original work is licensed under the MIT License; see LICENSE. The proprietary CloakBrowser binary is not included. It remains subject to the separate CloakBrowser Binary License.