Custom domain
An app can use a domain you own instead of a hostname under your subdomain: either a name within the domain, such as photos.example.com, or the domain itself, such as example.com.
1. Create the DNS record
The record depends on the hostname:
| Hostname | Record |
|---|---|
A name within your domain, such as photos.example.com | CNAME to freepod.eu |
The domain itself, such as example.com | ALIAS, ANAME or flattened CNAME to freepod.eu, if your provider offers one |
A name within your domain
Create a CNAME record:
| Field | Value |
|---|---|
| Type | CNAME |
| Name | The part in front of your domain, such as photos for photos.example.com |
| Target | freepod.eu |
| TTL | Any; the provider's default is fine |
- Cloudflare
- GoDaddy
- Namecheap
- OVHcloud
- TransIP
- In the Cloudflare dashboard, select the domain and open DNS → Records.
- Select Add record.
- Type:
CNAME. Name:photos. Target:freepod.eu. - Set Proxy status to DNS only (grey cloud). Freepod cannot use a proxied record.
- Select Save.
- In your GoDaddy account, select the domain to open its Domain Settings, then select DNS.
- Select Add New Record.
- Type:
CNAME. Name:photos. Value:freepod.eu. - Select Save.
- In your Namecheap account, open Domain List and select Manage next to the domain.
- Open the Advanced DNS tab and select Add New Record under Host Records.
- Type:
CNAME Record. Host:photos. Value:freepod.eu. - Select the check mark, then Save All Changes.
- In the OVHcloud Control Panel, go to Web Cloud → Domain names, select the domain and open the DNS zone tab.
- Select Add an entry and choose CNAME.
- Subdomain:
photos. Target:freepod.eu.— including the final period; without it, OVHcloud appends your own domain. - Select Next, then Confirm.
- In the TransIP control panel, select Domain and the domain.
- Under Advanced Domain Management, open DNS. If the records are hidden, turn off the TransIP settings switch.
- Add a record. Name:
photos. Type:CNAME. Value:freepod.eu. - Save the changes.
Other providers have the same fields under similar names. If the provider appends your domain to the target, end the target with a period: freepod.eu.
The domain itself
A domain itself cannot have a CNAME record. Some DNS providers offer an equivalent that follows freepod.eu automatically, called ALIAS, ANAME or CNAME flattening. If your provider does not, the domain itself cannot be used with Freepod; use a name within it instead, such as www.example.com.
- Cloudflare
- Namecheap
- TransIP
Cloudflare flattens a CNAME record on the domain itself automatically.
- In the Cloudflare dashboard, select the domain and open DNS → Records.
- Select Add record.
- Type:
CNAME. Name:@. Target:freepod.eu. - Set Proxy status to DNS only (grey cloud).
- Select Save.
- In your Namecheap account, open Domain List and select Manage next to the domain.
- Open the Advanced DNS tab. Remove any other records for Host
@of typeA,AAAA,CNAMEor URL Redirect. - Select Add New Record under Host Records. Type:
ALIAS Record. Host:@. Value:freepod.eu. - Select the check mark, then Save All Changes.
- In the TransIP control panel, select Domain and the domain.
- Under Advanced Domain Management, open DNS. If the records are hidden, turn off the TransIP settings switch.
- Add a record. Name:
@. Type:ALIAS. Value:freepod.eu. - Save the changes.
Remove any A and AAAA records for the domain itself that do not come from the ALIAS or flattened record.
2. Use the hostname
- When launching the app, or with Edit on an existing app, select Custom domain under Hostname and enter the full hostname, such as
photos.example.comorexample.com. - Select Launch or Update.
Freepod checks the record with your domain's own DNS servers, so a new record is seen immediately, and refuses the hostname if the record is missing or points elsewhere. Once accepted, Freepod obtains an HTTPS certificate from Let's Encrypt and renews it automatically.
Keep the record in place: updates to the app and certificate renewal depend on it.
Requirements
- If your DNS provider can proxy traffic, such as Cloudflare's proxied records, turn proxying off for the record. A proxied record points to the provider's addresses instead of Freepod's.
- If your domain has
CAArecords, they must allowletsencrypt.org.