Getting started with Harness Platform
The Harness Platform helps developers and DevOps teams deliver software faster, more securely, and at lower cost—without compromising quality, reliability, or governance.
This guide helps you get started with the Harness Platform.
Table of Content
- Access your Harness account
- Key Concept
- Create organization and project
- Manage users
- Manage shared resources
Step 1: Access your Harness account
Harness provides a free tier of the Platform to help you get started with software delivery.
Harness is available in both SaaS and Self-Managed (on-premises) editions.
- SaaS
- Self-Managed Enterprise Edition
Harness SaaS is a fully managed, cloud-hosted version of the Harness Platform. Harness offers Free, Team, and Enterprise plans. For details about plan features and pricing, see Subscriptions and licenses.
Sign up with the Free plan and then sign in to your Harness account.
New Accounts on the Team or Enterprise plans are created through an invitation from an Account Administrator. You must accept the invitation email before you can sign in. If you are unsure who your Account Administrator is or need assistance, contact Harness Support.
Harness Self-Managed Enterprise Edition also known as Self-Managed Platform (SMP) is a Kubernetes-native, self-managed deployment of the Harness Platform that runs on your own public or private cloud infrastructure. For an overview, see Harness Self-Managed Enterprise Edition.
This option requires:
- A valid Harness SMP license key.
- Access to download the Harness SMP software (container images and Helm chart).
Contact Harness Support to obtain access to your license key.
Once you have the license key and download access, install and configure Harness SMP by following the instructions. After installation, create your Harness SMP account and sign in to your instance at http://YOUR_DOMAIN_NAME/auth/#/signin.
Step 2: Key concepts
Before you begin, get familiar with the terminology and functionality commonly used across the Harness Platform and its modules.
Step 3: Create organization, project and invite collaborators
Harness recommends creating a sample project with a few pilot users to get familiar with the Harness Platform.
To get started, follow the steps below:
Once you are familiar with the platform, you can create additional organizations and projects to represent your business units and product development initiatives.
Step 4: Manage users
To enable broad or fine-grained permissions, configure authentication and role-based access control (RBAC) for your Harness account.
You can also automate user provisioning from external sources, including user group memberships and role assignments. The following methods are supported:
Step 5: Manage shared resources
Harness provides shared resources such as delegates, connectors, and secrets. These resources are used across most Harness Platform operations.
You can configure shared resources at the account, organization, or project scope, depending on how broadly you want them to be available. For more information, see the documentation below.
- Add a secret manager
- Install delegate on Kubernetes or Docker
- Build and set up a delegate with a minimal image type
- Install Harness Delegate on Google Kubernetes Engine (GKE) With Workload Identity
Automate setup of shared resources
Shared resources created at the account scope are available to all organizations and projects in your account. Harness recommends using the Harness Terraform Provider or the Harness REST API to automate the configuration of these shared resources.
- Terraform Provider
- Harness REST API
You can achieve a high degree of automation and repeatability when deploying and managing resources in Harness by integrating the Harness Terraform Provider into your onboarding processes.
Use the following documentation and the Harness Terraform Registry to install the Harness Terraform Provider and configure Terraform:
Harness provides a sample Terraform deployment repository for reference and reuse.
For best results, follow Terraform and CI/CD best practices, including:
- Source control: Store Terraform configurations in a version control system such as Git to track changes and support collaboration.
- Automated plan and apply: Use CI/CD pipelines to automate
terraform planandterraform apply. For example, you can use Harness CD pipelines to automate onboarding and service configuration. - State management: Use a remote backend, such as Terraform Cloud or AWS S3 with state locking, to maintain consistent state across teams and environments.
- Notifications: Configure notifications for Terraform actions so failures during
terraform applyare reported through channels such as Slack or email. - Monitoring and logging: Monitor infrastructure using tools like Grafana or Prometheus, and log changes and activities to support auditing and troubleshooting.
- Secrets management: Secure sensitive data, such as API keys, using a secrets manager like HashiCorp Vault or AWS Secrets Manager.
- Backups: Regularly back up Terraform state files to protect against data loss.
- Documentation: Maintain clear documentation for Terraform configurations and modules, including design decisions and usage instructions, to ensure maintainability and team alignment.
The Harness REST API provides programmatic access to Harness resources, allowing you to automate configuration, and manage the platform at scale.
For more information, go to Get started with Harness API.
Explore Harness modules
After completing onboarding to the Harness Platform, you can begin using Harness modules to implement and automate your software delivery lifecycle (SDLC). Refer to the module documentation to get started with Harness modules and create CI/CD pipelines tailored to your delivery workflows..
In addition, the Harness Platform provides several cross-module capabilities that help standardize configuration, improve governance, and optimize pipeline execution across modules, including:
- Approvals
- Dashboards
- Global default settings
- Governance and monitored services
- Harness AIDA
- Notifications
- Templates
- Triggers
- Variables, expressions, and runtime input
Become a Harness Certified Expert
For an interactive onboarding experience with additional use cases and features, check out Harness University.