Skip to content

fix(gcp): keep terminal and Guacamole sessions open for 8 hours - #2984

Merged
Brad-Edwards merged 6 commits into
devfrom
fix/guacamole-websocket-8h
Nov 19, 2026
Merged

Brad-Edwards merged 6 commits into
devfrom
fix/guacamole-websocket-8h

Conversation

@Brad-Edwards

@Brad-Edwards Brad-Edwards commented Nov 19, 2026 •

Copy link
Copy Markdown
Collaborator

Problem

Three limits ended remote sessions:

  • The Google load balancer closes a WebSocket when it reaches the backend service timeout. This occurs also when the session is active. The GCP capacity profiles set the portal-web and guacamole-client backend timeouts to 3600 seconds. The platform terminal uses portal-web. RDP and SSH through Guacamole use guacamole-client.
  • Guacamole ends a session after 60 minutes of inactivity (the api-session-timeout default).

Change

  • shifter/installation/capacity_profiles_gcp.py: set portal_backend_seconds and guacamole_backend_seconds to 28800 (8 hours) for all GCP capacity profiles. The chart schema permits a maximum of 86400.
  • platform/charts/shifter/templates/guacamole-client-deployment.yaml: set API_SESSION_TIMEOUT to 480 minutes. The image enables enable-environment-properties, so Guacamole reads this variable.
  • Tests: expect the new values.

Verification

  • shifter/installation/tests/test_capacity_profiles_gcp.py, scripts/gcp/tests/test_check_event_capacity_drift.py, and the Guacamole test in platform/charts/shifter/tests/test_chart_contract.py pass.
  • A live deployment with the same values shows timeoutSec 28800 on both Google backend services. Its guacamole-client logs "Sessions will expire after 480 minutes of inactivity".

The load balancer closes a WebSocket at the backend timeout, also when the
session is active. At 3600 seconds, every RDP and SSH session through
Guacamole ended after one hour. Set the guacamole-client backend timeout to
28800 seconds in the GCP capacity profiles.
Guacamole ended a session after 60 minutes without REST activity. Set
API_SESSION_TIMEOUT to 480 minutes on guacamole-client so that it matches
the 8-hour load balancer timeout.
The platform terminal WebSocket goes through the portal-web backend, which
closed it after 3600 seconds. Set portal_backend_seconds to 28800 to match
guacamole-client.
@Brad-Edwards Brad-Edwards changed the title fix(gcp): keep Guacamole sessions open for 8 hours fix(gcp): keep terminal and Guacamole sessions open for 8 hours Nov 19, 2026
@Brad-Edwards
Brad-Edwards merged commit 050c93a into dev Nov 19, 2026
99 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant