User Manual
OrpheAgent Release Note
Version 1.1.8
OrpheAgent 1.1.8
Release Date: June 18, 2026
New Features
Relay Session Monitoring
Added relay session monitoring to improve connection visibility and provide more accurate connection reporting.
Enhancements
Connection Management
- Improved connection status handling for greater accuracy and overall system reliability.
- Simplified connection management to improve maintainability and operational stability.
Bug Fixes
- Improved relay connection handling to provide more consistent connection behavior and system stability
OrpheAgent 1.1.7
Release Date: June 12, 2026
New Features
Optional mDNS Discovery
Added optional mDNS-based device discovery to simplify peer discovery within local networks.
OpenWrt Management Interface
Added a web-based management interface for OpenWrt, allowing administrators to configure and monitor OrpheAgent more easily.
Enhancements
Connection Management
- Improved connection status detection for more accurate monitoring of peer connectivity.
- Enhanced connection selection to automatically prefer direct peer-to-peer connections whenever available, improving performance and reducing relay usage.
- Improved relay connection establishment for greater reliability.
- Optimized peer discovery to reduce connection time and improve responsiveness.
- Enhanced Route-to-Exit connection handling for more reliable traffic routing.
Performance & Reliability
- Improved internal communication mechanisms to enhance overall system stability.
- Reduced unnecessary processing during peer discovery and connection management.
Bug Fixes
- Fixed an issue affecting endpoint detection for peer connections.
- Fixed issues that could prevent devices from properly re-registering after reprovisioning or reconnecting to the controller.
OrpheAgent 1.1.6
Release Date: May 31, 2026
New Features
Self-Owned Relay Management
Added support for configuring and managing self-owned relay servers, giving organizations greater flexibility and control over relay infrastructure.
Configurable DHT Discovery
Added the ability to enable or disable Distributed Hash Table (DHT) peer discovery, allowing deployments to better align with different network environments and operational requirements.
Enhanced Public Address Detection
Improved public network address detection to increase the success rate and reliability of peer-to-peer connections across NAT environments.
Flexible Provisioning
Provisioning now supports customized relay settings, making device onboarding easier across different deployment scenarios.
Device Operating System Detection
Provisioning now automatically identifies the operating system of managed devices, providing more complete device information within the management interface.
Improved Windows Compatibility
Enhanced Windows networking compatibility with more reliable virtual network adapter initialization, recovery, and system wake-up handling.
Configurable Update Notifications
Added an option to enable or disable automatic update notifications based on deployment preferences.
Enhancements
Dynamic Relay Configuration
Relay configuration changes can now be applied dynamically, reducing service interruptions and simplifying ongoing management.
Improved Peer Discovery
Enhanced DHT lifecycle management and peer discovery to improve connection stability and overall network reliability.
More Reliable NAT Traversal
Improved UDP hole punching to provide more reliable peer-to-peer connectivity, particularly in complex NAT environments.
Enhanced Connection Reliability
Improved network service startup and connection management, increasing overall system stability.
Flexible Relay Bandwidth Control
Added configurable bandwidth limits for self-owned relay servers, allowing administrators to better manage network resources.
Remote SNAT Configuration
Expanded Source NAT (SNAT) support to simplify network deployment and routing for remote nodes.
Improved Build and Connection Stability
Enhanced build configuration flexibility and improved WebSocket connection reliability during device registration.
Bug Fixes
- Improved network recovery after system sleep or wake events.
- Fixed relay reconnection issues following configuration changes.
- Improved stability during concurrent connection status updates.
- Improved update notification handling and related error reporting.
OrpheAgent 1.1.5
Release Date: May 15, 2026
New Features
Source NAT (SNAT) Support
Added Source NAT (SNAT) functionality to provide greater flexibility for agent-to-agent communication and network deployment scenarios.
Improved Service Management
Expanded service management capabilities with support for service editing, querying, and proxy configuration.
Enhanced Registration Reliability
Improved WebSocket connection handling during device registration to provide more reliable onboarding and connectivity.
Enhancements
Improved Connection Stability
Enhanced concurrent task management to improve overall system stability during peer discovery, relay operations, and network communications.
Optimized Relay Management
Improved relay connection lifecycle management for more reliable and consistent connectivity.
Enhanced Routing Performance
Optimized agent-to-agent routing and forwarding to improve communication efficiency across connected devices.
Improved Status Synchronization
Enhanced status update handling to provide more reliable synchronization between devices and the management platform.
Bug Fixes
- Improved reliability of control plane service startup and shutdown.
- Fixed issues related to service initialization and lifecycle management.
OrpheAgent 1.1.4
Release Date: April 30, 2026
New Features
Remote Tunnel & NAT Management
Added remote management capabilities for tunnel mode and NAT type, allowing administrators to view network status and adjust tunnel settings for individual devices more easily.
Remote DHT Configuration
Added support for remotely enabling or disabling Distributed Hash Table (DHT) peer discovery, providing greater flexibility for different network environments.
Desktop Update Notifications
Added update notifications and a quick download option in the desktop application, making it easier to install the latest version.
Enhancements
Dynamic Tunnel & DHT Configuration
Tunnel mode and DHT settings can now be applied dynamically without requiring service restarts, reducing downtime and simplifying remote administration.
Improved Peer Discovery
Enhanced peer discovery to improve connection reliability and simplify network configuration across different deployment scenarios.
Improved LAN Route Synchronization
Optimized LAN subnet routing and synchronization to provide more consistent communication between connected devices.
Enhanced NAT Traversal
Improved peer-to-peer connection establishment by optimizing connection path selection, resulting in more reliable connectivity across NAT environments.
Improved Desktop Networking
Enhanced desktop networking performance and recovery, providing more reliable connectivity after system sleep or network interruptions, along with improved compatibility for UDP-based applications.
Improved System Reliability
Enhanced internal resource management and profile handling to improve overall system stability during configuration updates and service restarts.
Documentation Updates
Updated product documentation to reflect the latest networking features and configuration options.
Bug Fixes
- Fixed an issue that could affect the initialization of Jump-to-Service connections under specific startup conditions.
- Improved database handling during profile reloads and service restarts to reduce stale connection issues.
- Fixed a stability issue that could occur while desktop connections were reconnecting or shutting down.
OrpheAgent 1.1.3
Release Date: April 17, 2026
New Features
NAT Type Detection
Added NAT type detection to help users quickly assess network compatibility for peer-to-peer (P2P) connectivity. The feature is available in both the desktop application and OpenWrt management interface.
Software Update Management
Introduced built-in software update capabilities, allowing users to check for new versions, install updates, and monitor update progress directly from the management interface.
Route-to-Exit DNS Configuration
Added support for custom DNS settings when using Route-to-Exit, providing greater flexibility for traffic routing and name resolution.
Command-Line Update Support
Added a command-line update utility, making it easier to check for and install new software versions from the terminal.
Enhancements
Improved Connection Stability
Enhanced connection management and link status detection to provide more reliable peer connectivity while reducing false disconnection events.
Improved Network Performance
Optimized packet processing and network traffic handling to improve overall communication efficiency and reduce resource usage.
Enhanced Firewall Verification
Improved firewall validation on OpenWrt to provide clearer diagnostics and simplify network troubleshooting.
Improved Desktop User Experience
Updated the desktop interface with a more consistent visual design, improved dialog presentation, and a streamlined toolbar layout.
Enhanced System Reliability
Improved service shutdown, status reporting, and network monitoring to provide greater overall system stability.
Bug Fixes
- Fixed an issue that could affect connection stability during service shutdown.
- Resolved a resource management issue that could impact long-running network sessions.
- Improved database state handling to ensure more reliable operation after controller-initiated resets.
OrpheAgent 1.1.2
Release Date: April 2, 2026
New Features
Environment-Based Routing
Added support for environment-based routing policies, enabling more flexible traffic forwarding based on deployment requirements.
Service Status Monitoring
Added service status monitoring to provide better visibility into the operational state of OrpheAgent services.
Enhanced Neighbor Information
Expanded connection status information to provide clearer visibility into neighboring devices and network connectivity.
Improved OpenWrt WAN Integration
Enhanced OpenWrt networking to improve dataplane traffic forwarding for WAN-connected deployments.
Improved macOS Uninstallation
Added an enhanced uninstallation process for macOS to provide cleaner removal of OrpheAgent and related components.
Enhancements
Simplified Service Management
Improved service configuration and lifecycle management to provide a more consistent and predictable administration experience.
Improved Jump-to-Service Management
Enhanced Jump-to-Service configuration to reduce conflicts and simplify deployment.
Enhanced Management Security
Improved security by limiting management services to local access, reducing unnecessary network exposure.
Improved Relay Discovery
Enhanced relay discovery during provisioning to improve connection reliability across different network environments.
Improved Platform Compatibility
Updated networking components and platform dependencies to improve compatibility and overall stability.
Improved Desktop Experience
Refined desktop service controls and simplified tunnel management for a smoother user experience.
Bug Fixes
- Improved hardware monitoring accuracy on supported devices.
- Fixed an issue affecting controller status synchronization after communication failures.
- Fixed default service settings to ensure services remain enabled after initial installation.
OrpheAgent 1.1.1
Release Date: March 20, 2026
Enhancements
Enhanced Device Provisioning
Improved the provisioning process by providing more complete device information during onboarding, enabling faster device identification and a smoother deployment experience.
Expanded Service & Connection Status
Enhanced service and connection status reporting to provide clearer visibility into device availability, provisioning status, and license status for easier monitoring and troubleshooting.
Route-to-Exit DNS Support
Added DNS configuration support for Route-to-Exit deployments, allowing preferred DNS settings to be applied automatically for a more consistent networking experience.
Improved OpenWrt Management
Enhanced the OpenWrt management interface with more comprehensive device status information and a streamlined provisioning workflow.
Faster Connection Recovery
Improved peer-to-peer connection recovery after temporary network interruptions, reducing reconnection time and improving overall connectivity.
Bug Fixes
- Improved provisioning reliability by preventing duplicate discovery events and enhancing connection handling during device onboarding.
- Improved service status synchronization to ensure license status changes are reflected more accurately across the management interface.
- Enhanced relay reconnection handling to automatically recover from repeated connection failures.
- Improved peer-to-peer connection retry behavior to reduce unnecessary network activity when remote devices are unreachable.
- Improved cleanup of network settings after device removal or Route-to-Exit changes, preventing stale network configurations.
- Improved controller communication reliability to ensure devices can recover more effectively from temporary communication failures.
OrpheAgent 1.1.0
Release Date: March 6 , 2026
Enhancements
Improved Provisioning Reliability
Optimized the provisioning workflow to improve deployment reliability and reduce issues during repeated provisioning or device re-enrollment.
Enhanced Connection Detection
Improved connection state detection, allowing devices to identify provisioning and controller connection status more quickly and accurately.
More Reliable Relay Connectivity
Enhanced relay connection stability during provisioning to improve the success rate of device onboarding in various network environments.
Streamlined Logging
Optimized system logging to improve readability while reducing unnecessary log output and storage usage.
Bug Fixes
- Improved cleanup of network configuration after removing a device from management, ensuring smoother reprovisioning.
- Improved service shutdown reliability to prevent delays during system restart or shutdown.
- Fixed an issue affecting communication between connected devices.
- Fixed an issue related to Exit Node address handling that could impact routing in certain deployment scenarios.
OrpheAgent 1.0.9
Release Date: February 6 , 2026
New Features
Automatic Neighbor Synchronization
OrpheAgent now automatically synchronizes neighboring devices with OrpheLink, ensuring the device list stays up to date as network changes occur. Devices removed from management are automatically removed from the neighbor list.
Enhancements
Improved WAN Connectivity Management
Enhanced WAN connection monitoring to automatically suspend network services during connectivity loss and restore them when the network becomes available, improving resource efficiency and overall system reliability.
Faster and More Reliable Shutdown
Improved the shutdown process to ensure services stop cleanly and system resources are released more efficiently.
Bug Fixes
- Improved firewall rule synchronization on OpenWrt to ensure network services continue operating correctly after configuration changes.
- Fixed an issue that could prevent successful provisioning in PPPoE network environments.
- Fixed an issue where network configuration was not fully cleared after removing a device from OrpheLink.
- Improved provisioning stability following temporary network interruptions.
- Fixed an issue where Route-to-Exit settings could remain active after the associated Exit Node was removed.
- Fixed an issue affecting the initial profile configuration during first-time deployment.
Enhancements
Improved Connection Stability
Enhanced peer-to-peer connection management to provide more stable connectivity across different network conditions.
Improved Service Reliability
Optimized service shutdown and background task handling to improve overall system stability and responsiveness.
Bug Fixes
- Fixed an issue that could cause the service to become unresponsive when switching tunnel modes.
- Fixed an issue that could delay peer-to-peer tunnel establishment under certain conditions.
- Fixed an issue that could cause unstable connection status switching between Direct, Relay, and Offline modes.
- Fixed an issue where Route-to-Exit was not properly disabled after the associated Exit Node was removed.
- Fixed several synchronization issues that could affect service stability during configuration updates.
- Improved offline traffic handling to prevent temporary traffic bursts after network reconnection.
- Fixed an issue that could delay service shutdown in high-throughput scenarios.
OrpheAgent 1.0.7
Release Date: January 15, 2026
Enhancements
Improved Peer Connection Reliability
Optimized peer connection timing and retry behavior to improve connection success rates, particularly in complex NAT and firewall environments.
OrpheAgent 1.0.6
Release Date: January 8, 2026
New Features
Profile Management
Added Profile Management, allowing users to easily switch between multiple OrpheLink accounts and environments.
Agent-to-Agent Configuration
Introduced direct Agent-to-Agent configuration capabilities, enabling distributed management for LAN-to-LAN networking, Exit Node, and Route-to-Exit deployments without requiring continuous OrpheLink involvement.
Offline Configuration Synchronization
Added support for pending configuration tasks, allowing changes to be queued while devices are offline and automatically applied once connectivity is restored.
Simplified Initial Device Setup
Streamlined the initial device configuration process to reduce setup time and improve deployment efficiency.
Enhancements
Enhanced Device Information
Expanded device information displayed across the management interface, including operating system and device identification details for improved visibility.
Improved Status Reporting
Standardized connection status presentation to provide clearer and more consistent network information.
Improved Power Efficiency
Optimized data forwarding to reduce power consumption, extending battery life on supported devices.
Bug Fixes
- Fixed an issue where firewall rules on OpenWrt systems might not be applied correctly after configuration updates, improving overall network reliability.
OrpheAgent 1.0.5
Release Date: December 19, 2025
New Features
Real-Time Status Monitoring
Added real-time status updates for device services and peer-to-peer connections, allowing administrators to monitor connection status more efficiently.
Service Control
Added the ability to enable or disable networking services directly through the management interface.
Enhanced Peer-to-Peer Visibility
Expanded peer connection information with connection quality, operating system, and device details to simplify monitoring and troubleshooting.
Agent-to-Agent Communication
Introduced direct communication between OrpheAgent devices, enabling more efficient coordination and configuration exchange.
Local Peer Discovery
Added local network peer discovery to simplify direct peer-to-peer connectivity in supported environments.
Relay Support for Low-Latency Connections
Added relay transport support for Low Latency Tunnel mode, improving connectivity when direct peer-to-peer communication is unavailable.
Enhancements
Improved Relay Connection Efficiency
Optimized relay connection management to reduce unnecessary resource usage when networking services are disabled.
More Accurate Status Synchronization
Improved synchronization of service status to provide more consistent connection information across managed devices.
Improved User Experience
Enhanced command-line output and OpenWrt management interface usability for a clearer management experience.
Bug Fixes
- Fixed a potential issue that could affect Data Plane stability during status updates.
- Fixed an issue where endpoint address information might not be displayed correctly.
- Fixed an issue affecting CPU temperature reporting on supported platforms.
- Improved overall system stability by resolving a potential third-party library issue that could unexpectedly restart the service.
OrpheAgent 1.0.4
Release Date: December 4, 2025
New Features
System Information
Added a system information feature that allows administrators to easily view the current OrpheAgent software version and related system details.
Route-to-Exit for Specific Subnets
Added support for routing selected network subnets through an Exit Node, providing greater flexibility for hybrid networking and traffic management.
Enhanced LAN-to-LAN Routing
Introduced improved routing management for LAN-to-LAN and Route-to-Exit deployments, helping maintain reliable connectivity across distributed networks.
Enhancements
Improved P2P Connectivity
Enhanced peer-to-peer connection establishment and failover mechanisms to provide faster and more reliable connectivity across different network environments.
More Accurate Connection Monitoring
Improved network status detection to provide more accurate connection status and better operational visibility.
Faster Provisioning Experience
Optimized the provisioning workflow to improve deployment efficiency and reduce setup time.
Improved Device Management
Enhanced device cleanup and status synchronization after removing devices from management, allowing faster reprovisioning and more consistent network behavior.
Bug Fixes
- Fixed an issue that could prevent direct peer-to-peer connections in certain network topologies.
- Fixed an issue where Data Plane status might not update correctly after being disabled.
- Improved CPU temperature reporting accuracy on supported devices.
- Fixed a browser compatibility issue affecting authentication portal redirection in Firefox.
- Fixed an issue that could prevent relay services from shutting down correctly.
- Fixed an issue affecting the status command when the device was not connected to OrpheLink.
- Improved stability of real-time network monitoring.
- Fixed a potential memory usage issue that could affect long-running deployments.
- Fixed an issue affecting large data transfers in specific communication scenarios.
- Fixed an issue where Data Plane status information might not display in the expected order.
OrpheAgent 1.0.3
Release Date: October 17, 2025
New Features
Data Plane Management
Added new Data Plane management capabilities, allowing administrators to easily enable or disable peer-to-peer networking and configure network behavior.
Source NAT (SNAT) Support
Added Source NAT (SNAT) support for Data Plane deployments, providing greater flexibility for a wider range of networking environments.
Enhanced OpenWrt Management
Added a dedicated Data Plane configuration page to the OpenWrt management interface for a more streamlined management experience.
Enhancements
Improved Peer Discovery
Optimized peer discovery and NAT traversal to improve connection performance and reliability across different network environments.
Improved Platform Security
Removed development-only configuration options to simplify system management and improve overall security.
Bug Fixes
- Fixed an issue that could cause the service to become unresponsive during shutdown.
- Fixed an issue where enabling or disabling OrpheAgent through the OpenWrt management interface might not work correctly.
OrpheAgent 1.0.2
Release Date: October 3, 2025
New Features
Data Plane Configuration
Added Data Plane configuration capabilities, allowing administrators to manage peer-to-peer networking settings more efficiently.
Enhancements
Improved Configuration Management
Refined configuration management workflows to provide a more consistent and intuitive deployment experience.
Enhanced System Stability
Improved configuration validation and internal synchronization to increase overall system reliability.
Improved Relay Connectivity
Enhanced relay discovery and provisioning behavior to improve connectivity in environments where direct peer-to-peer communication is unavailable.
Documentation Updates
Expanded product documentation with additional configuration guidance and deployment examples.
Bug Fixes
- Fixed an issue where Provision Key settings could be overwritten unexpectedly during configuration updates.
- Fixed an issue where certain peer-to-peer networking options might not be applied correctly after configuration changes.
