A published App Factory app or site can open on your own address, for example app.yoursite.com or yoursite.com. It takes one DNS record. The security certificate (https) is issued by Apiway by itself: there is nothing to buy and nothing to set up. You can do all of it in a chat with your agent, without opening Apiway.
In short
- One record: a CNAME on your address that points to Apiway. Your agent gives you its exact name and value.
- A subdomain (app.yoursite.com) keeps the site you already have on yoursite.com as it is.
- yoursite.com without www: the record goes on www.yoursite.com, and you turn on forwarding from yoursite.com to www.yoursite.com at your DNS provider.
- New records show up in minutes, sometimes in a couple of hours. That is normal.
- Once the address opens, the Apiway address of the app forwards to it.
- The address opens the published version of the app. Publish it first, or ask your agent to.
In a chat with your agent
- Write: «Put my app on app.yoursite.com» (or yoursite.com).
- The agent connects the address and answers with the record. Where your DNS provider supports it, the agent gives a one-click link: you sign in at the provider and confirm, and the record is added for you.
- Otherwise, add the record at your DNS provider. Not sure what to do there? Send the agent a screenshot of your DNS page or paste your records: it says exactly what to add, change or delete.
- The agent checks the record and the certificate and gives you the link when the address opens.
Never give anyone the password of your domain account. The record is the only step that is yours.
Rules for the agent
- Call the address «Domain URL». Say it can be a domain or a subdomain, with the example app.yoursite.com or yoursite.com. Write in the person’s language, one question per message.
- Open the address before you connect it. If a site already works there, say that connecting replaces it and offer a subdomain. Go on only after a clear yes.
- Call
set_code_app_domainwithconfirm: true. Use the record from its answer exactly. Give the one-click link first when the answer has one; otherwise walk the person through their provider’s own help page from the answer, or from the list below. - If the person sends a screenshot or a list of DNS records, read it and name exactly which record to add, change or delete. Never ask for the provider’s password.
- Call
get_code_app_domainwithcheck: true. pending_dns: the record is not seen yet, check again a little later. pending_cert: the certificate is being issued by itself. active: give the link. failed: say the reason in plain words and what to fix. - Not published yet: say that the Domain URL opens the published app, and publish only on the person’s clear yes.
- The person does not need to open the Domain panel in Apiway. Everything is done in the chat.
remove_code_app_domaindisconnects the address.
By DNS provider
Cloudflare
- Where: Your site → DNS → Records → Add record
- Name field: Name
- Official instructions for a CNAME record: https://developers.cloudflare.com/dns/manage-dns-records/how-to/create-dns-records/
GoDaddy
- Where: Domain Portfolio → select the domain → DNS → Add New Record → choose the Type
- Name field: Name
- Official instructions for a CNAME record: https://www.godaddy.com/help/add-a-cname-record-19236
Namecheap
- Where: Domain List → Manage → Advanced DNS → Add New Record
- Name field: Host
- Official instructions for a CNAME record: https://www.namecheap.com/support/knowledgebase/article.aspx/9646/2237/
Squarespace
- Where: Domains dashboard → click the domain → DNS → add a custom record
- Name field: Host
- Official instructions for a CNAME record: https://support.squarespace.com/hc/en-us/articles/360002101888
Wix
- Where: Domains → ⋯ Domain Actions → Manage DNS Records → + Add Record in the TXT or CNAME section
- Name field: Host Name
- Official instructions for a CNAME record: https://support.wix.com/en/article/adding-or-updating-cname-records-in-your-wix-account
Hostinger
- Where: Dashboard → Domains → DNS → select the domain
- Name field: Name
- Official instructions for a CNAME record: https://www.hostinger.com/support/1583249-how-to-manage-dns-records-at-hostinger
Reg.ru
- Where: Личный кабинет → Домены → ваш домен → «DNS-серверы и управление зоной» → «Изменить» → «Добавить запись»
- Name field: Subdomain (Поддомен / Имя)
- Official instructions for a CNAME record: https://help.reg.ru/support/dns-servery-i-nastroyka-zony/nastroyka-resursnykh-zapisey-dns/nastroyka-resursnykh-zapisey-v-lichnom-kabinete
Beget
- Where: Control panel → DNS → Edit zone → Add record
- Name field: Name
- Official instructions for a CNAME record: https://beget.com/en/kb/manual/dns
IONOS
- Where: Domains & SSL → the domain's ⚙ Actions → DNS → Add Record
- Name field: Host name
- Official instructions for a CNAME record: https://www.ionos.com/help/domains/configuring-cname-records-for-subdomains/configuring-a-cname-record-for-a-subdomain/
Amazon Route 53
- Where: Route 53 console → Hosted zones → your domain → Create record
- Name field: Record name
- Official instructions for a CNAME record: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-creating.html
Porkbun
- Where: Domain Management → the domain → DNS → Add Record
- Name field: Host
- Official instructions for a CNAME record: https://kb.porkbun.com/article/231-how-to-add-dns-records-on-porkbun
Vercel
- Where: Dashboard → Domains → the domain → Add DNS Record
- Name field: Name
- Official instructions for a CNAME record: https://vercel.com/docs/domains/managing-dns-records