Cross-platform installer for Hubble Network developer boards. Flash Nordic and Texas Instruments boards in under 30 seconds.
macOS/Linux:
curl -s get.hubble.com | bashWindows (PowerShell as Administrator):
iex (irm https://get.hubble.com)The installer will:
- Detect your OS and architecture automatically
- Download the appropriate binary for your board
- Run the installer immediately
- Clean up after completion
Note for Windows users: You must run PowerShell as Administrator. Right-click PowerShell and select "Run as administrator".
All binaries are:
- Built from this open-source repository using GoReleaser
- Published as GitHub Releases with checksums
- Downloaded over HTTPS
To verify a binary manually:
- Download the binary and checksum file from Releases
- Verify the checksum matches:
sha256sum -c checksums.txt
The installer requires network access and elevated permissions to:
- Download dependencies (uv, segger-jlink) via your system's package manager
- Flash firmware to your connected developer board via USB
- Communicate with Hubble APIs to register and name your board as a device belonging to your organization
The installer does not:
- Collect telemetry or usage data
- Modify system files outside of standard package manager locations
- Run background processes after completion
Your Hubble credentials (Org ID and API Token) are:
- Passed directly to the board flashing tool
- Never stored on disk
- Never transmitted except to official Hubble APIs over HTTPS
For automated environments, use environment variables instead of interactive prompts:
export HUBBLE_ORG_ID="your-org-id"
export HUBBLE_API_TOKEN="your-api-token"
hubble-installWhen you copy the install command from the Hubble Dashboard, your credentials are included as a base64-encoded string:
curl -s get.hubble.com | bash -s <base64-credentials>This encoding:
- Combines your Org ID and API Token in the format
org_id:api_token - Is not encryption — it simply encodes the credentials for safe URL/shell transport
- Is decoded locally by the installer and never sent to any third party
- Can be decoded with:
echo "<base64-string>" | base64 -d
If the credentials cannot be validated (invalid format or incomplete paste), the installer will prompt you to either retry or enter credentials manually. Learn about API access on our Docs site.
- nRF21540 DK
- nRF52840 DK
- TI CC2340R53 Launchpad
- TI CC2340R5 Launchpad
You may access the firmware image source code for each supported board in the Hubble TLDM repository.
The installer will:
- 🔍 Detect your operating system and architecture
- 🔑 Prompt for your Hubble credentials (Org ID & API Token)
- 🎯 Let you select your developer board from the supported list
- 📦 Install required dependencies:
- macOS: Homebrew, uv, segger-jlink
- Linux: uv, segger-jlink
- Windows: Chocolatey, uv, nrfjprog
- ⚡ Flash your board with the appropriate firmware, or generate .hex binary file with the firmware image (TI)
- ✅ Verify the installation was successful
Total time: < 30 seconds (after dependencies are installed)
The installer uses your platform's standard package manager to install dependencies. If the package manager isn't already installed, the installer will set it up for you. If you prefer not to use a package manager, see Manual Dependency Installation below.
Homebrew is the standard package manager for macOS.
# The installer runs these commands:
brew install astral-sh/tap/uv
brew install --cask segger-jlinkThe installer detects your distribution and uses the appropriate package manager.
# uv is installed via the official installer:
curl -LsSf https://astral.sh/uv/install.sh | sh
# SEGGER J-Link must be downloaded from segger.com
# The installer will guide you through this processChocolatey is a package manager for Windows. The installer will set it up if not present.
# The installer runs these commands:
choco install uv -y
choco install nrfjprog -y # Includes SEGGER J-LinkNote: Windows installation requires Administrator privileges for Chocolatey to function properly.
If you prefer not to use a package manager, you can install the dependencies manually:
uv (all platforms):
curl -LsSf https://astral.sh/uv/install.sh | shOr on Windows PowerShell:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"SEGGER J-Link (all platforms):
Download and install from the official SEGGER website: 👉 https://www.segger.com/downloads/jlink/
Select the appropriate installer for your platform:
- macOS:
JLink_MacOSX_Vxxx_universal.pkg - Linux:
JLink_Linux_Vxxx_x86_64.deb(or.rpmfor Fedora/RHEL) - Windows:
JLink_Windows_Vxxx.exe
Get your Hubble Org ID and API Token from: 👉 https://dash.hubble.com/developer/api-tokens
- Download the appropriate binary for your platform from Releases
- Make it executable (macOS/Linux):
chmod +x hubble-install-* - Run it:
./hubble-install-*
Prerequisites:
- Go 1.21 or later
# Clone the repository
git clone https://github.com/HubbleNetwork/hubble-install.git
cd hubble-install
# Build
go build -o hubble-install .
# Run
./hubble-installhubble-install [flags]
The installer automatically installs these runtime dependencies:
| Dependency | Purpose |
|---|---|
| uv | Fast Python package installer |
| segger-jlink | SEGGER J-Link tools for board flashing |
This is expected. Enter your laptop password when prompted.
Right-click PowerShell and select "Run as administrator" before running the installer.
- Ensure you're using a data-capable USB cable (not charge-only)
- Verify your Org ID and API Token are correct
- Check that the board is properly connected
- Try a different USB port
Restart your terminal to refresh your PATH.
If you have more questions, review the Dash Quick Start guide on the Docs site, or reach out to Hubble Support.
MIT License - see LICENSE file for details.
- 📚 Documentation: https://docs.hubble.com
- 💬 GitHub Issues: https://github.com/HubbleNetwork/hubble-install/issues
Made with 🛰️ by Hubble Network