You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: cerebrium/endpoints/custom-domains.mdx
+28-30Lines changed: 28 additions & 30 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,40 +3,40 @@ title: "Custom Domains"
3
3
description: "Connect your own domain to your Cerebrium project"
4
4
---
5
5
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`.
8
8
9
9
## Key Features
10
10
11
-
- Support for apex domains (`yourdomain.com`) and subdomains (`api.yourdomain.com`)
11
+
- Support for apex domains (`example.com`) and subdomains (`api.example.com`)
12
12
- 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
14
14
- 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
16
16
17
17
## How Custom Domains Work
18
18
19
19
-**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)
22
22
23
23
## Getting Started
24
24
25
-
### Step 1: Create Your Custom Domain
25
+
### Step 1: Create a Custom Domain
26
26
27
-
1. Navigate to your project settings in the Cerebrium dashboard
27
+
1. Navigate to project settings in the Cerebrium dashboard
28
28
2. Click on the "Custom Domains" tab
29
29
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)
31
31
5. Click "Create Domain"
32
32
33
33
### Step 2: Configure DNS Records
34
34
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.
36
36
37
37
<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.
40
40
</Note>
41
41
42
42
<Tabs>
@@ -55,7 +55,7 @@ After creating the domain, you'll receive DNS configuration instructions. Copy t
55
55
56
56
<Tabtitle="Apex Domains">
57
57
**Benefits:**
58
-
- Routes all traffic from your domain root
58
+
- Routes all traffic from the domain root
59
59
- Best for dedicated API domains
60
60
61
61
**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
70
70
71
71
</Tabs>
72
72
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>
76
74
77
75
### Step 3: Domain Validation
78
76
79
77
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.
83
81
5. Once validated, SSL certificates will be automatically provisioned
84
82
85
-
### Step 4: Start Using Your Custom Domain
83
+
### Step 4: Start Using the Custom Domain
86
84
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:
88
86
89
87
<Tabs>
90
88
<Tabtitle="POST Request">
91
89
```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 \
93
91
-H "Authorization: Bearer {YOUR_API_KEY}" \
94
92
-H "Content-Type: application/json" \
95
93
-d "{'inputs': {'prompt': 'Hello world'}}"
@@ -98,18 +96,18 @@ Once validation is complete, you can immediately start using your custom domain
0 commit comments