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

# Create a resource

> Provision a new resource in your organization

## Before you start

* You need a verified CodeWire account
* You must be an **owner or admin** of the organization
* Make sure you know what subdomain you want — it can't be changed later

## Steps

1. Go to your organization dashboard
2. Click **Add Resource**
3. Select a **resource type**:
   * **Coder** — a fully managed Coder deployment
   * **Codewire Relay** — a WireGuard relay for AI agent connectivity
4. Choose a **plan** (Coder resources include a **14-day free trial**)
5. Fill in the form:
   * **Resource name** — a display name (e.g., "Engineering", "Design Team")
   * **Subdomain** — your resource URL prefix
6. Click **Create Resource**

## Subdomain format

Your subdomain becomes the domain `subdomain.codewire.sh`. The rules are:

* Lowercase letters (`a-z`), numbers (`0-9`), and hyphens (`-`)
* Must start and end with a letter or number
* No spaces or special characters
* Must be unique across all CodeWire resources

**Examples:**

* `my-team` → `my-team.codewire.sh`
* `acme-engineering` → `acme-engineering.codewire.sh`

## Provisioning

After creating the resource, provisioning begins automatically. For a Coder resource, this sets up a dedicated environment with its own database, TLS certificate, and DNS record.

If this is your first resource and you don't have a payment method on file, you'll be redirected to **Stripe Checkout** to set up billing before provisioning begins.

The process typically takes **2-5 minutes**. The resource detail page shows a **provision timeline** with real-time progress.

## What happens if provisioning fails?

Don't worry — you can [retry provisioning](/resources/retry-failed-provision) from the resource detail page. The Events tab will show which step failed and why.
