Skip to content

Commit 46edfc1

Browse files
authored
Merge pull request #22 from hatlabs/docs/cert-trust-motivation
docs(getting-started): motivate CA trust install
2 parents 4eb879d + b7a5367 commit 46edfc1

1 file changed

Lines changed: 4 additions & 2 deletions

File tree

docs/getting-started/getting-started.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -118,8 +118,10 @@ Once connected, open a browser and navigate to:
118118
- **Dashboard:** `https://halos.local/` — the main Homarr dashboard with links to all installed applications
119119
- **System administration:** `https://halos.local:9090/` — Cockpit for system management, updates, and container apps
120120

121-
!!! note "SSL Certificate Warning"
122-
Your browser will show a certificate warning because HaLOS uses a self-signed certificate. This is expected — accept the warning to proceed.
121+
!!! note "SSL certificate warning"
122+
The first time you open the dashboard or Cockpit, your browser shows a "Not secure" warning. HaLOS signs its web services with a Certificate Authority (CA) it generates on the device itself, and your browser doesn't trust that CA yet. Accept the warning to proceed for now.
123+
124+
To remove the warning for good, install the device's CA on your computer once — afterwards every HaLOS service validates cleanly on every port. Open `https://halos.local/ca/` for a guided, per-platform installer, or see [Trust the device](https://docs.halos.fi/user-guide/trust-the-device/) in the HaLOS documentation.
123125

124126
!!! info "Internet Required on First Boot"
125127
The Cockpit interface is available immediately, but the main dashboard and other container-based applications require an internet connection on first boot to download their container images. Connect the HALPI2 to the internet via Ethernet or configure WiFi through Cockpit.

0 commit comments

Comments
 (0)