// SYSTEM CONFIGURATION

⚙ Settings

System configuration for Link Star and the SNO backend. Changes are saved to localStorage and must be mirrored in your .env file and backend config to take full effect on the server side.

IDENTITY
KEYCLOAK URL REQUIRED
REALM
CLIENT ID
YOUR USERNAME
NETWORK
SNO BACKEND URL
NETBIRD MANAGEMENT
NETBIRD PERSONAL ACCESS TOKEN
TRUSTED IP PREFIX (Netbird mesh)
⏳ Not yet tested
LOCATION
HOME LATITUDE REQUIRED
HOME LONGITUDE REQUIRED
GEOFENCE RADIUS (metres)
STARLINK IP PREFIX
LORA BEACON NODE ID
HELTEC WIFI IP (beacon sender)
GPS Setup → Beacon Setup →
SECURE EMAIL
Link Star uses IMAP to fetch mail from your configured server. All mail traffic stays inside the Netbird mesh. Recommended provider: Mailcow self-hosted on the same Raspberry Pi.
MAIL BACKEND URL
IMAP HOST REQUIRED
IMAP PORT
EMAIL ADDRESS REQUIRED
APP PASSWORD REQUIRED
PROVIDER PRESETS
Open Secure Mail →
⏳ Not yet tested
ALERTS & NOTIFICATIONS
WHATSAPP NUMBER RECOMMENDED
ALERT EMAIL
AUTO-LOCKDOWN TRIGGERS
SAVE ALL SETTINGS
Backend settings (IMAP password, Netbird token, Keycloak URL) must also be updated in your .env file on the Raspberry Pi and the containers restarted. Settings saved here apply to the browser client only.
SYSTEM LINKS
ENVIRONMENT FILE REFERENCE
Your .env file on the Raspberry Pi — update and restart containers when changed.
# Identity
KC_ADMIN_PASS=your_strong_password
KC_HOSTNAME=sno.yourdomain.com

# Database
PG_PASS=your_strong_password

# Netbird
NETBIRD_TOKEN=nbp_your_token_here

# Location
HOME_GPS_LAT=50.700000
HOME_GPS_LON=-4.000000
HOME_GPS_RADIUS_M=500
TRUSTED_IP_PREFIX=100.

# Mail (IMAP)
MAIL_IMAP_HOST=localhost
MAIL_IMAP_PORT=993
MAIL_IMAP_USER=[email protected]
MAIL_IMAP_PASS=your_app_password

# Alerts
WA_PHONE_NUMBER_ID=your_wa_phone_id
WA_ACCESS_TOKEN=your_wa_token
EMAIL_FROM=[email protected]
EMAIL_PASS=gmail_app_password
EMAIL_TO=[email protected]