{"id":13626147,"url":"https://github.com/gitlabhq/omnibus-gitlab","last_synced_at":"2025-05-16T16:09:17.562Z","repository":{"id":19401583,"uuid":"22643282","full_name":"gitlabhq/omnibus-gitlab","owner":"gitlabhq","description":"GitLab Omnibus Mirror | Please open new issues in our issue tracker on GitLab.com","archived":false,"fork":false,"pushed_at":"2025-05-13T15:51:25.000Z","size":33805,"stargazers_count":211,"open_issues_count":4,"forks_count":144,"subscribers_count":52,"default_branch":"master","last_synced_at":"2025-05-13T16:50:05.466Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://gitlab.com/gitlab-org/omnibus-gitlab/","language":"Ruby","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitlabhq.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".gitlab/CODEOWNERS","security":null,"support":"support/dependency_decisions.yml","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2014-08-05T12:51:13.000Z","updated_at":"2025-05-12T15:58:29.000Z","dependencies_parsed_at":"2023-11-23T14:31:15.827Z","dependency_job_id":"0c9f16d0-ed92-424a-8429-a31153649913","html_url":"https://github.com/gitlabhq/omnibus-gitlab","commit_stats":null,"previous_names":[],"tags_count":4800,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitlabhq%2Fomnibus-gitlab","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitlabhq%2Fomnibus-gitlab/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitlabhq%2Fomnibus-gitlab/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitlabhq%2Fomnibus-gitlab/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitlabhq","download_url":"https://codeload.github.com/gitlabhq/omnibus-gitlab/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254564127,"owners_count":22092122,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T21:02:11.190Z","updated_at":"2025-05-16T16:09:17.488Z","avatar_url":"https://github.com/gitlabhq.png","language":"Ruby","funding_links":[],"categories":["Ruby"],"sub_categories":[],"readme":"# Omnibus GitLab\n\n## Description\n\nThis project creates full-stack platform-specific [downloadable packages for GitLab][downloads].\nFor other installation options please see the\n[GitLab installation page][installation].\n\n## Canonical source\n\nThe source of omnibus-gitlab is [hosted on\nGitLab.com](https://gitlab.com/gitlab-org/omnibus-gitlab) and there are mirrors\nto make contributing as easy as possible.\n\n## Documentation\n\nThe documentation can be found in the [doc directory](doc/_index.md).\n\n## Omnibus fork\n\nOmnibus GitLab is using a fork of [omnibus project](https://github.com/chef/omnibus).  For additional information see the comments in the [Gemfile](/Gemfile).\n\n## Deprecated links\n\n*We left the links below in the readme to preserve old links, but please use the [doc directory](doc/_index.md) to browse the complete documentation.*\n\n## Contributing\n\nPlease see the [contribution guidelines](CONTRIBUTING.md)\n\n## Installation\n\nPlease follow the steps on the [downloads page][downloads].\n\n### After installation\n\nYour GitLab instance should be reachable over HTTP at the IP or hostname of your\nserver. You can login as an admin user with username `root` and password `5iveL!fe`.\n\nSee [doc/maintenance/index.md](doc/maintenance/_index.md) for useful commands\nto control/debug your GitLab instance.\n\n### Configuration options\n\nSee [doc/settings/configuration.md](doc/settings/configuration.md).\n\n#### Configuring the external URL for GitLab\n\nSee [doc/settings/configuration.md](doc/settings/configuration.md#configuring-the-external-url-for-gitlab).\n\n#### Storing Git data in an alternative directory\n\nSee [doc/settings/configuration.md](doc/settings/configuration.md#storing-git-data-in-an-alternative-directory).\n\n#### Changing the name of the Git user / group\n\nSee [doc/settings/configuration.md](doc/settings/configuration.md#change-the-name-of-the-git-user-or-group).\n\n#### Setting up LDAP sign-in\n\nSee [doc/settings/ldap.md](doc/settings/ldap.md).\n\n#### Enable HTTPS\n\nSee [doc/settings/nginx.md](doc/settings/nginx.md#enable-https).\n\n#### Redirect `HTTP` requests to `HTTPS`\n\nSee [doc/settings/nginx.md](doc/settings/nginx.md#redirect-http-requests-to-https).\n\n#### Change the default port and the ssl certificate locations\n\nSee [doc/settings/nginx.md](doc/settings/nginx.md#change-the-default-port-and-the-ssl-certificate-locations).\n\n#### Use non-packaged web-server\n\nFor using an existing Nginx, Passenger, or Apache webserver see [doc/settings/nginx.md](doc/settings/nginx.md#use-a-non-bundled-web-server).\n\n#### Using a non-packaged PostgreSQL database management server\n\nTo connect to an external PostgreSQL DBMS see [doc/settings/database.md](doc/settings/database.md)\n\n#### Using a non-packaged Redis instance\n\nSee [doc/settings/redis.md](doc/settings/redis.md).\n\n#### Adding ENV Vars to the Gitlab Runtime Environment\n\nSee\n[doc/settings/environment-variables.md](doc/settings/environment-variables.md).\n\n#### Changing gitlab.yml settings\n\nSee [doc/settings/gitlab.yml.md](doc/settings/gitlab.yml.md).\n\n#### Specify numeric user and group identifiers\n\nSee [doc/settings/configuration.md](doc/settings/configuration.md#specify-numeric-user-and-group-identifiers).\n\n#### Sending application email via SMTP\n\nSee [doc/settings/smtp.md](doc/settings/smtp.md).\n\n#### Omniauth (Google, Twitter, GitHub login)\n\nOmniauth configuration is documented in\n[docs.gitlab.com](https://docs.gitlab.com/ee/integration/omniauth.html).\n\n#### Adjusting Unicorn settings\n\nSee [doc/settings/unicorn.md](doc/settings/unicorn.md).\n\n#### Setting the NGINX listen address or addresses\n\nSee [doc/settings/nginx.md](doc/settings/nginx.md).\n\n#### Inserting custom NGINX settings into the GitLab server block\n\nSee [doc/settings/nginx.md](doc/settings/nginx.md).\n\n#### Inserting custom settings into the NGINX config\n\nSee [doc/settings/nginx.md](doc/settings/nginx.md).\n\n#### Only start omnibus-gitlab services after a given filesystem is mounted\n\nSee [doc/settings/configuration.md](doc/settings/configuration.md#only-start-omnibus-gitlab-services-after-a-given-filesystem-is-mounted).\n\n### Updating\n\nInstructions for updating your Omnibus installation and upgrading from a manual\ninstallation are in the [update directory](doc/update/).\n\n### Uninstalling Omnibus GitLab\n\nSee [doc/installation/\\_index.md](doc/installation/_index.md#uninstall-the-linux-package-omnibus).\n\n### Common installation problems\n\nThis section has been moved to the separate document [doc/troubleshooting.md](doc/troubleshooting.md).\n\nSection below remains for historical reasons(mainly to not break existing links). Each section contains the link to the new location.\n\n#### Apt error 'The requested URL returned error: 403'\n\nSee [doc/troubleshooting.md](doc/troubleshooting.md#apt-error-the-requested-url-returned-error-403).\n\n#### GitLab is unreachable in my browser\n\nSee [doc/troubleshooting.md](doc/troubleshooting.md#gitlab-is-unreachable-in-my-browser).\n\n#### Emails are not being delivered\n\nSee [doc/troubleshooting.md](doc/troubleshooting.md#emails-are-not-being-delivered).\n\n#### TCP ports for GitLab services are already taken\n\nSee [doc/troubleshooting.md](doc/troubleshooting.md#tcp-ports-for-gitlab-services-are-already-taken).\n\n#### Git SSH access stops working on SELinux-enabled systems\n\nSee [doc/troubleshooting.md](doc/troubleshooting.md#selinux-enabled-systems).\n\n#### Postgres error 'FATAL:  could not create shared memory segment: Cannot allocate memory'\n\nSee [doc/troubleshooting.md](doc/troubleshooting.md#postgresql-error-fatal-could-not-create-shared-memory-segment-cannot-allocate-memory).\n\n#### Reconfigure complains about the GLIBC version\n\nSee [doc/troubleshooting.md](doc/troubleshooting.md#reconfigure-complains-about-the-glibc-version).\n\n#### Reconfigure fails to create the git user\n\nSee [doc/troubleshooting.md](doc/troubleshooting.md#reconfigure-fails-to-create-the-git-user).\n\n#### Failed to modify kernel parameters with sysctl\n\nSee [doc/troubleshooting.md](doc/troubleshooting.md#failed-to-modify-kernel-parameters-with-sysctl).\n\n#### I am unable to install omnibus-gitlab without root access\n\nSee [doc/troubleshooting.md](doc/troubleshooting.md#i-am-unable-to-install-omnibus-gitlab-without-root-access).\n\n#### gitlab-rake assets:precompile fails with 'Permission denied'\n\nSee [doc/troubleshooting.md](doc/troubleshooting.md#gitlab-rake-assetsprecompile-fails-with-permission-denied).\n\n#### 'Short read or OOM loading DB' error\n\nSee [doc/troubleshooting.md](doc/troubleshooting.md#short-read-or-oom-loading-db-error).\n\n### Backups\n\nSee [doc/settings/backups.md](doc/settings/backups.md).\n\n#### Backup and restore omnibus-gitlab configuration\n\nSee [doc/settings/backups.md](doc/settings/backups.md#backup-and-restore-omnibus-gitlab-configuration).\n\n#### Creating an application backup\n\nSee [doc/settings/backups.md](doc/settings/backups.md#creating-an-application-backup).\n\n### Restoring an application backup\n\nSee [restore documentation](https://docs.gitlab.com/ee/administration/backup_restore/restore_gitlab.html#restore-for-linux-package-installations).\n\n### Backup and restore using non-packaged database\n\nIf you are using non-packaged database see [documentation on using non-packaged database](doc/settings/database.md#using-a-non-packaged-postgresql-database-management-server).\n\n### Upload backups to remote (cloud) storage\n\nFor details check [backup documentation](https://docs.gitlab.com/ee/administration/backup_restore/backup_gitlab.html#upload-backups-to-a-remote-cloud-storage).\n\n## Invoking Rake tasks\n\nSee [doc/maintenance/\\_index.md](doc/maintenance/_index.md#invoking-rake-tasks).\n\n## Directory structure\n\nOmnibus-gitlab uses four different directories.\n\n- `/opt/gitlab` holds application code for GitLab and its dependencies.\n- `/var/opt/gitlab` holds application data and configuration files that\n  `gitlab-ctl reconfigure` writes to.\n- `/etc/gitlab` holds configuration files for omnibus-gitlab. These are\n  the only files that you should ever have to edit manually.\n- `/var/log/gitlab` contains all log data generated by components of\n  omnibus-gitlab.\n\n## Omnibus-gitlab and SELinux\n\nAlthough omnibus-gitlab runs on systems that have SELinux enabled, it does not\nuse SELinux confinement features:\n\n- omnibus-gitlab creates unconfined system users;\n- omnibus-gitlab services run in an unconfined context.\n\nThe correct operation of Git access via SSH depends on the labeling of\n`/var/opt/gitlab/.ssh`. If needed you can restore this labeling by running\n`sudo gitlab-ctl reconfigure`.\n\nDepending on your platform, `gitlab-ctl reconfigure` will install SELinux\nmodules required to make GitLab work. These modules are listed in\n[files/gitlab-selinux/README.md](files/gitlab-selinux/README.md).\n\nNSA, if you're reading this, we'd really appreciate it if you could contribute\nback a SELinux profile for omnibus-gitlab :)\nOf course, if anyone else is reading this, you're welcome to contribute the\nSELinux profile too.\n\n### Logs\n\nThis section has been moved to separate document [doc/settings/logs.md](doc/settings/logs.md).\n\n#### Tail logs in a console on the server\n\nSee [doc/settings/logs.md](doc/settings/logs.md#tail-logs-in-a-console-on-the-server).\n\n##### Runit logs\n\nSee [doc/settings/logs.md](doc/settings/logs.md#runit-logs).\n\n##### Logrotate\n\nSee [doc/settings/logs.md](doc/settings/logs.md#logrotate).\n\n##### UDP log shipping (GitLab Enterprise Edition only)\n\nSee [doc/settings/logs.md](doc/settings/logs.md#udp-log-shipping-gitlab-enterprise-edition-only)\n\n### Create a user and database for GitLab\n\nSee [doc/settings/database.md](doc/settings/database.md).\n\n### Configure omnibus-gitlab to connect to it\n\nSee [doc/settings/database.md](doc/settings/database.md).\n\n### Seed the database (fresh installs only)\n\nSee [doc/settings/database.md](doc/settings/database.md).\n\n## Building your own package\n\nSee [the separate build documentation](doc/build/_index.md).\n\n## Running a custom GitLab version\n\nIt is not recommended to make changes to any of the files in `/opt/gitlab`\nafter installing omnibus-gitlab: they will either conflict with or be\noverwritten by future updates. If you want to run a custom version of GitLab\nyou can [build your own package](doc/build/_index.md) or use [another installation\nmethod][CE README].\n\n## Acknowledgments\n\nThis omnibus installer project is based on the awesome work done by Chef in\n[omnibus-chef-server][omnibus-chef-server].\n\n[downloads]: https://about.gitlab.com/downloads/\n[CE README]: https://gitlab.com/gitlab-org/gitlab-foss/blob/master/README.md\n[omnibus-chef-server]: https://github.com/opscode/omnibus-chef-server\n[database.yml.mysql]: https://gitlab.com/gitlab-org/gitlab-foss/blob/master/config/database.yml.mysql\n[svlogd]: http://smarden.org/runit/svlogd.8.html\n[installation]: https://about.gitlab.com/install/\n[gitlab.rb.template]: https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/files/gitlab-config-template/gitlab.rb.template\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitlabhq%2Fomnibus-gitlab","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitlabhq%2Fomnibus-gitlab","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitlabhq%2Fomnibus-gitlab/lists"}