Extend your Ericsson routers with custom Python applications.
The NCOS SDK enables developers to build and deploy Python applications that run directly on Ericsson Cradlepoint NetCloud OS (NCOS) routers. Create custom logic for connectivity management, IoT data collection, monitoring, automation, and more—without replacing hardware.
- Extend without hardware changes — Add new capabilities through software while your existing Ericsson/Cradlepoint fleet stays in place.
- Access router internals — Query modem signal strength, WAN status, GPS, connected clients, and system metrics via a Python API.
- Integrate with your stack — Push data to cloud platforms (Azure IoT, Splunk, MQTT), trigger alerts, or automate workflows based on router state.
- Deploy at scale — Build once, distribute via NetCloud Manager to thousands of devices with group-based assignment.
- Standard Python — Use familiar libraries and patterns; the SDK provides a simple
cpmodule for router interaction.
| Resource | Link |
|---|---|
| SDK Developer Guide | docs/NCOS_SDK_Developer_Guide.md |
| NetCloud Manager — SDK apps | Tools Tab |
| Third-Party Licenses | THIRD-PARTY-LICENSES.md |
├── apps/ # Sample applications (flat, tagged via package.ini)
│ ├── 5GSpeed/ # Each app is a self-contained folder
│ ├── hello_world/ # with package.ini, start.sh, readme.md, etc.
│ ├── mqtt_app/
│ ├── ... # 75+ apps total
│ ├── templates/ # app_template, web_app_template
│ └── archive/ # Retired/inactive apps
├── docs/ # API documentation
├── make.py # Build/deploy tool
└── sdk_settings.ini # Router connection settings
Apps are categorized using the tags field in their package.ini (e.g., tags = connectivity, speedtest).
Prerequisites
- Python 3.9 or higher — Windows users, see the Windows Python Setup Guide
- Git (optional, for cloning the repository)
In Kiro, open the Command Palette and select Git: Clone, then paste:
https://github.com/cradlepoint/sdk-samples.git
Once the repo opens, click the Setup Dev Environment hook in the Kiro sidebar. It handles everything automatically.
git clone https://github.com/cradlepoint/sdk-samples.git
cd sdk-samplesmacOS / Linux:
python3 setup_env.py && source .venv/bin/activateWindows:
python setup_env.py && .venv\Scripts\activateThis creates a .venv virtual environment, installs all Python dependencies, and activates the venv.
Edit sdk_settings.ini with your dev router's IP and credentials:
[sdk]
app_name=hello_world
dev_client_ip=192.168.0.1
dev_client_username=admin
dev_client_password=your_password# Create a new app
python3 make.py create my_app
# Build a single app (searches apps/ recursively)
python3 make.py build my_app
# Build all apps
python3 make.py build all
# Deploy to connected router (purge + build + install + start)
python3 make.py deploy my_app
# Check status
python3 make.py status my_app| Action | Description |
|---|---|
| create | Scaffold a new app from app_template |
| build | Package an app as .tar.gz for deployment |
| deploy | Full lifecycle: purge → build → install → verify |
| status | Show app state on the connected router |
| start / stop | Control a running app |
| uninstall | Remove app from router |
| clean | Remove local build artifacts |
This software, including any sample applications, and associated documentation (the "Software"), are subject to the Cradlepoint Terms of Service and License Agreement available at https://cradlepoint.com/terms-of-service ("TSLA").
NOTWITHSTANDING ANY PROVISION CONTAINED IN THE TSLA, CRADLEPOINT DOES NOT WARRANT THAT THE SOFTWARE OR ANY FUNCTION CONTAINED THEREIN WILL MEET CUSTOMER'S REQUIREMENTS, BE UNINTERRUPTED OR ERROR-FREE, THAT DEFECTS WILL BE CORRECTED, OR THAT THE SOFTWARE IS FREE OF VIRUSES OR OTHER HARMFUL COMPONENTS. THE SOFTWARE IS PROVIDED "AS-IS," WITHOUT ANY WARRANTIES OF ANY KIND. ANY USE OF THE SOFTWARE IS DONE AT CUSTOMER'S SOLE RISK AND CUSTOMER WILL BE SOLELY RESPONSIBLE FOR ANY DAMAGE, LOSS OR EXPENSE INCURRED AS A RESULT OF OR ARISING OUT OF CUSTOMER'S USE OF THE SOFTWARE. CRADLEPOINT MAKES NO OTHER WARRANTY, EITHER EXPRESSED OR IMPLIED, WITH RESPECT TO THE SOFTWARE. CRADLEPOINT SPECIFICALLY DISCLAIMS THE IMPLIED WARRANTIES OR CONDITIONS OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE OR NON-INFRINGEMENT.
Copyright © 2018 Cradlepoint, Inc. All rights reserved.