2020-10-26 17:08:22 -04:00
---
2022-05-29 20:08:35 -04:00
stage: Systems
2020-12-01 13:09:42 -05:00
group: Distribution
2020-11-26 01:09:20 -05:00
info: 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
2020-10-26 17:08:22 -04:00
---
2021-06-02 17:10:00 -04:00
# Changing your time zone **(FREE SELF)**
2019-10-28 02:06:30 -04:00
The global time zone configuration parameter can be changed in `config/gitlab.yml` :
2020-05-19 23:08:04 -04:00
```plaintext
2019-10-28 02:06:30 -04:00
# time_zone: 'UTC'
```
Uncomment and customize if you want to change the default time zone of the GitLab application.
2021-09-23 05:09:51 -04:00
## Viewing available time zones
2019-10-28 02:06:30 -04:00
To see all available time zones, run `bundle exec rake time:zones:all` .
For Omnibus installations, run `gitlab-rake time:zones:all` .
2020-12-04 16:09:29 -05:00
NOTE:
2021-09-23 05:09:51 -04:00
This 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 ).
2019-10-28 02:06:30 -04:00
## Changing time zone in Omnibus installations
2021-09-23 05:09:51 -04:00
GitLab defaults its time zone to UTC. It has a global time zone configuration parameter in `/etc/gitlab/gitlab.rb` .
2019-10-28 02:06:30 -04:00
2021-09-23 05:09:51 -04:00
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` .
2019-10-28 02:06:30 -04:00
2021-09-23 05:09:51 -04:00
To update, add the time zone that best applies to your location. For example:
2019-10-28 02:06:30 -04:00
```ruby
gitlab_rails['time_zone'] = 'America/New_York'
```
After adding the configuration parameter, reconfigure and restart your GitLab instance:
2020-01-30 10:09:15 -05:00
```shell
2019-10-28 02:06:30 -04:00
gitlab-ctl reconfigure
gitlab-ctl restart
```
2021-02-04 07:09:25 -05:00
## Changing time zone per user
2021-07-28 14:10:23 -04:00
> - [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).
> - [Enabled by default](https://gitlab.com/gitlab-org/gitlab/-/issues/29669) in GitLab 13.9.
> - [Feature flag removed](https://gitlab.com/gitlab-org/gitlab/-/issues/29669) in GitLab 14.1.
2021-02-04 07:09:25 -05:00
2021-10-01 11:12:53 -04:00
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 ](https://gitlab.com/gitlab-org/gitlab/-/issues/340795 ). 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 ](#changing-your-time-zone ).
2021-02-04 07:09:25 -05:00
2021-08-03 23:09:14 -04:00
For more information, see [Set your time zone ](../user/profile/index.md#set-your-time-zone ).
