Sanity og eget domene: slik setter du opp DNS

Skal du bruke et eget domenenavn med Sanity, er DNS-oppsettet selve nøkkelen. Du oppretter en CNAME-post som peker domenet ditt på Sanity eller hostingplattformen sin adresse, og i løpet av kort tid står siden på ditt eget domene. Her får du vite hvilke DNS-poster Sanity krever, hva som går galt oftest, og hvordan du bekrefter at oppsettet er riktig.

Et sanity domene er et vanlig domenenavn du kobler til Sanity gjennom DNS. I praksis betyr det som regel én CNAME-post, altså en peker fra domenet ditt til et annet domenenavn. Slik får du en profesjonell adresse foran innholdet som ligger i Content Lake.

Kortversjonen: Legg domenet til i Sanity-prosjektet og hos hostingplattformen din, opprett CNAME-posten med nøyaktig den verdien du får oppgitt, sett TTL-en lav, og verifiser med nslookup eller dnschecker.org når spredningen har skjedd.

Slik fungerer eget domene med Sanity

Sanity leverer innholdet ditt fra en global tjeneste som heter Content Lake. Som standard ligger nettsiden og Studio-delen din på Sanity sine egne adresser, for eksempel api.sanity.io og apicdn.sanity.io. Det er fint under utvikling, men når lanseringen nærmer seg, vil du ha et gjenkjennelig domenenavn.

Du kobler på et eget domene ved å kombinere to ting: en DNS-post hos registraren din og en innstilling i Sanity-prosjektet. Innholdet blir værende i Content Lake. Domenet blir bare en ny, pen adresse som peker dit.

Har du ikke sikkret deg domenet enda, kan du registrere et norsk domenenavn hos Feno på minutter.

Hvilke DNS-poster krever Sanity?

Svaret er heldigvis kort: I de fleste tilfeller en eneste CNAME-post. Sanity har ingen fast IP-adresse du kan peke til. Derfor brukes et alias i stedet, slik at Sanity selv kan bytte infrastruktur uten at du må røre DNS-en igjen.

Hvilke poster du trenger, avhenger av hva domenet skal brukes til. Skal det betjene frontenden din, er det gjerne hostingplattformen, for eksempel Vercel eller Netlify, som forteller deg nøyaktig hvilken verdi du skal bruke. Skal domenet også brukes mot API-et i Sanity, legger du det til under API-innstillingene i prosjektet og får CNAME-verdien derfra.

CNAME-posten: hjertet i oppsettet

En CNAME-post, eller Canonical Name, peker fra ett domenenavn til et annet. For eksempel kan studio.dittfirma.no peke på Sanity eller på hostingplattformen sin adresse. Når noen besøker domenet, følger DNS-en lenken til den endelige adressen.

Det viktigste er å kopiere verdien nøyaktig slik den står. En ekstra bokstav eller et manglende punkt kan gjøre at ingenting virker. Les verdien rett fra kontrollpanelet der du setter opp domenet, ikke fra en gammel e-post eller et skjermbilde.

A-post for rotdomenet

Vil du at selve rotdomenet, for eksempel dittfirma.no uten www, skal peke direkte, kan noen plattformer be om en A-post. Den peker på en IP-adresse i stedet for et annet domenenavn. Vercel og Netlify har egne A-verdier som står i dashbordet.

Mange velger i stedet www-versjonen, som alltid kan bruke CNAME. Så setter de opp en videresending fra rotdomenet til www-adressen. Da slipper du A-poster, og du får én klar adresse å forholde deg til.

MX- og TXT-poster når domenet også brukes til e-post

Bruker du domenet til e-post i tillegg, skal MX-postene, som styrer hvor e-posten leveres, og TXT-postene, som brukes til verifisering og SPF, ligge i fred. CNAME-posten til Sanity legges ved siden av, ikke i stedet for dem.

Et vanlig feilgrep er å slette hele det eksisterende DNS-oppsettet. Ta vare på det som allerede fungerer, og legg til de nye postene i tillegg. MX-postene kan aldri peke på en CNAME-adresse, så sjekk at du ikke rører dem.

Slik setter du opp ditt eget sanity domene

