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.
Pre-built application packages (.tar.gz) ready to install on your router are available at:
These are compiled from the sample apps in this repository and can be installed via NetCloud Manager's Tools page without any development setup.
git clone https://github.com/cradlepoint/sdk-samples.git
cd sdk-samplesWindows:
python setup_env.pymacOS / Linux:
python3 setup_env.pyFollow these steps to get Kiro (or other IDE) open on this repo, with a working .venv and
your dev router configured. You need Python and Git. No GitHub account is required.
Windows: Download Python 3 from python.org/downloads.
Run the installer and check "Add python.exe to PATH" on the first screen, then click
Install Now. Open a new terminal and verify with python --version.
🪟 Windows: detailed Python setup & PATH troubleshooting (click if python isn't found)
Why can I double-click .py files but
pythondoesn't work in the terminal? This usually means Python was installed from the Microsoft Store, which registers file associations but doesn't always add Python to your system PATH. Follow the steps below to fix it.
- Uninstall existing Python (recommended). Open Settings → Apps → Installed apps, search for Python, and uninstall any entries (including any Python Launcher).
- Download. Go to python.org/downloads and click the large Download Python 3.x.x button.
- Install. Right-click the installer and Run as administrator. On the very first screen check both boxes: "Use admin privileges when installing py.exe" and "Add python.exe to PATH" (this is the critical step). Click Install Now, and if you see a Disable path length limit option at the end, click it.
- Verify. Close and reopen your terminal (PATH changes don't apply to open windows), then run
python --versionandpip --version. - If
pythonstill isn't found: open Settings → Environment Variables → Edit the system environment variables → Environment Variables, select Path under System variables, and confirm these two entries exist (version may differ):C:\Users\<YourUsername>\AppData\Local\Programs\Python\Python3xx\C:\Users\<YourUsername>\AppData\Local\Programs\Python\Python3xx\Scripts\
- If
pythonopens the Microsoft Store: open Settings → Apps → Advanced app settings → App execution aliases and turn OFF both App Installer - python.exe and App Installer - python3.exe. - If
pipis not recognized: runpython -m ensurepip --upgrade.
macOS: Install with Homebrew (brew install python3) or download from
python.org/downloads. Verify with python3 --version.
-
Windows: Download Git for Windows from git-scm.com/download/win and install it (the default options are fine).
-
macOS: install with Homebrew, or run
git --versiononce and accept the prompt to install Apple's command line tools:brew install git
Open a terminal and run these in order. The clone needs no GitHub sign-in — this repo is public.
Windows
git clone https://github.com/cradlepoint/sdk-samples.git
cd sdk-samples
python setup_env.pymacOS / Linux
git clone https://github.com/cradlepoint/sdk-samples.git
cd sdk-samples
python3 setup_env.pysetup_env.py creates .venv, installs dependencies, points the editor's interpreter at
.venv, then asks for your dev router's IP, username, and password (reply skip to do it
later) and checks the connection and Developer Mode.
- Download Kiro from kiro.dev and run the installer.
- When Kiro asks you to sign in, choose one of:
- Ericsson employees — organization identity. Click "Sign in with your organization identity". On the next page, do not enter your email address — click the link below that reads "Sign in via IAM Identity Center instead", then enter the Start URL and Region your IT department gave you.
- Everyone else — social login. Sign in with a Google account to try Kiro for free (50 credits over 30 days).
- To switch accounts later, click the account icon at the bottom of the left sidebar, sign out, and sign back in.
Then, in Kiro (or other IDE), choose Open a Project (or File ▸ Open Folder), select the
sdk-samples folder you just cloned, and click "Yes, I trust the authors" when prompted.
In Kiro, click the Synchronize Changes button (the circular-arrows icon) in the bottom-left
status bar. That pulls the latest changes into your clone. (From a terminal, the equivalent is
git pull.)
You will need a GitHub account to contribute — the free one from github.com/signup is fine. You do not need to fork first. Once you have an app you want to share, run:
Windows
.venv\Scripts\python make.py contribute my_appmacOS / Linux
.venv/bin/python3 make.py contribute my_appmake.py contribute creates your fork automatically, pushes your app, and opens a pull request.
It installs the GitHub CLI for you on first run and signs you in with gh auth login.
You are ready when:
setup_env.pyfinished without errors and created.venv.- Kiro (or other IDE) is open on the
sdk-samplesfolder and you have signed in. - Your dev router is configured in
sdk_settings.ini(or you chose toskipfor now). - Developer Mode is enabled for your router in NetCloud Manager under Tools ▸ Developer Mode Devices. This cannot be enabled from the router's own UI, and deploys are rejected without it.
Then open the Kiro (or other IDE) chat panel and describe what you want to build — for example, "Build a web app that shows WAN status and signal strength for all modems."
| Resource | Link |
|---|---|
| SDK Developer Guide | docs/NCOS_SDK_Developer_Guide.md |
| cp.py Methods Reference | docs/cp_methods_reference.md |
| NetCloud Manager — SDK apps | Tools Tab |
| Third-Party Licenses | THIRD-PARTY-LICENSES.md |
├── apps/ # Sample applications, and where your new apps are created
│ ├── 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).
# Create a new app (created in apps/, path printed when done)
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 into apps/<name>/ |
| 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 |
| contribute | Fork, branch, commit, push, and open a PR for one app |
Ericsson Enterprise Wireless Solutions, Inc. has no obligation under this Agreement to provide support, maintenance, updates, or upgrades for the SDK. Company may modify, deprecate, or discontinue the SDK or any feature at any time. THE SDK IS PROVIDED "AS IS" AND "AS AVAILABLE," WITHOUT WARRANTY OF ANY KIND. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, COMPANY DISCLAIMS ALL WARRANTIES, EXPRESS, IMPLIED, OR STATUTORY, INCLUDING IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND NON-INFRINGEMENT, AND ANY WARRANTY ARISING FROM COURSE OF DEALING OR USAGE OF TRADE. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, COMPANY WILL NOT BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR EXEMPLARY DAMAGES, OR FOR LOST PROFITS, REVENUE, DATA, OR GOODWILL, ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE SDK, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. COMPANY'S TOTAL AGGREGATE LIABILITY ARISING OUT OF OR RELATED TO THIS AGREEMENT WILL NOT EXCEED USD $100.