Skip to content

Commit bf01b14

Browse files
authored
Merge pull request #237 from CerebriumAI/wesley/cer-4092-documentation-add-mint-link
Wesley/cer 4092 documentation add mint link
2 parents c0f2952 + f737d85 commit bf01b14

File tree

2 files changed

+30
-31
lines changed

2 files changed

+30
-31
lines changed

cerebrium/endpoints/custom-domains.mdx

Lines changed: 28 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -3,40 +3,40 @@ title: "Custom Domains"
33
description: "Connect your own domain to your Cerebrium project"
44
---
55

6-
Custom domains allow you to serve your Cerebrium apps through your own domain instead of the default `*.cerebrium.ai` URLs.
7-
Once configured, your API calls will use your custom domain while keeping the same path structure: `api.yourdomain.com/v4/p-1234/my-app/run`.
6+
Custom domains allow serving Cerebrium apps through custom domains instead of the default `*.cerebrium.ai` URLs.
7+
Once configured, API calls will use the custom domain while keeping the same path structure: `api.example.com/v4/p-1234/my-app/run`.
88

99
## Key Features
1010

11-
- Support for apex domains (`yourdomain.com`) and subdomains (`api.yourdomain.com`)
11+
- Support for apex domains (`example.com`) and subdomains (`api.example.com`)
1212
- Automatic SSL certificate provisioning and renewal
13-
- Project-level domains - one domain serves all apps in your project
13+
- Project-level domains - one domain serves all apps in a project
1414
- Multiple domains can point to the same project
15-
- Professional branding with your own domain instead of `*.cerebrium.ai` URLs
15+
- Professional branding with custom domains instead of `*.cerebrium.ai` URLs
1616

1717
## How Custom Domains Work
1818

1919
- **Domains are region-specific** meaning each will always resolve to the selected region
20-
- **Domains are app-agnostic** so you can use connect to any number of deployed apps within your project via custom domain
21-
- **Multiple domains** can be configured on the same project (useful if you have apps within the project deployed in different regions)
20+
- **Domains are app-agnostic** enabling connection to any number of deployed apps within a project via custom domain
21+
- **Multiple domains** can be configured on the same project (useful for apps within the project deployed in different regions)
2222

2323
## Getting Started
2424

25-
### Step 1: Create Your Custom Domain
25+
### Step 1: Create a Custom Domain
2626

27-
1. Navigate to your project settings in the Cerebrium dashboard
27+
1. Navigate to project settings in the Cerebrium dashboard
2828
2. Click on the "Custom Domains" tab
2929
3. Click "Add Custom Domain"
30-
4. Enter your domain name and select your target region (choose the region closest to your users for optimal latency)
30+
4. Enter the domain name and select the target region (choose the region closest to users for optimal latency)
3131
5. Click "Create Domain"
3232

3333
### Step 2: Configure DNS Records
3434

35-
After creating the domain, you'll receive DNS configuration instructions. Copy these and create a CNAME record in your DNS provider using the DNS record Cerebrium generates for you.
35+
After creating the domain, DNS configuration instructions will be displayed. Create a CNAME record at the DNS provider using the DNS record Cerebrium generates.
3636

3737
<Note>
38-
You can also find your DNS record details later by clicking "DNS Record" in
39-
the Custom Domains list.
38+
DNS record details can also be found later by clicking "DNS Record" in the
39+
Custom Domains list.
4040
</Note>
4141

4242
<Tabs>
@@ -55,7 +55,7 @@ After creating the domain, you'll receive DNS configuration instructions. Copy t
5555

5656
<Tab title="Apex Domains">
5757
**Benefits:**
58-
- Routes all traffic from your domain root
58+
- Routes all traffic from the domain root
5959
- Best for dedicated API domains
6060

6161
**Note:** ALIAS records are preferred over CNAME since only one CNAME is allowed per domain
@@ -70,26 +70,24 @@ After creating the domain, you'll receive DNS configuration instructions. Copy t
7070

7171
</Tabs>
7272

73-
<Note>
74-
You will be prompted to select a `{region}` when creating your custom domain.
75-
</Note>
73+
<Note>A `{region}` must be selected when creating a custom domain.</Note>
7674

7775
### Step 3: Domain Validation
7876

