Administration
This page is for the person who runs a Mosaic site. Admins get an Admin item in the account menu, which opens six tabs: Dashboard, Users, Community, Themes, Settings and Audit.
Setting up a new site
Section titled “Setting up a new site”Until a new Mosaic site has been set up, every address goes to Set up Mosaic. Enter a username, email and password (at least 12 characters) and select Create the admin account. That first account is the admin, and you’re signed in straight away. Once setup is done, the setup page is gone for good, even if every account is later deleted.
Setting up also records the address you used as the site’s Canonical URL; you can change it in Settings. Open the site at the address it will really live at before you set it up: setup refuses an address with http:// (except on your own machine, such as localhost), and says why.
A new site starts with registration Closed, email off, and search engines allowed to index public pages. Go through Settings before inviting anyone.
Dashboard
Section titled “Dashboard”The dashboard counts what exists on the whole site: people (and how many are waiting for approval, suspended and paused), tiles, pictures, storage used against Cloudflare R2’s free allowance, and things reported. A second row breaks tiles down by state (published, drafts, waiting for their date, hidden by a moderator), with likes, comments, and sign-ups and tiles laid in the last 30 days. If any comments are waiting for their tile’s owner to approve, it says so; approving those is the owner’s job, not yours.
Below the figures are these cards:
- Email: whether mail is really getting out, read from what has actually been sent rather than from the settings. It says Not sending, Working, Something is wrong (messages are being tried and refused), or, if mail is on but nothing has gone yet, that it’s switched on but untried. It counts messages sent or tried and failed recently, broken down by kind, and names the last problem with its reason.
- Scheduler: whether the job that runs every fifteen minutes (publishing scheduled tiles, sending digests and tidying up) is working, late, has never run, or finished with errors, which it names. Run housekeeping now runs the tidying-up jobs once; it doesn’t publish a scheduled tile early.
- Storage: each account’s storage use is kept as a running total. If a figure looks wrong, select Recount from what is stored.
- This deployment: the version that’s running, when it was deployed and the newest database migration, for checking that what you deployed is what’s live.
- Paused a long time: everyone who has been paused longer than the threshold in Settings (180 days unless changed), with how long and how much storage they’re holding. You also get a notification when an account first crosses it. Nothing here deletes an account on its own.
The Users tab lists every account, with its email, tile count, storage, when it was last seen and any notes (private mosaic, paused, suspension reason). A badge shows each person’s role, or waiting, suspended or paused. If email is on, someone who hasn’t confirmed their address also has an address not confirmed badge. People waiting for approval are listed first.
- Search by name, handle or email.
- Filter by Role (Everyone, Users, Admins) and Status (Any, Active, Waiting, Suspended, Paused).
- Select Manage to open one person’s page. Long lists are split into pages of 50.
Approving new accounts
Section titled “Approving new accounts”On a site set to Ask me first, people who sign up wait in Users until you approve them. On an Open site that isn’t sending email, everyone who signs up waits too, because there’s no way to confirm their address.
If email is on, each new account first has to confirm its address. Until it does, its page says they’re not waiting on you, and the only choice is Decline and delete…. Once they confirm, you can approve them, and admins are emailed that someone is waiting (each admin can turn that email off under Running the site in their own Settings → Notifications). A sign-up that isn’t confirmed within seven days is removed by itself.
On their page, select Approve, or Decline… to turn them down. Declining deletes the account and frees the email address; the username isn’t held. If email is on they’re told; if it’s off, the message reminds you to tell them yourself.
Managing one person
Section titled “Managing one person”A person’s page shows their tiles, pictures and storage, when they joined and were last seen, how many devices they’re signed in on, and whether their address is confirmed. Look at their mosaic opens it; you see a private mosaic locked, like anyone else, because being an admin doesn’t open people’s private tiles.
- Storage limit: type a number of megabytes in Storage for this person, in MB and select Save the limit to give them more or less than their role. Clear the box to put them back on their role’s limit.
- Role: Make them an admin… or Make them a user….
- Suspend…: type a Reason and select Suspend them. They’re signed out at once, can’t sign in, and their mosaic shows This mosaic is suspended with none of its tiles reachable. They’re told the reason in the app and, if email is on, by email. Lift the suspension reverses it.
- Delete this account…: type their username where it asks and select Delete this account for good. Their tiles, pictures, comments and followers go for good. Leave the box that keeps their username reserved ticked so nobody else can take it, or untick it to free the name straight away.
- Password: select Issue a reset link to make a one-time link the person can use to choose a new password themselves. You never set or see their password. The link isn’t emailed: copy it from the page and pass it on however you usually reach them. It works once and stops working after an hour, and issuing another (Issue another link) cancels any earlier one. This is how you help someone who’s locked out when email is off.
Changing someone’s role, suspending, declining and deleting each open a confirmation first, saying what will happen. Cancel comes first, so pressing Enter does nothing.
What has happened to this account lists the latest things done to them and by them, with All of it opening their full history in the Audit tab.
You can’t act on your own account from here, and Mosaic won’t delete, demote or suspend the site’s only remaining admin, from here or from their own settings, so a site can’t be left without an admin by accident.
A Paused card shows when someone has paused their own account. You can suspend a paused account, but you can’t resume it: that’s theirs to do.
Held usernames
Section titled “Held usernames”When an account is deleted with its username kept reserved, the name is held so nobody else can take it straight away (30 days unless changed in Settings). Held usernames on the Users tab lists them with the date each frees up. Release now… frees one early, after a confirmation explaining that anybody could then register it and pick up old links to that address.
A username someone gives up by renaming isn’t held for a while but kept for good, because the old address redirects to their new one. Those names don’t appear in this list and can’t be released.
Community
Section titled “Community”Community is where reports come in. Reports are grouped by what they’re about: one card per reported tile, comment or person, showing the thing itself (with a thumbnail for a tile), how many reports it has, and every reporter’s name and reason. Select Look at it to open it.
While a tile has an open report, you can open it even if it’s private or for followers only, so a tile can’t be put beyond review by changing its audience. That access ends when the report is dealt with.
To decide, type a reason (required, including for dismissing), then choose:
- Dismiss: take no action.
- Hide: for a tile or comment. A hidden tile disappears for everyone but its owner, who sees that a moderator hid it and why. A hidden comment disappears for everyone, and stays hidden even if the tile’s owner changes its comment mode.
- Delete: for a tile or comment. A deleted comment with replies leaves Deleted by an admin and your reason.
- Suspend: suspends the person the report is about, as on their Users page. They’re told the reason in the app and, if email is on, by email.
One decision closes every report in the group, and everybody who reported it gets a notification with your reason. If what was reported is already gone, deleted by its author or with their account, deciding just closes the reports and nobody is told anything.
You can also delete any comment from its ⋯ menu on the tile itself, without a report.
Themes
Section titled “Themes”Mosaic ships with three themes: Celadon (green, the default), Terracotta (red-orange) and Slate (blue). Each card shows the theme in light and dark, how many people use it, and its tightest contrast ratio.
- Edit: change the theme’s Name, Description and colours, for light and dark separately, then select Save. The tightest text-on-ground pairs are listed beside the editor.
- Default: make it the theme everyone sees unless they’ve picked their own.
- Copy: make a new theme from it, to edit without touching the original.
- Revert: put an edited built-in theme back exactly as it shipped.
- Delete: remove a theme you’ve made. Anyone using it goes back to the site default. Built-in themes can’t be deleted.
Settings
Section titled “Settings”The Settings tab is one form, with a Save button at the bottom. Nothing saves until you select Save. If anything in the form can’t be used, nothing at all is saved: the page comes back with what you typed and a message beside each field that needs fixing.
This site
Section titled “This site”Title, Subtitle, Canonical URL and Description, for search engines. The title appears in the top bar and in browser tabs. The canonical URL is the site’s full address, such as https://mosaic.example: just the scheme and host, with no path and no slash at the end, and https:// unless it’s running on your own machine. Every link in an email is built from it, and link previews (the picture and text shown when someone pastes a link into a chat) only work while it’s set.
Who can join
Section titled “Who can join”Under New accounts, choose:
- Closed: nobody can sign up.
- Ask me first: people can sign up, and wait in Users until you approve them. See Approving new accounts.
- Open: anyone can sign up and start once they’ve confirmed their email address. If email is off, there’s no way to confirm an address, so open sign-ups wait for approval too, and the sign-up form tells people so.
Mosaic sends email through Cloudflare Email Routing. Set the From address (it must be added under Email > Email Routing > Settings > Custom Addresses in Cloudflare), make sure the Canonical URL is set, then choose On under Send outgoing email and select Save. Mail can’t be switched on without both. The card says Working. once mail is set up.
To check that mail really arrives, select Send me a test under Does it actually work?. It sends one message to your own address and tells you whether it went; if it was refused, the Email card on the dashboard has the reason.
With email off, Mosaic keeps working: new accounts wait for approval, people can’t ask for a password reset themselves (you can issue them a reset link), approvals and suspensions reach people only in the app, and a change of email address takes effect straight away. Switching email off also moves anyone still waiting to confirm their address into the approval queue, and cancels any change of address that was waiting on a link.
Limits and thresholds
Section titled “Limits and thresholds”- Pictures or videos per tile: 10 by default. Changing it leaves tiles already laid alone.
- Tell me when an account has been paused for (days): the threshold for the dashboard’s Paused a long time list. 180 by default.
- Hold a deleted username for (days): 30 by default.
- Reserved usernames: a comma-separated list of names nobody can sign up with, such as
adminandsupport. - The site’s own time zone: dates are shown in each person’s own time zone when they’re signed in, and in this one for visitors who aren’t.
How much room people get
Section titled “How much room people get”A grid of limits in megabytes, for Users and Admins:
| Limit | Users | Admins |
|---|---|---|
| Total storage | 500 | 5120 |
| Largest picture (after resizing) | 2 | 2 |
| Largest video | 10 | 10 |
These are the defaults. Changing a role’s limit changes it for everyone with that role; give one person different storage on their own page. A value outside the allowed range is corrected, and Mosaic tells you what it changed. Limits only stop new uploads: somebody over their limit can still look at, edit and delete what they have.
Search engines
Section titled “Search engines”Let public pages be indexed: Yes or No. Even with Yes, only the public parts of the site (the home page, Explore, tags, mosaics and tiles) are open to search engines, and they only ever see what a signed-out visitor sees. Settings, admin pages and search results are always kept out.
Sign in to Forge
Section titled “Sign in to Forge”Forge, the Dragon’s Lair ticket tracker, can let people sign in with their Mosaic account, the way “Sign in with Google” works. Forge learns their name and email address, and only after they say yes. See Signing in to Forge with Mosaic for what people see.
- Let people sign in to Forge with Mosaic: On or Off. Switching it off stops every sign-in at once, including one already on its way. Nobody’s yes is forgotten, so switching it back on doesn’t ask anybody again.
- Forge’s address: Forge’s own address, as a scheme and host with no path, like the canonical URL. It’s needed before the switch can go on.
Forge has to be set up on its side too, by whoever runs it.
This site’s own images
Section titled “This site’s own images”Below the form, four images each fall back to the one Mosaic ships with until you upload your own:
- Favicon: the icon in a browser tab.
- Site icon: the mark beside the name in the top bar.
- App icon: the icon an installed app wears on a home screen. Square and at least 512 pixels; keep anything important inside the middle 80%, because Android may crop it to a circle.
- Share image: the picture shown when somebody pastes a link to the site. 1200×630 suits most places.
For each, select Choose…, pick an SVG, PNG, JPEG, GIF or WebP file (up to 4 MB), and select Upload. Use the built-in goes back to the shipped image. An SVG containing script or references to other servers is refused. After changing the app icon, an already-installed app may need removing and adding again to pick it up.
The Audit tab records who did what: every admin action on an account, every password and email change, every rename and deletion, every change to a site setting (with its old and new value), Forge sign-ins being allowed or disconnected, and sign-ups the scheduled job removed for never being confirmed. Each row keeps the usernames as they were at the time, so it still reads after an account has gone.
Use What happened to show one kind of action, and select a name to see everything done to or by that person. Clear shows everything again. Long lists are split into pages of 50.
