Knowledgebase

Documentation

Written by the people who run it

Which is why some of it is blunt about what does not work. Every page says when it was last checked against the running platform rather than when somebody last edited the words.

# five minute quickstart
$ npm i -g @example/keel
$ keel login
$ keel init && git push keel main

	ready  https://your-app.example.app

Stop your mail going to spam

Three DNS records decide whether your mail is trusted. All three are set for you when mail is hosted here.

## SPF

Lists the servers allowed to send for your domain. One SPF record per domain, no more.

## DKIM

Signs each message so the receiver can tell it was not altered. The key is published as a TXT record.

## DMARC

Tells receivers what to do when SPF and DKIM do not line up. Start at `p=none`, read the reports for a fortnight, then tighten it.

## If you send through something else

A newsletter tool or a shop sending on your behalf has to be added to SPF and given its own DKIM key, or its mail will be treated as a forgery.

All guides

If the page is not there

Open a ticket and say what you were trying to do. If the answer is useful to anybody else it becomes a page, and you are told when it does.