> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/continuous-integration/new-to-harness-ci/onboarding-guide.md).

# Get Started with Harness CI

A self-service onboarding guide for Harness CI.

Welcome to the Harness Continuous Integration (CI) onboarding guide. Discover how Harness accelerates software builds, enhances developer productivity, and streamlines CI processes with [intelligence features](/continuous-integration/use-harness-ci/use-harness-ci/harness-ci-intelligence.md), AI-driven insights, and hyper-optimized build infrastructure.

This guide will help you quickly get started with Harness CI, from setup to running your first build.

### Before you begin <a href="#prerequisites" id="prerequisites"></a>

Before you onboard CI, ensure you have the following:

* Access to a Harness account.
* Access to a source code repository such as [Harness Code Repository](/code-repository/2.0/new-to-harness-code/overview.md).
* Have reviewed [CI overview](/continuous-integration/new-to-harness-ci/overview.md) and [CI key concepts](/continuous-integration/new-to-harness-ci/key-concepts.md).
* Have reviewed the [Harness Platform onboarding guide](/harness-platform/new-to-harness-platform/get-started.md) and [Harness Platform key concepts](/harness-platform/new-to-harness-platform/overview.md).
* Have reviewed the [Harness CI migration guides](/continuous-integration/use-harness-ci/migrate-to-harness-ci.md) if you are migrating from another CI provider.

### Create your first Harness CI pipeline <a href="#create-your-first-harness-ci-pipeline" id="create-your-first-harness-ci-pipeline"></a>

This getting started guide will walk you through setting up a build pipeline for the first time.

{% tabs %}
{% tab title="Interactive Guide" %}
{% embed url="<https://app.tango.us/app/embed/e56c08cc-4d5c-40b0-a6f7-f8cf27a06a89?skipCover=false&defaultListView=false&skipBranding=false&makeViewOnly=false&hideAuthorAndDetails=true>" %}
Create your first CI Pipeline
{% endembed %}
{% endtab %}

{% tab title="Step-by-step" %}

#### Create a pipeline <a href="#create-a-pipeline" id="create-a-pipeline"></a>

1. Click the module selector in the top left and navigate to the Continuous Integration module.
2. Click **Pipelines**
3. Click **+ Create a Pipeline**.
4. Enter the name of your pipeline.
5. Click **Start**.

#### Add and configure a CI stage <a href="#add-and-configure-a-ci-stage" id="add-and-configure-a-ci-stage"></a>

1. Click **Add Stage**.
2. Select **Build** as your stage type and name your stage.
3. Select your git provider. If you choose you a third party provider, you will need to set up a connector. Refer to the [connectors' documentation](broken://spaces/3F2TpHXhur2QtQnORSM9/pages/GUm4hD56DXH8VkQHOSzk)
4. Select your code repository.
5. Click **Set up Stage**.

#### Choose your infrastructure <a href="#choose-your-infrastructure" id="choose-your-infrastructure"></a>

In your CI stage:

1. Click the **Infrastructure** tab.
2. Choose **Cloud**.
   * This will run the build on Harness Cloud. Go to the [Harness Cloud documentation](/continuous-integration/use-harness-ci/use-harness-ci/set-up-build-infrastructure/use-harness-cloud-build-infrastructure.md) for more information.
   * Learn more about [which build infrastructure option is right for you](/continuous-integration/use-harness-ci/use-harness-ci/set-up-build-infrastructure/which-build-infrastructure-is-right-for-me.md).
3. Leave the default options for the operating system and architecture.
4. Click **Continue**.

#### Create your execution steps <a href="#create-your-execution-steps" id="create-your-execution-steps"></a>

In your CI stage:

1. Click the **Execution** tab.
2. Click the plus button to add a step.
3. Find and select the **Run** step from the step library.
4. Name your run step.
5. Enter your build command. For example:

   ```
   echo "Harness CI is fast"
   ```
6. Click **Apply Changes**.
7. Click **Save**.

#### Run your pipeline <a href="#run-your-pipeline" id="run-your-pipeline"></a>

In your pipeline:

1. Click **Run**.
2. Select **Git Branch** as your build type.
3. Enter your branch name.
4. Click **Run Pipeline**.

Congratulations on running your first CI pipeline!
{% endtab %}
{% endtabs %}

***

### Next Steps <a href="#next-steps" id="next-steps"></a>

* [Build images, push images, and upload artifacts](/continuous-integration/use-harness-ci/use-harness-ci/build-and-upload-artifacts/build-and-upload-an-artifact.md): Build images as a part of your pipeline.
* [Caching](/continuous-integration/use-harness-ci/use-harness-ci/caching-ci-data.md) and [dependencies](/continuous-integration/use-harness-ci/use-harness-ci/manage-dependencies.md): Make builds more efficient.
* [Scripts](/continuous-integration/use-harness-ci/use-harness-ci/run-step-settings.md) and [tests](/continuous-integration/use-harness-ci/use-harness-ci/run-tests.md): Run custom scripts and tests in your pipeline.
* [Plugins](/continuous-integration/use-harness-ci/use-harness-ci/use-drone-plugins/explore-ci-plugins.md) or [custom plugins](/continuous-integration/use-harness-ci/use-harness-ci/use-drone-plugins/custom_plugins.md): Use plugins to extend your pipeline.
* [CI tutorials and code samples](/continuous-integration/troubleshooting-and-resources/tutorials-and-code-samples.md): Find samples for common workflows and use cases.
* [Build infrastructure](/continuous-integration/use-harness-ci/use-harness-ci/set-up-build-infrastructure/which-build-infrastructure-is-right-for-me.md): Select infrastructure based on your build requirements.

{% @harness-feedback/feedback %}