Running setup

To get your OXID eShop ready for launch, run the setup.

In the following, we describe the web-based setup.

Alternatively, you can run the setup via command line. For more information, see Setup via command line.

Starting the setup

Ensure that configuration parameters can be written during the setup and start the setup.

Open a Shell and go to the shop directory.
```
cd /var/www/oxideshop/source
```
Ensure the following files are not read-only:
- .htaccess
- config.inc.php
Open a browser and open the shop under www.myshopurl.de/setup.

Replace www.myshopurl.de with the OXID eShop URL.

The setup starts.

Requirements

The following icons indicate whether the system requirements have been met:

The requirement has been met.
The requirement hasn’t been met or has been met only partially. OXID eShop still works and can be installed.
The requirement hasn’t been met. OXID eShop doesn’t work without meeting this requirement and can’t be installed.
The requirement couldn’t be verified.

Select the language for the installation.
To install OXID eShop and ensure uninterrupted operation, ensure the system requirements are met. In case of any configuration issues, contact your OXID Hosting Partner or Internet Service Provider (ISP).
Once all system requirements are met (there are no red icons), choose Proceed with setup.

Welcome

Specify main shipping country and the shop’s language. You can always add other countries and/or languages later on.
Recommended: Check the box to have the shop regularly checked for updates.
Optional: When installing the Community Edition, help improve product quality by confirming the connection to the OXID servers.
Choose Start installation.

License terms

Check the license terms and confirm them.

Database

Create a database or integrate an existing one.

Database server hostname or IP address

You have the following options:

If your database and the webserver share the same server, use the default value localhost. This is the standard procedure for most shops.

if you have an outsourced database, enter the hostname or the IP address of your database server. If required, enter the port after the hostname and a colon (hostname:port).

Database Name

You have the following options:

Enter the name of your outsourced database.

If you don’t have a database yet, enter a name for a database to be created during the setup.

Database username and Database password

Enter the login data for the database. Make sure to keep this login data in a safe place.

Demo data

Decide whether you want to install the shop preconfigured with sample products.

We recommend demo data if you want to use a test installation to familiarize yourself with the shop first.

You can always delete the demo data later on if you want to add your own products to the shop.

If you don’t have a database yet, choose Create database now.

If you have integrated an existing database, a message appears that the database is being overwritten and the tables and data required are being saved.

Directories & login

If required, adjust the adjust the directory settings and define the login data for the shop’s Admin panel.

Note down the following settings and make sure to keep this data in a safe place.

Shop URL

Shows the URL under which your OXID eShop will be accessible.

Directory for OXID eShop

Generates the internal path to the shop on the server.

Adjust the path if you have multiple shops, for example.

You will need this path in the last step of the setup.

Directory for temporary data

Names the directory where the shop’s temporary files, e.g. for Smarty or SEO cache, are stored.

Background: Some module will ask you to clear temporary data manually from time to time.

Administrator E-Mail und Administrator Passwort

Enter your administrator e-mail and password.

With this login data you will log in to the administrator panel after you have completed the setup.

License

If you have an Enterprise or Professional Edition, enter the license key you have received when purchasing OXID eShop.

Find the license key on the receipt sent to you by e-mail.

Choose Save license key.

Finish

For reasons of security, set the config.inc.php file into read-only mode. Activate a theme. Test the shop.

Open the shell and go to the shop directory (by default, /var/www/ocideshop/source/).
Execute the following command:
```
chmod 0444 config.inc.php
```
Setting config.inc.php file to read-only ensures that the production system cannot be fatally compromised by changes of, for example, the database name or the shop URL.
Make sure that a theme is activated.
1. To open the store as an administrator, choose the To store administration link.
2. Under Extensions ‣ Themes, activate a Twig-compatible theme (the APEX theme is installed by default).
  If you do not use the default APEX theme, make sure that your custom theme is compatible with the Twig engine.
To test the store, choose the To shop link.