> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blink.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Deployments

> How agent deployments work in Blink.

A deployment is a versioned snapshot of your agent code running on the server.

## Creating Deployments

Deploy your agent using the CLI:

```bash theme={null}
blink deploy
```

You can include a message describing the deployment:

```bash theme={null}
blink deploy -m "Added GitHub integration"
```

## Deployment States

| State       | UI Label  | Description                             |
| ----------- | --------- | --------------------------------------- |
| `pending`   | Pending   | Deployment created, waiting to start    |
| `deploying` | Deploying | Container is being created and started  |
| `success`   | Ready     | Agent is running and receiving requests |
| `failed`    | Failed    | Deployment failed (check error message) |

## Viewing Deployments

View deployment history in the web UI under your agent's **Deployments** tab. Each deployment shows:

* **Number** - Sequential deployment number (e.g., #1, #2, #3)
* **Status** - Current state with indicator
* **Duration** - How long the deployment took
* **Message** - Optional description from `-m` flag
* **Created by** - User who triggered the deployment

The active deployment (receiving traffic) is marked with an "Active" badge.

<img src="https://mintcdn.com/blink-8fc97cdb/-JnKEx3UGKxJolE7/images/cloud-agent-deployments-listing.png?fit=max&auto=format&n=-JnKEx3UGKxJolE7&q=85&s=3c1af6fba44a1799e64fa84310626d36" alt="Deployments" width="2172" height="1576" data-path="images/cloud-agent-deployments-listing.png" />

## Re-deploying

To redeploy a previous deployment, click the menu icon on any deployment in the list and select **Re-deploy**. This creates a new deployment using the same code but with the current environment variables.
