Skip to content

Pages: Increase gitlab-client-http-timeout to 1 minute default

Summary

Increase the default gitlab-client-http-timeout setting for GitLab Pages from the current default to 1 minute (60 seconds) to reduce timeout errors and improve reliability. Also update DefaultTTFBTimeout to 30 seconds here.

Problem

Users in large groups are experiencing HTTP timeout errors (net/http: request canceled (Client.Timeout exceeded while awaiting headers)) when GitLab Pages makes requests to the GitLab API. The current default timeout is too short for:

  • Large group hierarchy with many projects
  • Slow network connections
  • High server load scenarios

Proposed Solution

Change the default gitlab-client-http-timeout configuration to 60 seconds.

Current default: 10 seconds Proposed default: 60 seconds

Expected Benefits

  • Reduced timeout errors (499 Client Closed Request/502 Bad Gateway) for Pages users
  • Improved reliability for large groups
  • Better handling of network latency issues
  • More consistent Pages access experience

Implementation

Update the default timeout value in the Pages configuration and documentation.

gitlab_pages['gitlab_client_http_timeout'] = "60s"
Edited by Katrin Leinweber