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

# Licensing

Convoy offers two self-hosted plans: `Community (free)` and `Premium`. This documentation will guide you on how to get a Premium license key and configure it on your Convoy instance(s).

## Getting a Premium License

For the **Premium** plan, buy a license key through self-serve checkout and you'll receive it right away. [Buy a Premium license key](https://app.getmeasure.com/c/convoy/buy/pl_3FQ39Hnv9nPQJcdSop18TC0pJxh).

If you have a special use case, such as the **Enterprise** option on our [self-hosted pricing page](https://www.getconvoy.io/pricing), book a call with our team to discuss your requirements.

<Card title="Book a Call with Our Team" icon="calendar">
  <div style={{padding: "16px 0"}}>
    <p style={{marginBottom: "16px"}}>
      Have a special use case or need the Enterprise plan? Book a 30-minute call with our team to discuss your requirements.
    </p>

    <a
      href="https://cal.com/convoy/30min"
      target="_blank"
      rel="noopener noreferrer"
      style={{
  display: "inline-flex",
  alignItems: "center",
  gap: "8px",
  backgroundColor: "#007bff",
  color: "white",
  padding: "0px 16px",
  borderRadius: "8px",
  textDecoration: "none",
  fontWeight: "600",
  transition: "background-color 0.2s"
}}
    >
      📅 Schedule a Call
    </a>

    <p style={{marginTop: "12px", fontSize: "14px", color: "#666"}}>
      During the call, we'll discuss your use case, requirements, and pricing.
    </p>
  </div>
</Card>

### Buy or upgrade from the dashboard

You can also start a Premium purchase or upgrade directly from your self-hosted dashboard, without leaving the product. Go to **Settings → Usage and Billing** and use the guest checkout flow to subscribe; once checkout completes, the dashboard verifies and activates your subscription automatically.

After you subscribe, the **Usage and Billing** page shows your real subscription billing cycle (current period start and end, and the next invoice date) instead of a fixed calendar month, so the period and usage reset reflect mid-month and yearly terms correctly.

## Steps to Configure Your License

Once you receive your Premium license key, follow these steps to configure it:

<Steps>
  <Step title="Configure instance with license key">
    You can configure your license key with any of the following:

    <CodeGroup>
      ```json config file theme={null} theme={null}
        {
          ...
          "license_key": "{insert license key}"
          ...
        }
      ```

      ```bash cli flag theme={null} theme={null}
        convoy server --license-key "{insert license key}"
      ```

      ```bash environment variable theme={null} theme={null}
        CONVOY_LICENSE_KEY="{insert license key}"
      ```
    </CodeGroup>
  </Step>

  <Step title="Restart your Convoy instance">
    After adding the license key configuration, restart your Convoy instance to activate the Premium features.
  </Step>

  <Step title="Verify Premium features">
    Log into your Convoy dashboard to verify that Premium features are now available and accessible.
  </Step>
</Steps>

## Running the Instance

Once you've added the license key configuration, you're ready to proceed. Simply start the instance as usual, and you will now have access to all Premium features included in your license.

## License Management

### Upgrades

Upgrading your license will not remove any features you currently have. You'll gain access to additional Premium features as they become available.

### Support

Premium license holders receive priority support. If you need assistance, please reach out to our support team or book another call if you need to discuss additional requirements.