NetSpeek Edge Installation Guide
This document outlines the requirements and procedures for installing the NetSpeek Edge, including system prerequisites, port configurations, installation steps, resource planning, and troubleshooting guidance.
What is the NetSpeek Edge?
The NetSpeek Edge is a secure, virtual appliance designed to seamlessly connect your local environment to the NetSpeek cloud platform. Acting as a bridge between your on-premises devices and the cloud, NetSpeek Edge enables real-time, low-latency communication, device management, and monitoring; all without the need for dedicated hardware in every room or location.
Key Functions and Benefits
- Secure Connectivity: NetSpeek Edge establishes outbound-only, encrypted connections to the NetSpeek platform, ensuring your internal network remains protected from unsolicited inbound traffic.
- Local Device Management: Deployed as a virtual machine (VM) within your infrastructure, it can discover, control, and monitor devices on your local network, such as displays, AV equipment, and IoT devices, in harmony with the NetSpeek platform.
- Centralized Cloud Integration: All device commands, updates, and monitoring are orchestrated through the cloud platform, providing a unified dashboard for management and troubleshooting.
- No Hardware Hassle: Since NetSpeek Edge is a software-based VM, there’s no need for physical gateway appliances, one Edge Instance can manage dozens of devices across your site.
- Automatic & Secure Operation: NetSpeek Edge is designed to start automatically with its secure & hardened host system, recover from failures for maximum reliability.
- Real-Time and Scheduled Operations: It supports both instant, interactive commands (like live monitoring or device control) and scheduled tasks (such as firmware updates or maintenance), optimizing network usage and operational efficiency.
How It Works
- Deployment: NetSpeek Edge is delivered as a pre-configured virtual machine image (VMDK format), compatible with popular virtualization platforms like VMware and VirtualBox.
- Integration: Once deployed and networked, it connects securely to the NetSpeek cloud, allowing you to manage your devices from anywhere via the cloud dashboard.
- Management: A local web interface is available for initial setup and troubleshooting, but ongoing management is handled through the cloud for security and convenience.
Why Use NetSpeek Edge?
- Simplicity: Streamlines the process of connecting and managing local devices with minimal IT overhead.
- Security: Outbound-only connections and a hardened OS image minimize your attack surface.
- Scalability: Easily manage multiple devices and locations from a single cloud interface.
- Reliability: Designed for automatic recovery and robust operation in enterprise environments.
Installation Overview
To onboard your NetSpeek Edge, follow the steps in this guide in the order they are presented. The process will take you from initial setup prerequisites and configuration through validation and portal access, ensuring that your environment is properly prepared and your virtual instance is fully connected. Each stage builds on the last, so it’s important to proceed sequentially. By completing these steps, you’ll ensure a smooth onboarding experience and have your Edge instance ready for operation.
1. Resource Specifications
Virtual Machine Hardware Requirements
To ensure optimal performance, your virtual machine (VM) must meet the following hardware specifications:
Minimum System Specifications
These requirements represent the lowest configuration necessary for the VM to function reliably:
- CPU: 2 vCPUs (64-bit processor)
- Memory (RAM): 4 GB
- Storage: 8 GB available disk space
Recommended Specifications for High Usage Environments
For environments with heavy workloads, multiple concurrent users, or intensive processing, the following configuration is recommended:
- CPU: 4 vCPUs
- Memory (RAM): 8 GB
- Storage: 20 GB available disk space
2. Software Prerequisites
Before installation, ensure the following:
- Virtualization platform is installed and running.
- Admin access to the hypervisor.
- Latest NetSpeek Edge
.vmdkimage downloaded from provided NetSpeek download url. - Outbound internet access is required for cloud registration using the ports specified below.
3. Network and Firewall Requirements
Internal (Corporate) Network Communication (NetSpeek Edge ↔ Intranet)
| Port | Protocol | Direction | Supported Integrations | Purpose |
|---|---|---|---|---|
| 80 | HTTP | Outbound | BrightSign, NEC, Sony, Logitech, MiddleAtlantic | Device control & monitoring |
| 443 | HTTPS | Outbound | Crestron, Vaddio, MiddleAtlantic, Logitech | Secure device control & command relay |
| 161 | SNMP | Outbound | SNMP Devices | Network device discovery |
| 1515 | TCP | Outbound | Samsung | Display control (TCP protocol) |
| 3000 | HTTP/WS | Outbound | LG WebOS | Display control |
| 3001 | HTTP/WS | Outbound | LG WebOS | Display control |
| 4000 | HTTPS | Outbound | Samsung | Embedded API control |
| 4003 | HTTPS | Outbound | Barco ClickShare | Device management |
| 8001 | HTTP/WS | Outbound | Samsung | Real-time display control |
| 8080 | HTTP | Inbound | Agent Web Interface | Local management |
Outbound Internet Communication (NetSpeek Edge ↔ NetSpeek Cloud)
| Port | Protocol | Direction | Supported Integrations | Purpose |
|---|---|---|---|---|
| 443 | HTTPS | Outbound | NetSpeek Cloud API | Configuration, metadata sync, API requests |
| 443 | WSS | Outbound | NetSpeek Cloud API | Real-time action dispatch relay |
Outbound ports to NetSpeek platform must be open for *.netspeek.ai addresses.
Also, installers should be aware that the Edge Client VM has no default IP address, and will request network connectivity information from a DHCP server by default. If installing the Edge into a network environment with no DHCP server available, it is required to set a static IP address using the procedure described in the link in section 4.3.
4. Connection to NetSpeek Platform
- Deploy the Virtual Machine
Import NetSpeek Edge.vmdkdisc and/or.ovfimage into your virtualization platform (e.g., VMware ESXi or Hyper-V).- How to Install NetSpeek Edge on VirtualBox
- How to Install NetSpeek Edge on VMware Fusion
- How to Install the NetSpeek Edge on VMware ESXI
- Power On the VM
Start the virtual machine and access its console or terminal. - Configure VM Network and Firewall for Cloud Connectivity
Set a static IP address or use DHCP to ensure the VM has reliable network access. Confirm that it can reach the internet and your internal network. Configure the virtual machine runner to allow required inbound and outbound ports through its firewall, NAT, and any host-level hypervisor settings. Ensure outbound HTTPS (TCP port 443) is open for communication with the NetSpeek platform, and allow any additional required ports specified in this document. Verify DNS resolution, gateway access, and routing are properly configured to support seamless connectivity. - Navigate to the VM’s IP address
Once activated and networked, open a browser and navigate to the VM’s IP address at the following URL:http://<vm-ip>:8080 - Log into your NetSpeek Edge web interface for initial configurationUsing the IP address above, navigate to NetSpeek Edge Service Management login, input your predefined passcode and Sign In to gain entrance to the web interface.
- Confirm API Connection Health
The web interface lets you verify that NetSpeek Edge is running correctly and provides tools to view logs, manage services, and confirm platform connectivity. After setting up your integration in the NetSpeek Web Platform, check the connection state to confirm that the Edge is successfully connected to the Cloud. - Edge Client performance
The Performance Dashboard provides incremental visibility into NetSpeek Edge’s resource utilization, including CPU, memory, and disk usage, along with other key performance metrics. You can adjust the reporting window to view metrics over different intervals, such as 10 minutes, 30 minutes, 1 hour, allowing you to monitor system health and ensure the client is running optimally. - Edge Client settings
The Settings Dashboard allows you to manage configuration options for NetSpeek Edge. From this view, you can update API settings, adjust password management controls, and enable or disable verbose logging as needed.
After generating a new NetSpeek Edge Client API Key, make sure the API Key is copied to your clipboard and pasted into your Integration Configuration settings in your Lena platform tenant before pressing “Save Configuration” and navigating away from this page.
Also note that a newly generated (or replaced/changed) API Key will not be used by the Edge Client software to connect to NetSpeek’s cloud until the “Restart” button is pressed on the Service Status section of the Edge Client web UI homepage (this button is shown in the image in section 7).
5. Installation & Resource Checklist
| Task | Status |
|---|---|
| Disk image downloaded | ☐ |
| NetSpeek Edge VM deployed and powered on | ☐ |
| IP/network configured | ☐ |
| Firewall rules updated | ☐ |
| Edge successfully registered with NetSpeek platform | ☐ |
6. Troubleshooting
| Issue | Possible Cause | Resolution |
|---|---|---|
| Web UI Not Loading | Corrupted Image, or incorrect settings | Re-upload images to VM Software, doublecheck settings configuration |
| “Connection refused” when accessing Edge UI | Firewall blocking port, API key mismatch | Allow inbound & outbound TCP port 443, Double check that API key set in Customer Integration Settings matches what’s in Web User Interface of NetSpeek Edge |
| DNS resolution failures | Incorrect DNS configuration | Update DNS settings on VM host |
| Slow performance, High CPU or memory usage | Insufficient resources | Allocate more vCPU/RAM |
| Image fails to obtain an IP Address | Network configuration/permissions on local machine | Try running ‘sudo dhclient’ in NetSpeek Edge VM |
Support
If issues persist, contact NetSpeek Support at support@netspeek.com with:
- Edge VM logs (available in the NetSpeek Edge interface and later in the platform)