Appearance
Create a tenant
Also known as
- new tenant
- onboard client
- provision
- add organisation
- new workspace
- subdomain
- slug
- account admin
- module selection
- sign up customer
Create a tenant to give a new client organisation its own workspace. In one form you name it, choose its sign-in address, base currency and language, create its first administrator and pick the modules it pays for.
Create the tenant
- Select New tenant on Tenants or the console Overview.
- Under Organisation, type the Name. The Slug fills in from it; change it if you want another address. The hint under it shows the address users will open, for example
acme.roari.app. - Choose the Base currency and the Language.
- Under Account administrator, fill in the first user: Display name, Email, Username (
adminby default) and Password. Select Generate for a strong random password; select the eye icon to see it. - Under Modules, switch on the modules the organisation uses (see below).
- Select Create tenant.
You see … is ready and the new tenant's page opens. Send the administrator their address, username and password through a secure channel; they can change the password after signing in and add everyone else in Users.
| Field | Required | What to enter | Validation |
|---|---|---|---|
| Name | Yes | The organisation's name, for example Acme Trading LLC. | At least 2 characters: Enter the organisation’s name. |
| Slug | Yes | The short name in the sign-in address. | 2–31 lowercase letters, digits or hyphens, starting with a letter. Must be unique: Already in use. |
| Base currency | Yes | The currency of the ledgers and reports (AED by default). | It cannot change once documents are posted. |
| Language | Yes | English or Arabic (العربية): the default for new users. | |
| Display name | Yes | The administrator's full name. | Enter a display name. |
| Yes | Their work email; notifications go there. | Enter a valid email address. | |
| Username | Yes | What they type to sign in. | Letters, digits, dots, hyphens or underscores (2–40). |
| Password | Yes | Their first password. | At least 10 characters. |
The administrator gets the account_admin role: full access to everything in the organisation.
Choose the modules
Finance & accounting is Mandatory and always on. Each other module shows what it Needs and what it Works with:
- Switching a module on also switches on what it needs. A gold note explains it, for example "Manufacturing needs Inventory & warehousing, so it was turned on too."
- Switching a module off also switches off the modules that need it ("Turning off Inventory & warehousing also turns off …").
- Works with modules are optional: the module links to them when both are on.
You can change the modules later on the tenant's Modules tab. If the server refuses a combination you see the reason in a red banner above the form.
Related
- Tenants
- Tenant
- Module catalogue
- Tenant administration
- Modules: the tenant's own view of its modules
