Freestyle Docs

Freestyle / Docs

Domains CLI

Verify domains, route them to VM ports, and inspect TLS certificates with the Freestyle CLI.

The command group is singular: freestyle domain. See Freestyle CLI for installation and authentication.

Verify A Domain

Create a challenge and publish the returned TXT record:

freestyle domain verify create example.com
freestyle domain verify get example.com
freestyle domain verify list --state pending

After DNS propagates, complete the challenge by its domain or verification ID:

freestyle domain verify complete example.com

Withdraw an outstanding challenge with freestyle domain verify delete <domain-or-id>. A completed verification is permanent and cannot be deleted.

List Verified Domains

freestyle domain list
freestyle --output json domain list

Route A Domain To A VM

Routing a verified domain to a VM port is a TLS ingress rule. The VM is named by ID or by your slug for it:

freestyle tls create --domain app.example.com --from public --to vm=development,port=3000
freestyle tls list --vm development
freestyle tls delete tls-…

Certificates

TLS for a domain an ingress rule serves is provisioned automatically. List certificates, or request an ongoing *.example.com certificate once _acme-challenge.example.com is NS-delegated to beta-dns.freestyle.sh:

freestyle domain cert list
freestyle domain cert wildcard example.com

The delegation is checked when you run the command; issuance happens in the background afterwards, so re-run cert list to see it go active. See Wildcard Domains for the full setup.

esc