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

# Self-hosting Zespan

> Deploy Zespan on your own infrastructure with an Enterprise license. Full data sovereignty — all traces, metrics, and AI analysis stay within your network.

Self-hosted Zespan is available on the **Enterprise plan**. All traces, metrics, and AI analysis stay within your own infrastructure and never leave your network.

<Note>
  Self-hosting requires an Enterprise license. Contact [enterprise@zespan.com](mailto:enterprise@zespan.com) to get started. You'll receive a license key, Docker registry credentials, deployment guide, and onboarding support.
</Note>

## What you get with Enterprise self-hosting

<CardGroup cols={2}>
  <Card title="Docker image" icon="box">
    A signed Docker image pulled from the Zespan private registry. New versions are published with each release.
  </Card>

  <Card title="License key" icon="key">
    A license key that activates your deployment. Included with your Enterprise agreement.
  </Card>

  <Card title="Data sovereignty" icon="shield">
    No events, traces, or AI results ever leave your infrastructure. Ideal for regulated industries and data-sensitive environments.
  </Card>

  <Card title="Dedicated support" icon="headset">
    A shared Slack channel with the Zespan engineering team for deployment help, upgrades, and escalations.
  </Card>
</CardGroup>

## Infrastructure requirements

Zespan self-hosting requires standard cloud infrastructure. Exact specifications, configuration details, and architecture diagrams are provided in the private deployment guide sent to Enterprise customers.

To discuss infrastructure requirements for your environment, contact [enterprise@zespan.com](mailto:enterprise@zespan.com).

## Deployment

The full deployment guide — including environment configuration, database setup, migration steps, and Docker Compose templates — is provided after your Enterprise license is issued.

To get your license and deployment package, contact [enterprise@zespan.com](mailto:enterprise@zespan.com) with your organization name and expected trace volume.

## Pointing the SDK at your self-hosted instance

When using the Zespan SDK against your self-hosted deployment, set `baseURL` to your API server's URL:

<Tabs>
  <Tab title="TypeScript">
    ```typescript theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
    import { zespan } from "@zespan/sdk";

    zespan.init({
      apiKey: "zsp_your_project_api_key",
      baseURL: "https://api.yourdomain.com",
    });
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
    import zespan

    zespan.init(
        api_key="zsp_your_project_api_key",
        base_url="https://api.yourdomain.com",
    )
    ```
  </Tab>
</Tabs>

## Upgrading

Upgrade instructions and migration guides are included in the deployment package and sent with each new release. Enterprise customers are notified of new versions through their dedicated Slack channel.

## Support

Enterprise customers have access to:

* A dedicated Slack channel with the Zespan engineering team
* Upgrade assistance and migration guides

Reach us at [enterprise@zespan.com](mailto:enterprise@zespan.com) or through your shared Slack channel.