> ## Documentation Index
> Fetch the complete documentation index at: https://checkly-422f444a-paula-tree-202-entitlements-group-troubles.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Private Locations Quick Start

> Get up and running with Private Locations in minutes. Follow this step-by-step guide to deploy your first Checkly Agent.

# Quick Start Guide

Follow this step-by-step guide to set up your first Private Location and start monitoring internal systems.

## Prerequisites

Before you begin, ensure you have:

* **Checkly Account**: Owner or Admin permissions
* **Infrastructure**: Container runtime (Docker, Podman, or similar)
* **Network Access**: Outbound HTTPS to `agent.checklyhq.com`
* **Target Access**: Network connectivity to your applications

## Step 1: Create Your Private Location

Navigate to [Private Locations](https://app.checklyhq.com/private-locations) and click "New private location":

<img src="https://mintcdn.com/checkly-422f444a-paula-tree-202-entitlements-group-troubles/Svge-qdMueX0ak-N/images/private-locations/pl_started_2.png?fit=max&auto=format&n=Svge-qdMueX0ak-N&q=85&s=a9b9a14197201fc29ad4a6d2313d8bdf" alt="Create a new private location with name and icon" width="1325" height="898" data-path="images/private-locations/pl_started_2.png" />

Provide a descriptive name and choose an icon that represents your location or environment.

## Step 2: Secure Your API Key

Copy and securely store the generated API key. This key authenticates your agents with Checkly:

<img src="https://mintcdn.com/checkly-422f444a-paula-tree-202-entitlements-group-troubles/Svge-qdMueX0ak-N/images/private-locations/pl_started_3.png?fit=max&auto=format&n=Svge-qdMueX0ak-N&q=85&s=cd44eaee8ac6043f21c7e66284181092" alt="Copy and securely store your Private Location API key" width="1325" height="898" data-path="images/private-locations/pl_started_3.png" />

<Warning>
  The API key is only shown once during creation. Store it securely in your secrets management system.
</Warning>

## Step 3: Deploy Your First Agent

Start a Checkly Agent using Docker:

```bash theme={null}
docker run -e API_KEY="pl_your_api_key_here" -d checkly/agent:latest
```

For production deployments, consider:

* Using specific version tags instead of `latest`
* Configuring resource limits and restart policies
* Setting up monitoring and logging for the agent containers

## Step 4: Verify Agent Connection

Refresh your Private Locations page to see your active agents:

<img src="https://mintcdn.com/checkly-422f444a-paula-tree-202-entitlements-group-troubles/Svge-qdMueX0ak-N/images/private-locations/pl_started_4.png?fit=max&auto=format&n=Svge-qdMueX0ak-N&q=85&s=a3fa7a6c214303d1e9ddf425a7030a97" alt="Verify that your Checkly Agent is connected and running" width="1325" height="898" data-path="images/private-locations/pl_started_4.png" />

The interface shows:

* Number of active agents
* Last connection time
* Agent health status

## Step 5: Configure Your Checks

When creating checks, select your Private Location from the available locations:

<img src="https://mintcdn.com/checkly-422f444a-paula-tree-202-entitlements-group-troubles/Svge-qdMueX0ak-N/images/private-locations/pl_started_5.png?fit=max&auto=format&n=Svge-qdMueX0ak-N&q=85&s=2d045733c31de24485be9960d5757f53" alt="Select your Private Location when creating or editing checks" width="1271" height="525" data-path="images/private-locations/pl_started_5.png" />

Deselect other locations to ensure your checks run exclusively from your Private Location.

## Resource Requirements

<Info>
  **Memory Guidelines:**

  * API checks: \~150MB per concurrent check
  * Browser checks: \~1.5GB per concurrent check
  * Minimum recommended: 2 CPU cores, 4GB RAM for mixed workloads
</Info>

## Next Steps

Once your first agent is running, explore these advanced topics:

<CardGroup cols={2}>
  <Card title="Agent Configuration" href="/detect/private-locations/agent-configuration">
    Learn advanced agent configuration options, environment variables, and production settings
  </Card>

  <Card title="Kubernetes Deployment" href="/detect/private-locations/kubernetes-deployment">
    Deploy Private Locations on Kubernetes for production-scale monitoring
  </Card>

  <Card title="Use Cases" href="/detect/private-locations/use-cases">
    Explore real-world examples and deployment patterns
  </Card>

  <Card title="CLI Integration" href="/detect/private-locations/cli-integration">
    Integrate Private Locations with monitoring-as-code workflows
  </Card>
</CardGroup>

<Tip>
  Start small with a single agent to test connectivity and functionality, then scale based on your monitoring requirements and workload patterns.
</Tip>
