Quickstart Guide
A visual quickstart is also available by logging in to the Garden Dashboard. The Dashboard can show you the status of your builds, deployments and stream logs from your services in real-time. To get started, click Dashboard Quickstart.
Garden is an all-in-one DevOps platform that enables you to build, test, deploy your applications and infrastructure in a single, unified workflow.
In this quickstart, we'll introduce you to the one interactive command you'll spend most of your time in as a developer:
garden dev
.In just 2 steps, we'll:
- Install Garden
- Deploy an example application to a remote ephemeral Kubernetes cluster.
Install the Garden CLI for your platform:
macOS
Linux
Windows
brew install garden-io/garden/garden-cli
curl -sL https://get.garden.io/install.sh | bash
Open PowerShell as an administrator and run:
Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/garden-io/garden/master/support/install.ps1'))
We also recommend adding an exclusion folder for the
.garden
directory in your repository root to Windows Defender:Add-MpPreference -ExclusionPath "C:\Path\To\Your\Repo\.garden"
This will significantly speed up the first Garden build of large projects on Windows machines.
Next, we clone the example project from GitHub and change into the project directory:
git clone https://github.com/garden-io/quickstart-example.git && cd quickstart-example
From inside the project directory, start the dev console by running:
garden dev
Next, you need to log in to the Garden web dashboard by running the log in command from the dev console:
login
Now you are ready to deploy, run:
deploy
You should now be able to visit the example project at the link output by Garden.
The quickstart also comes with some tests of the unit and end-to-end variety. To run your unit test, just run
test unit
. To run your end-to-end test, run test e2e
. Easy!The project itself doubles as an interactive guide that walks you through some common Garden commands and workflows. We encourage you to give it a spin!
You can run all the same commands with the CLI directly without starting the dev console. Simply run
garden login
or garden deploy
from your terminal. This is e.g. how you'd use Garden in CI.Now that you have Garden installed and seen its basic capabilities it's time to take the next steps.
If you'd like to better understand how a Garden project is configured, we recommend going through our first project tutorial which walks you through configuring a Garden project step-by-step.
If you like to dive right in and configure your own project for Garden, we recommend referencing our example projects on GitHub and the section of our docs title Using Garden, which covers all parts of Garden in detail.
If you have any questions or feedback—or just want to say hi 🙂—we encourage you to join our Discord community!