Custom Domains
Custom domains let you serve deep links from your own branded URL, like links.yourapp.com or go.yourcompany.com.
Adding a custom domain
Section titled “Adding a custom domain”-
Go to Domains in the sidebar.
-
In the Add Custom Domain section, enter your domain (e.g.
links.yourapp.com). -
Click Add Domain. Tolinku will register the domain and begin SSL provisioning.
-
Set up a CNAME record in your DNS provider pointing to Tolinku’s edge server.
DNS configuration
Section titled “DNS configuration”Add a CNAME record in your DNS provider:
| Type | Name | Value |
|---|---|---|
| CNAME | links (or your chosen subdomain) | edge.tolinku.com |
The Name field should be whatever prefix you chose. If your domain is links.yourapp.com, the name is links. If it is go.yourcompany.com, the name is go.
Verification
Section titled “Verification”After adding your CNAME record, go back to the Domains page and click Verify next to your domain. Tolinku checks:
- The CNAME record points to
edge.tolinku.com - If CNAME verification fails, it falls back to comparing resolved IP addresses
Once verified, the DNS status badge turns green.
SSL certificates
Section titled “SSL certificates”SSL certificates are provisioned automatically after DNS verification. This typically takes a few minutes. The SSL status badge shows:
- SSL provisioning (amber): Certificate is being issued
- SSL active (green): HTTPS is working
You do not need to upload any certificates or configure SSL manually.
Removing a domain
Section titled “Removing a domain”Click Remove next to any custom domain. After removal:
- Links on that domain will stop working
- SSL certificates are revoked
- Any routes using that domain in QR codes will need new QR codes generated
Troubleshooting
Section titled “Troubleshooting”| Issue | Solution |
|---|---|
| DNS verification fails | Double-check your CNAME record. Make sure it points to edge.tolinku.com, not your own server. Use dig or nslookup to verify. |
| SSL stuck on “provisioning” | This usually resolves within 30 minutes. If it persists, verify DNS is correct and try re-verifying. |
| Domain already in use | Another Appspace has claimed this domain. Each domain can only belong to one Appspace. Contact support if you need to transfer it. |
| Cloudflare proxy issues | If you use Cloudflare, set the CNAME record to DNS only (grey cloud), not Proxied (orange cloud). Cloudflare’s proxy can interfere with SSL provisioning and edge routing. |