Overview
The Settings page lets you configure how Organism operates — from Docker connection details to update behaviour and notification preferences.
Navigate to Settings by clicking Settings in the sidebar.
Docker Connection
Organism communicates with your container engine (Docker or Podman) through a socket connection.
| Setting | Default | Description |
|---|---|---|
| Socket Path | Auto-detected | Path to the Docker/Podman socket (e.g. /var/run/docker.sock) |
| Connection Status | — | Shows whether Organism can reach the container engine |
Troubleshooting Connection Issues
If the Docker connection shows as disconnected:
- Docker Desktop — ensure Docker Desktop is running (check the menu bar icon)
- Podman — ensure the Podman machine is started (
podman machine start) - Socket permissions — the Organism container needs access to the socket; check that the volume mount is correct
Health Check Settings
Control how frequently Organism checks the health of your containers:
| Setting | Default | Description |
|---|---|---|
| Health Check Interval | 30 seconds | How often Organism polls container health |
Choosing an Interval
- Lower values (10–15s) — faster detection of problems, slightly higher resource usage
- Default (30s) — good balance of responsiveness and efficiency
- Higher values (60s+) — lower resource usage, slower problem detection
Notification Preferences
Control which events trigger notifications:
| Notification Type | Default | Description |
|---|---|---|
| Container State Changes | On | Alerts when containers start, stop, or crash |
| Update Available | On | Notifies when app updates are available |
| Health Check Failures | On | Alerts when a container fails its health check |
| System Messages | On | Messages from WiseJNRS (announcements, maintenance) |
Notifications appear in the Notifications page and as badges in the sidebar.
Organism URL
The URL that Organism uses to communicate with WiseJNRS services:
| Setting | Default | Description |
|---|---|---|
| Organism URL | https://www.wisejnrs.net | Base URL for the WiseJNRS API |
This should not need to be changed unless you're running a custom WiseJNRS instance or testing in a development environment.
Auto-Update
Configure automatic update behaviour:
| Setting | Default | Description |
|---|---|---|
| Auto-Update Check | On | Periodically checks for new versions of installed apps |
| Check Interval | Every hour | How often to check for updates |
When an update is detected, it appears as a badge on the Installed Apps page. Updates are never applied automatically — you always choose when to update.
Checking for Updates Manually
Click the Check for Updates button to immediately scan all installed applications for new versions. This queries both the WiseJNRS API and Docker registries.
System Information
The System Information section shows details about your Organism installation:
| Field | Description |
|---|---|
| Organism Version | Current version of the Organism platform |
| Container Engine | Docker or Podman, and its version |
| Platform | Operating system and architecture |
| Uptime | How long Organism has been running |
| API Port | Port the Organism API is listening on |
| Web Port | Port the web dashboard is served on |
Saving Changes
Changes to settings are saved immediately when you modify them. A success toast notification confirms the save. Some changes (like the health check interval) take effect on the next check cycle.
Related Documentation
- Dashboard — System overview
- Monitoring — Resource usage charts
- Notifications — Manage alerts
- Account — Profile and security settings