> 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/3.0/new-to-harness-ci/onboarding-guide.md).

# Get Started with Harness CI

Welcome to the Harness 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.

### Prerequisites <a href="#prerequisites" id="prerequisites"></a>

Before beginning the walkthroughs in this guide, ensure you have:

* Access to a Harness account.
* Access to a source code repository such as [Harness Code Repository](/code-repository/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-ai/new-to-harness-platform/get-started.md) and [Harness Platform key concepts](/harness-ai/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're 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](/harness-ai/use-harness-platform/connectors/code-repositories/ref-source-repo-provider.md)
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. To learn more, refer to the [Harness Cloud documentation](/continuous-integration/use-harness-ci/use-harness-ci/set-up-build-infrastructure/use-harness-cloud-build-infrastructure.md).
   * 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>

Explore the documentation to learn what your Harness CI pipelines can do.

* [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)
* [Use caching](/continuous-integration/use-harness-ci/use-harness-ci/caching-ci-data.md) and [manage dependencies](/continuous-integration/use-harness-ci/use-harness-ci/manage-dependencies.md).
* Run [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).
* [Use plugins](/continuous-integration/use-harness-ci/use-harness-ci/use-drone-plugins/explore-ci-plugins.md) and [write your own plugins](/continuous-integration/use-harness-ci/use-harness-ci/use-drone-plugins/custom_plugins.md).
* [Explore CI Tutorials and Code Samples](/continuous-integration/troubleshooting-and-resources/tutorials-and-code-samples.md) for your use case.
* [Find the right build infrastructure for you](/continuous-integration/use-harness-ci/use-harness-ci/set-up-build-infrastructure/which-build-infrastructure-is-right-for-me.md).