Use your own domain

Your Crewtavo starts with an address from Railway, like crewtavo-production-1a2b.up.railway.app. That’s the address in every link Crewtavo sends: invites, quotes, invoices and the client hub. You can give it your own, like crm.yourbusiness.com, from Settings → Web address. Crewtavo also offers this right after you set up your business.

Crewtavo goes on crm. in front of your domain, so your website and email at yourbusiness.com stay just as they are. Links you’ve already sent keep working, and the old address forwards to the new one.

The four steps

Settings → Web address shows these as a timeline. Each one ticks off when it’s done, and the step you’re on opens up with what to do.

1. Log in with Railway

Railway runs your Crewtavo. Logging in lets Crewtavo add your address there and switch over by itself, so you never have to open Railway’s settings. If you connected Railway when you set up your business, this step is already done. Otherwise, Log in with Railway opens Railway’s sign-in: press Authorize. To give Crewtavo only your Crewtavo project, choose Change, then Selected projects, first.

Crewtavo only uses that one project, also for warnings before Crewtavo stops. It keeps the access, encrypted, so other features don’t ask again, and renews it daily. Remove access in Settings → Web address or Settings → Hosting ends it. If Railway won’t connect, the screen asks for a project token instead.

2. Choose your domain

Crewtavo asks: Do you already have a domain?

Yes, use mine. The address box starts with crm.; type the rest, the domain your website or work email uses, like yourbusiness.com. Pasting your whole website or email address works too. Your website and email at yourbusiness.com stay just as they are. To use a name other than crm, choose Use a different name than crm.
No, get me one. This opens Railway’s Buy a Domain on your crewtavo service, billed to your Railway account. Railway connects the domain itself, so step 3 is done for you. Once it shows up, press Use this domain next to it.

3. Connect your domain

For a domain you already have, Crewtavo shows the two records to add where you bought it, with the exact steps for your provider (GoDaddy, Squarespace, Namecheap, Wix and others) and copy buttons. It checks them as they go in.

On Cloudflare? Crewtavo adds both records for you. Press Make a Cloudflare token: Cloudflare’s token page opens with everything filled in. Press Continue to summary, then Create Token, and copy the token. Paste it into Crewtavo and press Add them for me. Crewtavo uses the token once, adds the records as DNS only (grey cloud), and doesn’t keep it. To add them yourself instead, open Or add them yourself in Cloudflare.
Someone else looks after your domain? Choose Email the steps to send the records to whoever set up your website, or Copy the steps to text them.

4. Crewtavo switches over

Once Railway has verified the address and issued its certificate, and the address answers as your Crewtavo, Crewtavo switches over by itself: it sets APP_URL, redeploys the auth and crewtavo services, and tells your admins. This usually takes a few minutes after the records are in, sometimes up to an hour. You can close the page while it waits.

Until then, Crewtavo stays at its Railway address, so nothing changes for your team. Links you’ve already sent keep working, and the old address forwards to the new one.

Client links, calendar feeds, the texting webhook and assistant connectors keep working on both addresses.

By hand

Under Can’t log in with Railway? in step 1, Or set it all up by hand lists these steps with links, and notices when they’re done:

In Railway, open the crewtavo service, then Settings → Networking → Custom Domain, and add your domain.
Change the service’s APP_URL variable to https://your-domain.
Redeploy the crewtavo and auth services.

Running Crewtavo on your own server instead? See Self-host with Docker.