1---
2stage: Enablement
3group: Distribution
4info: 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
5---
6
7# Changing your time zone **(FREE SELF)**
8
9The global time zone configuration parameter can be changed in `config/gitlab.yml`:
10
11```plaintext
12# time_zone: 'UTC'
13```
14
15Uncomment and customize if you want to change the default time zone of the GitLab application.
16
17## Viewing available time zones
18
19To see all available time zones, run `bundle exec rake time:zones:all`.
20
21For Omnibus installations, run `gitlab-rake time:zones:all`.
22
23NOTE:
24This Rake task does not list time zones in TZInfo format required by Omnibus GitLab during a reconfigure: [#27209](https://gitlab.com/gitlab-org/gitlab/-/issues/27209).
25
26## Changing time zone in Omnibus installations
27
28GitLab defaults its time zone to UTC. It has a global time zone configuration parameter in `/etc/gitlab/gitlab.rb`.
29
30To 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`.
31
32To update, add the time zone that best applies to your location. For example:
33
34```ruby
35gitlab_rails['time_zone'] = 'America/New_York'
36```
37
38After adding the configuration parameter, reconfigure and restart your GitLab instance:
39
40```shell
41gitlab-ctl reconfigure
42gitlab-ctl restart
43```
44
45## Changing time zone per user
46
47> - [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/57654) in GitLab 11.11, disabled by default behind `user_time_settings` [feature flag](feature_flags.md).
48> - [Enabled by default](https://gitlab.com/gitlab-org/gitlab/-/issues/29669) in GitLab 13.9.
49> - [Feature flag removed](https://gitlab.com/gitlab-org/gitlab/-/issues/29669) in GitLab 14.1.
50
51Users can set their time zone in their profile. On GitLab.com, the default time zone is UTC.
52
53New users do not have a default time zone in [GitLab 14.4 and later](https://gitlab.com/gitlab-org/gitlab/-/issues/340795). New users must
54explicitly set their time zone before it displays on their profile.
55
56In GitLab 14.3 and earlier, users with no configured time zone default to the time zone
57[configured at the instance level](#changing-your-time-zone).
58
59For more information, see [Set your time zone](../user/profile/index.md#set-your-time-zone).
60