Home / Keptn v1 Docs / Release 1.y.z / Manage Keptn Projects / Start a project
In Keptn, a project is a structure that allows organizing your services. A project is stored as a Git repository and contains a branch for each stage defined for the project (e.g., dev, staging, and production stage).
Before you create a project:
You must Install Keptn on a Kubernetes cluster that has kubectl installed.
In most cases, you should also install the Keptn CLI and authenticate the Keptn CLI and Bridge. You can create projects and services, trigger sequences, and many other common tasks using the Keptn Bridge rather than the command line but you may prefer using the command line and some tasks can only be accomplished from the command line. If you want to use the command line to create your project, you must install and authenticate the CLI.
We also suggest reading Plan your project to anticipate some of the choices you must make as you create a new project.
Before you create the project, you must create some resources that are required to create a project:
A new, unitialized Git-based upstream repository that will store all the configuration and data information that Keptn needs as well as a user token for that repository. See Git-based upstream for details.
A shipyard file
that defines the
stages for your project.
You cannot add, remove, or rename
stages after you create the project.
A shipyard.yaml file like the following is enough to create the project:
apiVersion: spec.keptn.sh/0.2.3 kind: "Shipyard" metadata: name: "shipyard-sockshop" spec: stages: - name: "dev" - name: "hardening" - name: "production"
namemust start with a lowercase letter and contain only lowercase letters, numbers, and hyphens
Create this file on your local system; it is passed to the project’s upstream Git repository for this project.
This “stub” shipyard file is enough to create a project. You must include sequences, tasks, etc in the shipyard before running it. You can add those before or after you create the project. See the Define Keptn Projects section for information about how to define sequences and tasks for your project.
You can create a project in either of the following ways:
The Create a Keptn Project and Service video shows how to create a Keptn project and service from the Keptn Bridge.
For written instructions, see Create a new project in Bridge.
To create a project from the command line, use the keptn create project command and pass a shipyard file.
For example, you could create a new project with the following command line:
keptn create project PROJECTNAME --shipyard=FILEPATH --git-user=GIT_USER --git-token=GIT_TOKEN --git-remote-url=GIT_REMOTE_URL
See the reference page for details about arguments and options for this command.