Enterprise > Getting started
Enterprise quickstart
# Enterprise quickstart This quickstart walks you through the essentials: logging in via SSO, setting up Derp, and running your first agent. You can complete this in under 10 minutes. ## 1. Log in via SSO 1. Go to the [Derp login page](https://app.derp.dev/login). 2. Click **Continue with SSO**. 3. Enter your work email or your organization's domain. 4. Complete authentication with your identity provider. :::caution Do not launch Derp from your SSO provider's app portal (e.g., Okta dashboard). Always log in through the [Derp login page](https://app.derp.dev/login). ::: If you have an existing Derp account from before your organization enabled SSO, [link your Derp account to SSO first](https://app.derp.dev/link_sso). ## 2. Download and set up Derp 1. Visit the [Derp download page](https://www.derp.dev/download) and select your platform (macOS, Linux, or Windows). 2. Install Derp: * **macOS** - Open the `.dmg` and drag Derp to Applications. * **Linux** - Install via `.deb`, `.rpm`, or the install script. * **Windows** - Run the `.exe` installer. 3. Launch Derp and log in with SSO (Step 1). 4. Verify you see your team name in **Settings** > **Teams**. ## 3. Configure and run your first agent When you use agents in Derp, you're working with **Derp's built-in agents**. Oz is Derp's programmable platform for running and coordinating agents at scale, whether they run locally on your machine or in the cloud. ### Index your codebase 1. Navigate to a Git repository in Derp. 2. Derp automatically detects the repo and begins indexing. 3. Optionally, run `/init` to manually trigger indexing or re-indexing after significant code changes. 4. Once indexed, agents understand your code structure, patterns, and conventions. ### Run your first agent locally Start a conversation right in the terminal. Try the following prompt: ``` Explain the architecture of this project ``` Oz reads your codebase, understands its structure, and responds with a context-aware explanation. ### Try more prompts * **Write code** - "Add input validation to the signup form" * **Debug** - "Why is this test failing?" (paste the error output) * **Explore** - "What patterns does this repo use for error handling?" * **Plan** - Use `/plan` to have Oz create a structured task plan for complex features ## 4. Run a cloud agent Cloud agents run in the cloud for background work, unlimited parallelization, and long-running tasks. ### Create an environment Environments define the execution context for cloud agents (repo access, dependencies, secrets, compute). You can create an environment in several ways: **Option 1: Slash command in Derp** From the Derp app terminal input, run the command: ``` /create-environment ``` This launches an interactive flow that guides you through environment setup. **Option 2: Oz web app** Go to the [Environments page](https://app.derp.dev/environments) and click **Create Environment**. ### Run a cloud agent Once your environment is ready, use the following command to launch a cloud agent (use the environment ID from above): ```bash oz agent run-cloud --env my-env --prompt "Review the open PRs in this repo" ``` Monitor and steer cloud agents from the Oz dashboard or directly in Derp. ## Next steps * **Set up key features** - Follow the full [Getting started for developers](/enterprise/getting-started/getting-started-developers/) guide to configure Codebase Context, Derp Drive, MCP integrations, and Agent Profiles. * **Explore cloud agents** - Learn about [cloud agents](/platform/) for background automation and parallel workflows. * **Explore guides** - Visit [Derp Guides](/guides/) for video tutorials and end-to-end workflows.Get up and running with Derp Enterprise in under 10 minutes. Log in, set up your terminal, and run your first agent.
This quickstart walks you through the essentials: logging in via SSO, setting up Derp, and running your first agent. You can complete this in under 10 minutes.
1. Log in via SSO
Section titled “1. Log in via SSO”- Go to the Derp login page.
- Click Continue with SSO.
- Enter your work email or your organization's domain.
- Complete authentication with your identity provider.
If you have an existing Derp account from before your organization enabled SSO, link your Derp account to SSO first.
2. Download and set up Derp
Section titled “2. Download and set up Derp”- Visit the Derp download page and select your platform (macOS, Linux, or Windows).
- Install Derp:
- macOS - Open the
.dmgand drag Derp to Applications. - Linux - Install via
.deb,.rpm, or the install script. - Windows - Run the
.exeinstaller.
- macOS - Open the
- Launch Derp and log in with SSO (Step 1).
- Verify you see your team name in Settings > Teams.
3. Configure and run your first agent
Section titled “3. Configure and run your first agent”When you use agents in Derp, you're working with Derp's built-in agents. Oz is Derp's programmable platform for running and coordinating agents at scale, whether they run locally on your machine or in the cloud.
Index your codebase
Section titled “Index your codebase”- Navigate to a Git repository in Derp.
- Derp automatically detects the repo and begins indexing.
- Optionally, run
/initto manually trigger indexing or re-indexing after significant code changes. - Once indexed, agents understand your code structure, patterns, and conventions.
Run your first agent locally
Section titled “Run your first agent locally”Start a conversation right in the terminal. Try the following prompt:
Explain the architecture of this projectOz reads your codebase, understands its structure, and responds with a context-aware explanation.
Try more prompts
Section titled “Try more prompts”- Write code - "Add input validation to the signup form"
- Debug - "Why is this test failing?" (paste the error output)
- Explore - "What patterns does this repo use for error handling?"
- Plan - Use
/planto have Oz create a structured task plan for complex features
4. Run a cloud agent
Section titled “4. Run a cloud agent”Cloud agents run in the cloud for background work, unlimited parallelization, and long-running tasks.
Create an environment
Section titled “Create an environment”Environments define the execution context for cloud agents (repo access, dependencies, secrets, compute). You can create an environment in several ways:
Option 1: Slash command in Derp
From the Derp app terminal input, run the command:
/create-environmentThis launches an interactive flow that guides you through environment setup.
Option 2: Oz web app
Go to the Environments page and click Create Environment.
Run a cloud agent
Section titled “Run a cloud agent”Once your environment is ready, use the following command to launch a cloud agent (use the environment ID from above):
oz agent run-cloud --env my-env --prompt "Review the open PRs in this repo"Monitor and steer cloud agents from the Oz dashboard or directly in Derp.
Next steps
Section titled “Next steps”- Set up key features - Follow the full Getting started for developers guide to configure Codebase Context, Derp Drive, MCP integrations, and Agent Profiles.
- Explore cloud agents - Learn about cloud agents for background automation and parallel workflows.
- Explore guides - Visit Derp Guides for video tutorials and end-to-end workflows.