Getting started
DragonslairCMS runs your whole website, the public site and the admin behind it, from one place. You build pages from blocks, write articles, moderate comments and restyle the site from the admin at /admin, and every change is live as soon as you publish it. There’s no build step and nothing to redeploy.
This page is for the people who run a site. If you’re a visitor with a reader account, see Reader accounts. If you’re installing DragonslairCMS yourself, start with the developer guide.
Creating the first admin account
Section titled “Creating the first admin account”A brand-new site has no accounts at all. The first time anyone opens /admin, they’re sent to a one-time setup screen instead of the login page:
- Open your site’s address with
/adminon the end. - Under Your name, Email and Password, enter your details. The password needs at least 12 characters, and one that has turned up in a known data breach is refused.
- Select Create admin account.
You’re logged in straight away and taken to the Dashboard. The setup screen disappears for good as soon as one account exists; from then on, /admin/setup just sends people to the login page.
Logging in
Section titled “Logging in”Go to /admin. If you aren’t logged in you’re sent to the login page. Enter your Email and Password, then select Log in. You stay logged in for 30 days on that browser unless you log out.
After five wrong tries from the same place, logging in is locked for 15 minutes (Too many failed attempts. Try again in 15 minutes.).
If you’ve forgotten your password
Section titled “If you’ve forgotten your password”If the site sends email, the login page has a Forgot your password? link:
- Enter your account email and select Send reset link. You always see the same confirmation, whether or not an account exists for that email.
- Open the link in the email. It works once and expires after an hour.
- Enter a New password of at least 12 characters, enter it again under Confirm new password, and select Set new password. Every session you had is logged out, so log in again with the new password.
If the site doesn’t send email, there’s no link on the login page, and /admin/forgot says password reset by email is turned off. Ask another admin to set a new password for you from Users (see Users, settings and email).
Finding your way around
Section titled “Finding your way around”The admin has a sidebar on the left (on a phone, open it with the ☰ button). It starts with the Dashboard, then groups everything else into sections you can open and close:
- Content: Pages, Articles, Categories, Series, Tags, People and Media.
- Community: Comments, Corrections and Readers. A number beside one of these is how many items are waiting for you.
- Design: Branding, Palette, Emoticons, Fonts, Navigation and Footer.
- System: Settings, Email templates and Users.
What you see depends on your role. Editors don’t see Design or System, and only admins see Readers, Email templates and Users. See Users and roles.
At the foot of the sidebar are your name and role, View site ↗ (opens the public site in a new tab), Log out, and a button that switches the admin between light and dark.
The Dashboard shows counts of your pages, articles and people, how many comments and corrections are waiting (and, for admins, how many readers), and the recent activity of everyone on the admin team.
Your first settings
Section titled “Your first settings”A new site shows “My Site” as its name and a placeholder home page. Before you share it, open Settings (under System) and set:
- Organisation name and Tagline: shown in the header, the footer and page titles.
- Site URL (canonical): your site’s public address, for example
https://example.com, with nothing after the name. It must starthttps://. It’s used in the RSS feed, the sitemap, and every link in the emails the site sends, and the site sends no email at all until it’s set. Only an admin can set it. - Send outgoing email: turn this off unless whoever installed the site has set up email. See Running without email.
- Home page: whether the front page is a page you build yourself or a feed of your latest articles. See The home page.
Then select Save settings. Everything else on the page can wait; it’s all described in Site settings.
