gitlab-org--gitlab-foss/doc/administration/timezone.md

2.4 KiB

stage group info
Enablement Distribution To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments

Changing your time zone (FREE SELF)

The global time zone configuration parameter can be changed in config/gitlab.yml:

# time_zone: 'UTC'

Uncomment and customize if you want to change the default time zone of the GitLab application.

Viewing available time zones

To see all available time zones, run bundle exec rake time:zones:all.

For Omnibus installations, run gitlab-rake time:zones:all.

NOTE: This Rake task does not list time zones in TZInfo format required by Omnibus GitLab during a reconfigure: #27209.

Changing time zone in Omnibus installations

GitLab defaults its time zone to UTC. It has a global time zone configuration parameter in /etc/gitlab/gitlab.rb.

To obtain a list of time zones, log in to your GitLab application server and run a command that generates a list of time zones in TZInfo format for the server. For example, install timedatectl and run timedatectl list-timezones.

To update, add the time zone that best applies to your location. For example:

gitlab_rails['time_zone'] = 'America/New_York'

After adding the configuration parameter, reconfigure and restart your GitLab instance:

gitlab-ctl reconfigure
gitlab-ctl restart

Changing time zone per user

Users can set their time zone in their profile. On GitLab.com, the default time zone is UTC.

New users do not have a default time zone in GitLab 14.4 and later. New users must explicitly set their time zone before it displays on their profile.

In GitLab 14.3 and earlier, users with no configured time zone default to the time zone configured at the instance level.

For more information, see Set your time zone.