Skip to main content
This section is for root administrators only. Tenant users do not have access to this page.
A Tenant is a separate business account with its own isolated database, users, menu, and settings. Each tenant is completely independent — one tenant cannot see or access another’s data.
Tenants list in the root admin panel showing business names, domain names, and database server assignments

​
Tenant Fields

FieldRequiredDescription
NameYesThe business name displayed in the root admin panel
Domain NameYesThe unique slug used in all API and dashboard URLs, e.g. my-restaurant. Cannot be changed after creation
Database ServerYesWhich PostgreSQL server to provision the tenant’s database on. See Database Servers
ActiveNoToggle off to suspend access for this tenant without deleting their data

​
Create a Tenant

1

Go to Tenants

Click Tenants in the root admin sidebar.
2

Click New Tenant

Fill in the Name, Domain Name, and select a Database Server.
3

Save

Click Create. The tenant database is provisioned automatically on the selected server and migrations run on the next application startup.
Choose the Domain Name carefully — it becomes part of every URL for that business (e.g. app.duitpos.com/my-restaurant/login). Use a slug that matches the business name, is lowercase, and uses hyphens instead of spaces.

​
Manage a Tenant

Click Edit on any tenant to update its name or Active status.
The Domain Name cannot be changed after creation. It is embedded in the tenant’s database name, all URLs, and all API routes. If a tenant needs a new domain name, a new tenant must be created and data migrated manually.

​
Tenant Isolation

Each tenant’s data is completely isolated in its own PostgreSQL database. No tenant can access another’s data — even if they are on the same database server.

​
Frequently Asked Questions

Create a new tenant from the Tenants page. Set the Domain Name to a unique slug for that business. After creation, the business owner can log in at their tenant URL and complete their own setup.
Verify that the Database Server assigned to the tenant is reachable and the credentials are correct. Go to Database Servers, click Edit on the server, and click Test Connection. If the connection fails, check network access and PostgreSQL credentials. Also check that the tenant’s database was provisioned — it should be created automatically on first application startup.
This requires a manual database migration and is not supported through the UI. Contact your platform administrator to coordinate a tenant database move.
Deactivated tenants cannot log in to the dashboard and the POS will not function. Their data is fully preserved and the tenant can be reactivated at any time.

Database Servers

Manage PostgreSQL servers for tenant hosting

Root Users

Manage platform administrator accounts

Locations

Manage physical branches within a tenant

Settings

Configure tenant-level preferences