select navigate esc close

Getting into your own server no longer waits on email

rss.chat worknotes ·

Sign-in is a magic link, so until a new server can send mail, nobody can get in -- including the person who just installed it. That's a discouraging place to be stopped, and it's exactly where John Johnston found himself after putting rss.chat on his Mac: his mail provider wanted a verified sender identity before it would send anything, and in the meantime his own server wouldn't let him in. He got past it by reading the confirmation code out of the terminal log and typing the sign-in link himself. As of server v0.6.8, that trick is a feature. On the machine the server is running on, open http://localhost:1420/localnewuser?screenname=yourname&email=you@example.com and the browser lands on your home page, signed in as that name, ready to post -- no mail sent, nothing configured first. It works only from that machine: a request from anywhere else is refused, including one forwarded by a proxy like Caddy, nginx or PagePark sitting in front of your server, because the endpoint creates an account without checking that you own the address. So it's a way to look around your own install while you sort out email -- which you still need before anyone else can sign in. Written up in email.md. Thanks to John, whose report is what got this built. (Both public servers.)