https://opensoho.github.io/Recent content on OpenSOHOHugoenhttps://opensoho.github.io/docs/getting-started/Mon, 01 Jan 0001 00:00:00 +0000https://opensoho.github.io/docs/getting-started/Overview Setting up OpenSOHO requires a few simple steps: Install OpenSOHO on your server. Install the OpenWisp packages on your OpenWRT devices. Configure OpenWisp on each OpenWRT device to connect to OpenSOHO. Start configuring in OpenSOHO! Install OpenSOHO Download the latest OpenSOHO release (or use a Docker container) from GitHub Releases. Choose a shared secret that allows OpenWRT devices to register with OpenSOHO. Use a long random string — it must match what you configure in LuCI.https://opensoho.github.io/docs/containers/Mon, 01 Jan 0001 00:00:00 +0000https://opensoho.github.io/docs/containers/Docker / Podman Prebuilt OpenSOHO container images are available at github.com/orgs/opensoho/packages. A custom container image can be built using the Dockerfile in the repository. Docker Compose opensoho: image: ghcr.io/opensoho/opensoho:v0.9.0 container_name: opensoho command: serve --http 0.0.0.0:8090 environment: - OPENSOHO_SHARED_SECRET=LoNgExAmPleStrInGoF32cHarActeRs5 volumes: - "./opensoho/pb_data:/ko-app/pb_data" ports: - 8090:8090 restart: unless-stopped Mounting a volume to /ko-app/pb_data preserves your configuration and history across upgrades. Copy the contents of the pb_data directory when migrating. Kubernetes A Helm chart is available, provided by the community.https://opensoho.github.io/docs/vlan/Mon, 01 Jan 0001 00:00:00 +0000https://opensoho.github.io/docs/vlan/Important (read first!) VLAN configuration is tricky to get right, so OpenSOHO applies its configuration in a way that limits possible connection loss. VLAN tagging is only applied when a device’s apply list contains VLAN. Removing vlan does not undo the configuration. LAN remains untagged on all ports (configuring this per-port is a planned feature). The rationale is to keep the network functional when VLAN tagging is enabled. CIDR settings on lan are ignored — forcing those would break the network.https://opensoho.github.io/docs/home-assistant/Mon, 01 Jan 0001 00:00:00 +0000https://opensoho.github.io/docs/home-assistant/The Home Assistant integration can notify you when an OpenWRT device stops checking in with OpenSOHO (the router/AP becomes unhealthy). Create an API User Add an API user in the OpenSOHO admin interface — safer than using your admin account. OpenSOHO access tokens are valid for 3 years. Generate an Initial Token curl -X POST http://192.168.1.1:8090/api/collections/api_users/auth-with-password \ -H "Content-type: application/json" \ -d '{"identity":"name", "password":"PASSWORD"}' This returns a JSON object. Copy the token value for use in Home Assistant.https://opensoho.github.io/docs/openwisp/Mon, 01 Jan 0001 00:00:00 +0000https://opensoho.github.io/docs/openwisp/Configuration Files /usr/sbin/openwisp-update-config /usr/sbin/openwisp-reload-confighttps://opensoho.github.io/docs/faq/Mon, 01 Jan 0001 00:00:00 +0000https://opensoho.github.io/docs/faq/How do I avoid breaking my entire setup? Since OpenSOHO can push configuration to multiple devices at once, deploy changes gradually — especially for VLANs. Set all Devices to Disabled (Enabled = false). Modify one device or one setting (e.g. add VLAN to the Apply list of a Device). Enable one device. Wait for the config to deploy. Check connectivity, then decide your next step. How do I show or hide columns?