LogoFreestyle

Verify your domain

Domains allow you to configure custom domain names for your Edge Deployments. Custom domains for VMs is coming soon.

Verify your domain

Before you can use a custom domain on freestyle, you need to verify that you own the domain. You can do this programmatically using the freestyle SDK or through in the dashboard under Custom Domains.

import { freestyle } from "freestyle-sandboxes";

const { record, instructions } = await freestyle.domains.verifications.create({
  domain: "example.com",
});

console.log(instructions);
console.log(record);

Navigate to your domain's DNS settings and create a TXT record with the following details:

Name: _freestyle-verification.example.com

Value: <verification-code>

After adding the record, return here to complete the verification process. Note that DNS changes may take some time to propagate. If verification fails after waiting a few minutes, try setting the Name to just "_freestyle-verification". Some DNS providers automatically append the domain name to the record name.

{
    type: "TXT",
    name: `_freestyle-verification.example.com`,
    value: "<verification-code>",
}

Complete verification

After adding the DNS record, you can complete the verification process by domain name or verification ID. If you verify by domain, freestyle will attempt to verify all pending verifications for that domain, and is the most common approach. If you are verifying a domain on behalf of multiple different users, you may want to verify by verification ID instead.

import { freestyle } from "freestyle-sandboxes";

await freestyle.domains.verifications.complete({
  domain: "example.com",
});
import { freestyle } from "freestyle-sandboxes";

const { verificationId } = await freestyle.domains.verifications.create({
  domain: "example.com",
});

// After adding the DNS record...

await freestyle.domains.verifications.complete({
  verificationId: verificationId,
});

On this page

Freestyle AI

Documentation assistant

Experimental: AI responses may not always be accurate—please verify important details with the official documentation.

How can I help?

Ask me about Freestyle while you browse the docs.