7977
1. After configuring DNS, return to the Cerebrium dashboard
80-
2. Cerebrium will automatically attempt to validate your DNS records every 30 minutes for up to 2 days
81-
3. To trigger an immediate validation attempt, click "Validate Domain" next to your domain, even after the 2 days have elapsed
82-
4. If validation fails, the dialog will show you the last known error.
78+
2. Cerebrium will automatically attempt to validate DNS records every 30 minutes for up to 2 days
79+
3. To trigger an immediate validation attempt, click "Validation Status" -> "Validate Domain" (you can do this manually even after the 2 days have elapsed)
80+
4. If validation fails, the dialog will show the last known error.
8381
5. Once validated, SSL certificates will be automatically provisioned
8482

85-
### Step 4: Start Using Your Custom Domain
83+
### Step 4: Start Using the Custom Domain
8684

87-
Once validation is complete, you can immediately start using your custom domain with all apps in your project:
85+
Once validation is complete, the custom domain can be used immediately with all apps in the project:
8886

8987
<Tabs>
9088
<Tab title="POST Request">
9189
```bash
92-
curl -X POST https://api.yourdomain.com/v4/p-1234/my-app/run \
90+
curl -X POST https://api.example.com/v4/p-1234/my-app/run \
9391
-H "Authorization: Bearer {YOUR_API_KEY}" \
9492
-H "Content-Type: application/json" \
9593
-d "{'inputs': {'prompt': 'Hello world'}}"
@@ -98,18 +96,18 @@ Once validation is complete, you can immediately start using your custom domain
9896

9997
<Tab title="GET Request">
10098
```bash
101-
curl https://api.yourdomain.com/v4/p-1234/my-app/run \
99+
curl https://api.example.com/v4/p-1234/my-app/run \
102100
-H "Authorization: Bearer {YOUR_API_KEY}"
103101
```
104102
</Tab>
105103
</Tabs>
106104

107-
## Managing Your Domains
105+
## Managing Domains
108106

109107
### Domain Validation Statuses
110108

111-
Cerebrium will attempt to validate your domain once every 30 minutes up to a maximum of 2 days. If your domain is not
112-
being validated, you can click on "Validation Status" to see the last validation attempt, along with any error that
109+
Cerebrium will attempt to validate domains once every 30 minutes up to a maximum of 2 days. If a domain is not
110+
being validated, click on "Validation Status" to see the last validation attempt, along with any error that
113111
occurred.
114112

115113
- **Pending**: Domain is waiting for DNS validation
@@ -118,7 +116,7 @@ occurred.
118116

119117
### Validation Errors
120118

121-
If your domain shows "Failed" status it means that the DNS record has been misconfigured, common issues include:
119+
If a domain shows "Failed" status, the DNS record has been misconfigured. Common issues include:
122120

123121
- **Wrong target**: CNAME points to incorrect proxy URL
124122
- **Multiple conflicting records**: Remove any existing ALIAS records for the same hostname
@@ -132,7 +130,7 @@ If your domain shows "Failed" status it means that the DNS record has been misco
132130

133131
### Common DNS Mistakes
134132

135-
- **Wrong proxy URL**: Ensure you're using the exact URL provided in the dashboard
133+
- **Wrong proxy URL**: Ensure the exact URL provided in the dashboard is being used
136134
- **TTL too high**: Consider lowering TTL before making DNS changes
137135
- **Multiple records**: Remove conflicting A or CNAME records for the same name
138136

@@ -141,4 +139,4 @@ If your domain shows "Failed" status it means that the DNS record has been misco
141139
- Custom domains automatically receive SSL certificates
142140
- All traffic is encrypted end-to-end
143141
- Certificates auto-renew before expiration
144-
- Domain validation ensures you control the domain
142+
- Domain validation ensures control of the domain

mint.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -122,7 +122,8 @@
122122
"cerebrium/endpoints/streaming",
123123
"cerebrium/endpoints/websockets",
124124
"cerebrium/endpoints/webhook",
125-
"cerebrium/endpoints/async"
125+
"cerebrium/endpoints/async",
126+
"cerebrium/endpoints/custom-domains"
126127
]
127128
},
128129
{

0 commit comments

Comments
 (0)