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

# Deploy Tokens

> Issue, rotate, revoke, and copy deploy token secrets from the desktop client.

<Card title="Read the shared deploy token model" icon="lock" href="/fundamentals/v2/core-objects/deploy-tokens">
  Learn when to use deploy tokens instead of a linked human device.
</Card>

## Where Deploy Tokens Live

Open an environment window and switch to **Deploy Tokens**. This view is scoped to the current
environment so you can keep automation credentials tight.

{/* ghostable:screenshot-output desktop-deploy-tokens-list:start */}

<img className="block dark:hidden w-full" src="https://mintcdn.com/ghostable/BOl2AUG1DFr1k8ob/images/generated/screenshots/ghostable-desktop/environment-deploy-tokens-list-light.png?fit=max&auto=format&n=BOl2AUG1DFr1k8ob&q=85&s=27f3f2cede9b3077737fb91ce897bf21" alt="Ghostable desktop environment window showing the Deploy Tokens section with existing tokens and the create action." width="2440" height="1344" data-path="images/generated/screenshots/ghostable-desktop/environment-deploy-tokens-list-light.png" />

<img className="hidden dark:block w-full" src="https://mintcdn.com/ghostable/BOl2AUG1DFr1k8ob/images/generated/screenshots/ghostable-desktop/environment-deploy-tokens-list-dark.png?fit=max&auto=format&n=BOl2AUG1DFr1k8ob&q=85&s=97a3a721bfe6ccf629e8e4a878a9f8c0" alt="Ghostable desktop environment window showing the Deploy Tokens section with existing tokens and the create action." width="2440" height="1344" data-path="images/generated/screenshots/ghostable-desktop/environment-deploy-tokens-list-dark.png" />

## What You Can Do

Desktop supports the full token lifecycle:

* create a token,
* rotate the cryptographic secret for an existing token,
* revoke a token,
* delete a token record.

When you create or rotate a token, the app shows the resulting automation secrets so you can move
them into your CI secret manager immediately.

## Export Block for CI

The result sheet includes a copyable environment-variable block so you can paste the issued values
into GitHub Actions, your deployment provider, or another secret manager workflow.

{/* ghostable:screenshot-output desktop-deploy-token-result:start */}

<img className="block dark:hidden w-full" src="https://mintcdn.com/ghostable/BOl2AUG1DFr1k8ob/images/generated/screenshots/ghostable-desktop/environment-deploy-token-result-light.png?fit=max&auto=format&n=BOl2AUG1DFr1k8ob&q=85&s=5d902c20981b31f22bf0b7853fc23a99" alt="Ghostable desktop deploy token result window showing the one-time token secrets and the copyable CI environment-variable block." width="2440" height="1160" data-path="images/generated/screenshots/ghostable-desktop/environment-deploy-token-result-light.png" />

<img className="hidden dark:block w-full" src="https://mintcdn.com/ghostable/BOl2AUG1DFr1k8ob/images/generated/screenshots/ghostable-desktop/environment-deploy-token-result-dark.png?fit=max&auto=format&n=BOl2AUG1DFr1k8ob&q=85&s=fef8ec62989e289cd860795dc4105f69" alt="Ghostable desktop deploy token result window showing the one-time token secrets and the copyable CI environment-variable block." width="2440" height="1160" data-path="images/generated/screenshots/ghostable-desktop/environment-deploy-token-result-dark.png" />

<Warning>
  Ghostable only shows the private token material at creation or rotation time. If you lose it,
  issue a fresh secret and update your automation.
</Warning>

## Continue

<CardGroup>
  <Card title="Use CLI for automation" icon="terminal" href="/cli/v2/workflows/deploy-tokens">
    Prefer the terminal flow when you are provisioning CI from an existing shell workflow.
  </Card>

  <Card title="Understand CI deployment flows" icon="rocket" href="/cli/v2/automation-and-ci/deployments">
    See how deploy tokens are consumed in automation and provider-specific setups.
  </Card>
</CardGroup>
