55 lines
2.2 KiB
Markdown
55 lines
2.2 KiB
Markdown
---
|
|
stage: Enablement
|
|
group: Distribution
|
|
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
|
|
---
|
|
|
|
# Changing your time zone **(FREE SELF)**
|
|
|
|
The global time zone configuration parameter can be changed in `config/gitlab.yml`:
|
|
|
|
```plaintext
|
|
# time_zone: 'UTC'
|
|
```
|
|
|
|
Uncomment and customize if you want to change the default time zone of the GitLab application.
|
|
|
|
## Viewing available timezones
|
|
|
|
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 timezones in TZInfo format required by Omnibus GitLab during a reconfigure: [#27209](https://gitlab.com/gitlab-org/gitlab/-/issues/27209).
|
|
|
|
## Changing time zone in Omnibus installations
|
|
|
|
GitLab defaults its time zone to UTC. It has a global timezone configuration parameter in `/etc/gitlab/gitlab.rb`.
|
|
|
|
To obtain a list of timezones, log in to your GitLab application server and run a command that generates a list of timezones in TZInfo format for the server. For example, install `timedatectl` and run `timedatectl list-timezones`.
|
|
|
|
To update, add the timezone that best applies to your location. For example:
|
|
|
|
```ruby
|
|
gitlab_rails['time_zone'] = 'America/New_York'
|
|
```
|
|
|
|
After adding the configuration parameter, reconfigure and restart your GitLab instance:
|
|
|
|
```shell
|
|
gitlab-ctl reconfigure
|
|
gitlab-ctl restart
|
|
```
|
|
|
|
## Changing time zone per user
|
|
|
|
> - [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.
|
|
|
|
A user can set their time zone in their profile. If a user has not set their time zone, it defaults
|
|
to the time zone [configured at the instance level](#changing-your-time-zone). On GitLab.com, the
|
|
default time zone is UTC.
|
|
|
|
For more information, see [Set your time zone](../user/profile/index.md#set-your-time-zone).
|