# Creating your first tenant
The first step in the e-commerce system is creating a tenant. A tenant represents a business subscription to our services and is required to access the following products:
The first step in the Emporix e-commerce system is creating a tenant. A tenant represents a business subscription to our services and is required to access the following products:
* [Emporix API](https://app.gitbook.com/o/z8MNPigQv25NZe33g3AV/s/d4POTWomuSS7d3dnh4Dg/) — the core of our e-commerce system.
* [Emporix Developer Portal](https://app.emporix.io/) — a platform where you can manage your tenants, team members, and Emporix API access credentials.
* [Emporix Management Dashboard](https://admin.emporix.io/) — a content management system where you can manage your business resources related to product management, marketing, order fulfillment, and more.
{% hint style="info" %}
**Free trial**\
You can try out the e-commerce features completely free of charge for 14 days. With the free trial, you get full access to the production-ready e-commerce system, so you can test all of its functionalities before you decide to become our partner.
***What are the differences between a free trial and a paid plan?***
Apart from the free trial being time-limited, there are no differences between free trials and paid plans — both operate in production environments. This approach brings the following benefits:
* Full experience of the e-commerce system during the free trial.
* Easy migration from a free trial to a paid plan (your data remains in the system).
When your free trial ends, the sales team will contact you to hear about your experience with our products.
{% endhint %}
## Setting up a first tenant
You can create and configure a tenant through the [Emporix Developer Portal](https://app.emporix.io/).
{% stepper %}
{% step %}
#### Creating an account
To set up an Emporix tenant, create an account in the Developer Portal. The following registration methods are available:
* Password-based authentication
* Single sign-on (requires additional configuration of an Identity Provider service, to learn more see [Single Sign-On](https://developer.emporix.io/ce/system-management/authentication-and-authorization/authentication/user-authentication/sso))
* Social login with the following platforms:
* Google
* LinkedIn
* Microsoft
{% hint style="danger" %}
When creating an account on the Developer Portal, you need to use a business email address. Email addresses registered to public domains are rejected by the registration form.
{% endhint %}
Registering an account gives you the `ADMIN` permissions in the Developer Portal and in the Management Dashboard.
Once you create an account, you can start creating a tenant straightaway.
{% hint style="warning" %}
**Alert for Unrecognized Browser Logins**
There is a security feature implemented in our system to enhance the protection of your account. Whenever a login attempt is made from an unrecognized browser or device, an alert email is automatically generated and sent to the email address associated with your account.
This alert email is designed to promptly notify you of any login activities that may be unauthorized or suspicious. If you receive such an alert email and you haven't recently logged in or attempted to access your account from a new browser or device, we strongly advise you to take immediate action to secure your account. This includes changing your password and reviewing your account activity, as well as reporting this fact to your organization.
Note that the alert feature works for email and password logins, while for social logins through external platforms, it has to be configured separately by the provider.
{% endhint %}
{% endstep %}
{% step %}
#### Choosing a tenant name
A tenant name is its unique identifier in the Emporix e-commerce system. To call any Emporix API endpoint, you need to pass the tenant name in the form of a path parameter.\
When coming up with a name for your tenant, your business name is usually a good choice.
{% hint style="warning" %}
Your tenant name must fulfill the following criteria:
* It must start with a letter.
* It must be between 3 and 10 characters long.
* It can only contain lowercase letters (without diacritics) and numbers.
{% endhint %}
{% endstep %}
{% step %}
#### Selecting a language
Specify the language in which your business communicates with suppliers and customers.
{% hint style="info" %}
When creating a tenant, you can choose one of the following languages:
* English
* German
{% endhint %}
Select one of the available languages. Once your tenant is ready, you'd be able to change the selected language or add multiple languages for your tenant by using the Emporix API or Management Dashboard.
{% hint style="info" %}
To learn more about language configurations, check out the [Language Configuration guide](https://app.gitbook.com/s/d4POTWomuSS7d3dnh4Dg/api-guides/configuration/configuration-service/language).
{% endhint %}
{% endstep %}
{% step %}
#### Selecting a currency
Your tenant's currency configuration specifies which currencies are accepted by your business.
{% hint style="info" %}
When creating a tenant, you can choose one of the following currencies:
* EUR — Euro
* GBP — Pound sterling
* NOK — Norwegian krone
* USD — United States dollar
{% endhint %}
The currency chooser on the lists the currencies most commonly used by our partners and allows you to select a single currency only. However, you can add any currency or set up multiple currencies for your tenant with the help of Emporix API.
{% hint style="info" %}
To learn more about currency configurations, check out the [Currency guide](https://app.gitbook.com/s/d4POTWomuSS7d3dnh4Dg/api-guides/configuration/currency-service/currency).
{% endhint %}
{% endstep %}
{% step %}
#### Including OE
If you plan to use the OE for automating workflows and business processes, you can select the **Include OE** option to get access to the full potential of Commerce Orchestration Platform.
{% endstep %}
{% step %}
#### Subscribing to the newsletter
Stay up-to-date with the latest news about our products and services.
{% endstep %}
{% step %}
#### Creating a tenant
Creating a tenant view:
Once you fill out the form, choose **Create a tenant** and wait a couple of minutes for your tenant to finish setup. When your tenant is ready, you are redirected to its dashboard on the Emporix Developer Portal. Check your inbox, as you should receive the confirmation email.
{% endstep %}
{% endstepper %}
## Out-of-the-box configuration
Once your tenant is ready, you get immediate access to various resources.
### Emporix API
The Emporix API is the core of the e-commerce system. With the API, you can easily manage your business resources.
To prevent unauthorized access to your business sensitive data, your tenant is provided with different API credentials:
* **Emporix API** — used to access the API from a business owner's perspective.
* **Storefront API** — used to access the API from a customer's perspective. These credentials are used to perform basic actions on a storefront — browse products, view prices, or add products to cart.
* **Custom API** - build your custom scopes to access different services and assign permissions to the users
You can access your tenant's API credentials in the [API Keys section of the Developer Portal](https://app.emporix.io/api-keys).
{% hint style="info" %}
To learn more about our API, check out the [Getting started with Emporix API](https://app.gitbook.com/o/z8MNPigQv25NZe33g3AV/s/d4POTWomuSS7d3dnh4Dg/).
{% endhint %}
### Preconfigured data
To make onboarding easier, some of the resources are automatically configured.
If you want to check specific values configured for your tenant, call the API endpoints referenced in the table.
| Resource | Data available out-of-the-box | API |
| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Global (tenant-wide) configurations |
|
{% hint style="success" %}
Emporix facilitates the tenant onboarding and configuring process through the AI extensions you might use to for initial setup.
* AI Smart Import allows you to import test sample data so that you get familiar with the system and connections between resources before productizing the project data.
* AI Smart Config guides you through the tenant setup process and helps you choose the relevant tenant configuration for your tenant needs.
For more information, check out the [Quickstart Powered by AI](https://app.gitbook.com/s/8GgoeZEZYjZrpjOU6w52/ai-in-emporix/ai-intro "mention").
{% endhint %}
### External applications
To improve your customers' shopping experience, you can enable an external application for search and indexing. Check out [Search Configuration](https://developer.emporix.io/ce/system-management/search/search-configuration) and [Indexing Service](https://developer.emporix.io/ce/system-management/search/indexing) documentation.
{% hint style="warning" %}
Indexing of your tenant's data in Algolia is disabled by default. If you want to enable this functionality, reach out the [Support Team](mailto:support@emporix.com).
{% endhint %}
## Performance tests
To ensure good system performance for all our partners, we need to know in advance if you plan to run any load, stress, or other types of performance tests on your tenant. In such cases, contact the [Support Team](mailto:support@emporix.com).
