-
-
Notifications
You must be signed in to change notification settings - Fork 2
Description
Title
When attempting to open a terminal connection, the client fails to establish a stable session and enters a reconnection loop. After a fixed number of retries, the process stops with the error “Maximum reconnection attempts reached”, preventing any interaction.
Platform
App - Linux
Server Installation Method
Docker
Version
1.9.0 all
Troubleshooting
- I have examined logs and tried to find the issue
- I have reviewed opened and closed issues
- I have tried restarting the application
- I have read Known Issues (Known Issues (Read Before Posting) #296)
The Problem
[BUG] Connection loop ends with “Maximum reconnection attempts reached”
Description
When attempting to open a terminal connection, the client fails to establish a stable session and enters a reconnection loop. After a fixed number of retries, the process stops with the error “Maximum reconnection attempts reached”, preventing any interaction.
Observed behavior
• The server is detected correctly
• Server statistics (CPU, RAM) are displayed and update normally
• The server status appears online (green)
• Upon connection attempt:
• Reconnecting... (2/3)
• Reconnecting... (3/3)
• Then: Maximum reconnection attempts reached
• No usable terminal session is ever opened
Expected behavior
• A stable terminal connection should be established
• If the connection fails, retries should either:
• stop earlier with a clear error, or
• properly clean up previous attempts before retrying
• The server should not appear fully healthy if the terminal connection cannot be established
Impact
• Impossible to access the server terminal
• User is locked out despite the server being shown as online
• Requires manual intervention or restart to retry
Notes
• The issue is confusing because server stats and health indicators work correctly, suggesting partial connectivity.
• This may indicate that the monitoring/status channel works, while the terminal/session channel fails or is not properly released between retries.
Environment
• OS: DietPi (ARM64)
• Deployment: Docker
• Access method: Web UI
• Network: Local LAN
How to Reproduce
1. Start the service
2. Open the web UI
3. Attempt to connect to the server terminal
4. Observe repeated reconnection attempts
5. Connection fails with “Maximum reconnection attempts reached”
Additional Context
No response
Metadata
Metadata
Assignees
Labels
Type
Projects
Status