2019-05-27 15:53:21 -04:00
---
2020-05-29 14:08:26 -04:00
stage: Verify
2021-05-26 11:10:57 -04:00
group: Pipeline Execution
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
2019-06-07 04:00:41 -04:00
type: howto
2019-05-27 15:53:21 -04:00
---
2022-06-06 14:09:02 -04:00
# Disabling GitLab CI/CD **(FREE)**
2016-01-06 14:05:22 -05:00
2022-06-06 14:09:02 -04:00
GitLab CI/CD is enabled by default on all new projects.
2021-09-02 17:08:51 -04:00
If you use an external CI/CD server like Jenkins or Drone CI, you can
2021-08-23 14:11:07 -04:00
disable GitLab CI/CD to avoid conflicts with the commits status
2016-01-06 14:05:22 -05:00
API.
2022-06-06 14:09:02 -04:00
You can disable GitLab CI/CD:
2019-06-07 04:00:41 -04:00
2022-06-06 14:09:02 -04:00
- [For each project ](#disable-cicd-in-a-project ).
- [For all new projects on an instance ](../administration/cicd.md ).
2016-01-06 14:05:22 -05:00
2022-06-06 14:09:02 -04:00
These changes do not apply to projects in an
[external integration ](../user/project/integrations/index.md#available-integrations ).
2021-09-02 17:08:51 -04:00
2022-06-06 14:09:02 -04:00
## Disable CI/CD in a project
2021-09-02 17:08:51 -04:00
2022-06-06 14:09:02 -04:00
When you disable GitLab CI/CD:
2019-10-01 20:06:26 -04:00
2022-06-06 14:09:02 -04:00
- The **CI/CD** item in the left sidebar is removed.
- The `/pipelines` and `/jobs` pages are no longer available.
- Existing jobs and pipelines are hidden, not removed.
2016-01-06 14:05:22 -05:00
2022-06-06 14:09:02 -04:00
To disable GitLab CI/CD in your project:
2019-10-01 20:06:26 -04:00
2021-07-30 23:09:05 -04:00
1. On the top bar, select **Menu > Projects** and find your project.
1. On the left sidebar, select **Settings > General** .
1. Expand **Visibility, project features, permissions** .
2022-06-06 14:09:02 -04:00
1. In the **Repository** section, turn off **CI/CD** .
1. Select **Save changes** .
2019-12-08 22:07:57 -05:00
2022-06-06 14:09:02 -04:00
## Enable CI/CD in a project
2019-12-08 22:07:57 -05:00
2022-06-06 14:09:02 -04:00
To enable GitLab CI/CD in your project:
2019-10-01 20:06:26 -04:00
2022-06-06 14:09:02 -04:00
1. On the top bar, select **Menu > Projects** and find your project.
1. On the left sidebar, select **Settings > General** .
1. Expand **Visibility, project features, permissions** .
1. In the **Repository** section, turn on **CI/CD** .
1. Select **Save changes** .
2016-01-06 14:05:22 -05:00
2019-06-07 04:00:41 -04:00
<!-- ## Troubleshooting
Include any troubleshooting steps that you can foresee. If you know beforehand what issues
one might have when setting this up, or when something is changed, or on upgrading, it's
important to describe those, too. Think of things that may go wrong and include them here.
This is important to minimize requests for support, and to avoid doc comments with
questions that you know someone might ask.
Each scenario can be a third-level heading, e.g. `### Getting error message X` .
If you have none to add when creating a doc, leave this section in place
but commented out to help encourage others to add to it in the future. -->
