Installing on Linux

OmniEdge CLI is compatible with Linux for x86_64, ARM64, and RISC-V architectures. Last update: Version v2.9.0, Feb 16, 2026.

Supported Platforms

Quick Install (Recommended)

curl -fsSL https://raw.githubusercontent.com/omniedgeio/omniedge/main/scripts/omniedge-install.sh | bash

Manual Installation

Download Packages

Install from Package Manager

# Debian/Ubuntu
sudo dpkg -i omniedge-cli-2.9.0-linux-x64.deb

# Fedora/RHEL
sudo rpm -i omniedge-cli-2.9.0-linux-x64.rpm

# AppImage
chmod +x omniedge-cli-2.9.0-linux-x64.AppImage
./omniedge-cli-2.9.0-linux-x64.AppImage

Usage

Connect to Network

# Connect to first available network (interactive login on first run)
sudo omniedge start

# Connect to specific network
sudo omniedge start -n <network_id>

# Non-interactive login with security key (for CI/CD)
sudo omniedge start -s <security_key> -n <network_id>

Check Status

omniedge status

Operating Modes

# Nucleus mode - Run your own signaling server (air-gapped labs)
sudo omniedge start --mode nucleus --port 51821 --secret "YourLabSecret123"

# Dual mode - Hub node that also participates in mesh
sudo omniedge start -n <network_id> --mode dual --secret "YourSecret123456"

New Features in v2.2.1

• WASM Plugin System: Extend functionality with secure WebAssembly plugins
• NAT Traversal: Advanced STUN-based NAT detection with relay fallback
• Exit Node Support: Route all traffic through a secure exit node
• Self-Hosted Mode: Run completely offline with nucleus mode

CLI Reference

# Plugin management (v2.2.0+)
omniedge plugin list              # List installed plugins
omniedge plugin install <path>    # Install plugin from ZIP
omniedge plugin uninstall <id>    # Remove a plugin
omniedge plugin enable <id>       # Enable a plugin
omniedge plugin disable <id>      # Disable a plugin
omniedge plugin info <id>         # Show plugin details
omniedge plugin reload <id>       # Reload a plugin
omniedge plugin discover          # Discover plugins in directory

# NAT configuration (v2.1.0+)
omniedge config show              # Show current settings
omniedge config relay on          # Enable relay fallback
omniedge config portmap on        # Enable UPnP/NAT-PMP
omniedge config ipv6 prefer       # Prefer IPv6 when faster
omniedge config encrypt on        # Enable encrypted signaling

If you have more questions, feel free to discuss.