System configuration
Under System configuration are the name of your instance and the addresses under which it can be reached.
Super admins find the page under Settings > General > System configuration. It exists only when several instances run on the same server.
Domains and their purpose
A domain is an address such as beispiel.fepli.eu. Every domain of your instance has a purpose. The purpose determines what appears under the address.
A domain belongs to exactly one instance. It serves exactly one of the purposes Public site, Admin and API. It may also serve Email sending. Requests to the domain then still reach the other purpose.
Fields
| Element | Effect |
|---|---|
| Editing | Super admins change Name and Domains. Everything else is set by the operator. |
| Name | The name of the instance throughout the admin panel. |
| Slug | Set when the instance is created and cannot be changed afterwards. |
| Domains | One Domain per row with its Purpose. Add another domain adds a row. An instance needs at least one domain. |
| Purpose | Public site, Admin, API or Email sending, as in the picture above. |
| Domain preview | Shows for each address what it shows after saving (Domain preview). |
| Domain for the Admin | The admin panel then lies directly under this domain instead of under /admin of the website. Links to the admin panel in emails lead to this domain. |
| New domain for the Admin | Invitations and sign-in links sent earlier are no longer valid. Newly sent ones lead to the new domain. |
| Domain for Email sending | Emails come from an address under this domain. You choose the part before the @ under Email sending. The mail provider must have verified the domain. |
| No domain for Email sending | Emails come from the operator's sender address. |
| Embeds without a website | If embeds are turned on, the instance needs a domain for the Public site. That is where families register. |
| State | Take offline and Delete tenant. Only the operator's admins have these actions. This manual does not describe them. |
Domain preview
The preview shows what visitors find under each address after saving:
- Website for families
- Admin panel
- API, as long as the app API is switched on
- Embeds, as long as embeds are turned on, with the address from which other websites load the embeds
If the instance has embeds and no website of its own, Registration for families (no direct access) appears instead of Website for families. Families then reach the address through the link of an offer.
Messages
| Message | Meaning |
|---|---|
| “The domain "{domain}" already belongs to a tenant.” | Another instance on the server already uses the domain. |
| “The domain "{domain}" is already entered for this purpose.” | The domain appears twice in the list with the same purpose. |
| “The domain "{domain}" already has a purpose. Only “Email sending” can share a domain with another.” | A domain serves only one purpose, plus at most email sending. |
| “The address "{domain}" is reserved for the examples in the documentation. Please choose another one.” | Addresses such as beispiel.fepli.eu belong to the examples of this manual. No instance may use them. |
| “A tenant needs at least one domain.” | The last domain cannot be removed. |
| “Embeds are on, but no address serves the website for families, where families register. …” | Give the instance a domain for the Public site, alone or next to the admin panel’s. |
| “No domain selected for sending email. System emails go out under the installation's sender address.” | Without a domain of its own for sending, the operator's sender address applies. |