Skip to main content

Installation Guide

This guide walks through the process of deploying EmberNet on your edge infrastructure.

Prerequisites​

Before beginning installation, ensure you have:

  • Hardware meeting the system requirements
  • Enterprise Linux distribution installed on all target nodes
  • Network connectivity (outbound HTTPS on port 443)
  • DNS resolution and NTP time synchronization configured
  • Administrative (root) access to all target nodes

Installation Overview​

The EmberNet installation process consists of the following stages:

  1. Node Preparation — OS configuration and prerequisite installation
  2. Edge Runtime Setup — Deploy the container orchestration runtime
  3. Platform Deployment — Install the EmberNet platform services
  4. Mesh Enrollment — Connect the node to the zero-trust mesh network
  5. Tenant Configuration — Set up initial tenant and user accounts
  6. Validation — Verify the deployment

Step 1: Node Preparation​

Update the Operating System​

Ensure the operating system is up to date with the latest security patches.

Configure Networking​

  • Assign a static IP address or DHCP reservation to each node
  • Verify outbound HTTPS connectivity
  • Configure DNS resolution
  • Synchronize system clock via NTP

Configure Storage​

  • Allocate dedicated storage volumes for telemetry data
  • Configure storage according to your retention requirements

Step 2: Edge Runtime Setup​

The EmberNet installer will configure the container orchestration runtime automatically. The runtime manages all platform services as containerized workloads.

info

The installer handles all runtime configuration. No manual container orchestration setup is required.

Single-Node Installation​

For single-node deployments, run the EmberNet installer on the target node. The installer will configure the runtime, deploy platform services, and enroll the node into the management plane.

Multi-Node Cluster​

For high-availability deployments:

  1. Install the first node as the cluster primary
  2. Run the installer on additional nodes with the cluster join token
  3. Verify cluster health from the management dashboard

Step 3: Platform Deployment​

Once the runtime is operational, the EmberNet platform services are deployed automatically:

  • Data Ingestion Service — Collects telemetry from connected devices
  • Time-Series Database — Stores historical metric data
  • Dashboard Service — Web-based monitoring interface
  • Alert Engine — Evaluates alert rules and dispatches notifications
  • API Gateway — Provides the REST API for programmatic access
  • Mesh Agent — Manages zero-trust network connectivity

Step 4: Mesh Enrollment​

Each edge node is enrolled into the zero-trust mesh network during installation:

  1. The installer generates a unique node identity
  2. The node establishes an encrypted connection to the mesh controller
  3. The mesh controller issues certificates and routing policies
  4. The node joins the mesh and becomes accessible to authorized services

Step 5: Tenant Configuration​

After deployment, configure the initial tenant:

  1. Log into the EmberNet dashboard at the node's IP address
  2. Create the first tenant with a name and admin contact
  3. Set up an administrator account with email and password
  4. Configure initial device groups and tag hierarchies

Step 6: Validation​

Verify the deployment by checking:

  • All platform services report healthy status
  • The dashboard is accessible via web browser
  • Mesh network connectivity is established
  • Time-series database is receiving data
  • Alert rules can be created and tested

Troubleshooting​

If you encounter issues during installation:

Next Steps​