Bestem hva domenet skal brukes til. Skal det være Studio-adresse, API-adresse eller adressen til frontenden? Svaret avgjør hvor du legger inn domenet.
Legg domenet til i Sanity. Åpne prosjektet og legg domenet til under API-innstillingene. Legg også domenet til under CORS Origins med https og Allow credentials, ellers kan Studio-delen nekte å åpnes.
Åpne DNS-innstillingene hos registraren din. Hos Feno administrerer du DNS under domenet i kontrollpanelet.
Opprett CNAME-posten. Navnet er som regel www eller et subdomenenavn, og verdien er det Sanity eller hostingplattformen viser deg. Kopier den nøyaktig.
Sett TTL-en lav underveis. TTL (Time to Live) forteller hvor lenge andre servere skal huske posten. 300 sekunder er et trygt valg mens du tester.
Vent på spredningen. De fleste CNAME-poster sprer seg i løpet av få minutter. Med eldre, høye TTL-verdier kan det ta noen timer.

De vanligste feilene i DNS-oppsettet

CNAME på rotdomenet. De fleste DNS-tjenester nekter CNAME på selve rotdomenet fordi den kommer i konflikt med andre poster. Bruk A-post på roten eller en videresending fra roten til www.
Feil verdi kopiert. Et mellomrom, en ekstra bokstav eller en gammel versjon av verdien er den vanligste årsaken til at ingenting skjer. Kopier rett fra kilden.
CORS Origins mangler. Får du feilmelding om at origin ikke er tillatt når du åpner Studio-delen, er domenet ikke lagt til under CORS Origins. Legg til adressen med https.
www og uten www blandes. Velg én versjon og bruk den konsekvent. Uten en videresending risikerer du duplikat innhold og forvirring.
For høy TTL. Med TTL på 86 400 sekunder kan en feil leve videre i et helt døgn etter at du retter den. Hold TTL-en lav mens du tester.
For lite tålmodighet. Spredning tar tid, og det kan se ut som feil selv om alt er riktig. Bruk et verifiseringsverktøy i stedet for å gjette.

Slik bekrefter du at domenet fungerer

Du trenger ikke gjette om oppsettet virker. DNS-en er offentlig, og du kan sjekke den med noen få kommandoer.

Nslookup eller dig. Kjør nslookup -type=CNAME www.dittfirma.no i terminalen på Windows, eller dig CNAME www.dittfirma.no på macOS og Linux. Svarer den med riktig verdi, er posten på plass.
dnschecker.org. Siden spør dusinvis av DNS-servere rundt om i verden og viser hvor langt spredningen har kommet.
Nettleseren. Åpne domenet og sjekk hengelåsen. Fungerer siden over https uten advarsel, har SSL-sertifikatet blitt utstedt. Det skjer normalt noen minutter etter at DNS-en er på plass.
Sanity-prosjektet. Står domenet som verified i innstillingene, har Sanity funnet DNS-posten din.

Ofte stilte spørsmål om sanity domene og DNS

Kan jeg bruke domenet til både nettside og e-post?

Ja, og det er helt vanlig. DNS-en består av flere poster som jobber samtidig. CNAME-posten til Sanity eller hostingplattformen tar seg av nettsiden, mens MX-postene fortsetter å styre e-posten. Det eneste du må unngå, er CNAME på selve rotdomenet, for da mister du plassen til de andre postene.

Hvor lang tid tar DNS-oppsettet før domenet virker?

Selve arbeidet tar fem til ti minutter. Så må spredningen skje. Med lav TTL ser du resultat i løpet av få minutter. Har den gamle posten høy TTL, kan det ta et døgn. SSL-sertifikatet følger etter, gjerne innen et par timer.

Hva gjør jeg hvis CNAME-posten står riktig, men domenet ikke virker?

Sjekk i denne rekkefølgen: om domenet er lagt til under CORS Origins med https, om du bruker www konsekvent, og om en DNS-server nær deg har gammel informasjon. Tøm nettleserens DNS-buffer eller sjekk fra et annet nettverk. Løser ikke det problemet, kan support hos registraren din se på DNS-en sammen med deg.

Klar for ditt eget domenenavn?

Med et eget sanity domene får du en adresse du eier og kontrollerer, og med riktig DNS-oppsett er jobben gjort i løpet av en kaffepause. Innholdet blir værende i Content Lake, mens du bestemmer hvordan det ser ut i nettleseren.

Mangler du domenet enda? Registrer .no-domenet ditt hos Feno i dag og sett opp Sanity med trygg, norsk DNS. Feno er 100 prosent norsk eid, har transparent prising og gir deg full kontroll over DNS-en i et moderne kontrollpanel. .no-domener koster fra 99 kroner i året.