Update configuration and system-wide settings
Site-wide settings in Raytha are spread over a few screens in the admin sidebar. This page covers the Configuration screen field by field and tells you where each of the other settings lives, so you can find the one you want.
What you need
The Manage System Settings permission. Without it the whole Settings group is missing from your sidebar. See Manage administrators, roles and permissions.
Change the basic settings
- Open Settings > Configuration.
- Change the fields you need. They are listed below.
- Click Save. A "Configuration saved" message appears.
All of these save together with the email settings on the same page, so one Save covers the whole form.
Configuration fields
| Field | What it is and what it affects |
|---|---|
| Organization name | Required. Your site's name. Available to templates as CurrentOrganization.OrganizationName and used in the built-in email subjects, such as "[Your site] Password recovery". |
| Website URL | Required. The public address of the site, for example https://www.example.com. Raytha uses it to build absolute links in emails, single sign-on addresses and media links. A trailing slash is ignored. It must be a valid URL. Set it to the address visitors use, not an internal host name. |
| Time zone | Required. Pick from the list. Templates use it with the organization_time Liquid filter to show dates in your local time. Stored dates stay in UTC. |
| Date format | Required. Either MM/dd/yyyy or dd/MM/yyyy. Applied to date columns in content lists in the admin, and readable by templates as CurrentOrganization.DateFormat. |
| Default from address | Required. The sender address for email Raytha sends. It must be a valid email address. |
| Default from name | Required. The sender name shown with that address. |
| Override system SMTP and its Host, Port, Username, Password | Choose whether Raytha sends mail through settings you enter here or through the server's own configuration. See Set up SMTP and email. |
Note The home page is not set here. Open the site page you want under Content > Site pages and use Set as home page. See Set a content item as the home page.
Where the other settings live
| You want to | Go to | Needs |
|---|---|---|
| Turn sign-in methods on or off, set up single sign-on | Settings > Authentication | Manage System Settings |
| Keep the database small: how long logs are kept, clear logs, see disk and database size | Settings > Maintenance | Manage System Settings |
| Watch imports, exports, theme jobs and webhook deliveries | Settings > Background tasks | Manage System Settings |
| Edit the emails Raytha sends | Design > Email templates | Manage System Settings |
| Check what was sent | Observability > Email log | Manage System Settings |
| See who changed what | Observability > Audit log | Manage Audit Logs |
| Send events to another system | Automation > Webhooks | Manage System Settings |
| Run custom code | Automation > Functions | Manage System Settings |
| Administrators, roles and API keys | People > Admins, People > Roles | Manage Administrators |
| Change the active theme | Design > Themes | Manage Templates |
Maintenance in more detail
Settings > Maintenance shows two usage cards, Database and File storage, and a Data retention section with one row for each log:
- Audit log, Email log, Webhook deliveries and Finished background tasks.
Each row shows the row count and the age of the oldest entry. Enter a number of days (0 to 3650) and click Save to change how long entries are kept. The default is 180 days, and 0 keeps entries forever. Raytha deletes entries older than the window every day at 03:00 UTC. Clear now deletes everything in that log immediately after you confirm; queued and running background tasks are kept, and clearing the audit log leaves one entry recording that it was cleared.
Your own profile
Open the account menu at the bottom of the sidebar and choose My profile. You can change your First name and Last name and click Save. Under the password section, enter your Current password and a New password and click Change password. Your email address and roles are changed by another administrator under People > Admins.
Settings that are not in the admin
Some settings belong to the server and are set with environment variables when Raytha is deployed: the database, file storage, the base SMTP account, how long a sign-in impersonation session lasts, rate limits and proxy trust. Ask whoever runs your server, or see Configuration in the developer docs.
Gotchas
- Wrong Website URL. Links in emails and single sign-on addresses will point to the wrong place. Fix it first when links look odd.
- Saving this form re-saves the SMTP password. With Override system SMTP on, retype Password every time you click Save, or the stored password is replaced by an empty one.
- Changing the Time zone changes how existing dates display in templates, not the stored values.
- Clearing logs cannot be undone. The admin has no export for logs, so copy what you need first. To trim gradually, lower the retention window instead of clicking Clear now.
- Settings that appear greyed out or missing usually mean your roles lack the permission, not that the feature is missing.