Local installation
In this tutorial you will learn how to install imperia CMS for development purposes. This tutorial is intended for web developers who want to set up imperia CMS locally.
For detailed step-by-step instructions for productive environments, read the instructions Installation: Ubuntu & Apache or Installation: Ubuntu & Nginx.
Step 1: Install minimum software requirements#
With Ubuntu Perl is already provided by default. Here you only need to install the following packages via the package manager of Ubuntu.
sudo apt-get install -y libdbd-sqlite3-perl perlmagick
With CentOS and Redhat you install the same packages:
sudo yum install perl-DBD-SQLite ImageMagick-perl
Step 2: Download installation package#
The software package can be downloaded from imperia's Support page.
Example of the file name of an installation package:
imperia-11.0.0.tar.gz
Step 3: Extract the installation package#
Navigate to the directory where you have downloaded the installation package and unpack it:
tar -xzf imperia-11.0.0.tar.gz
Step 4: Run installation script#
Run the installation script contained in the directory on an empty directory.
perl imperia-11.0.0/install.pl -s /home/otto/imperia/dev/site
Follow the installation dialog.
Step 5: Memorize the superuser password#
A superuser password is generated at the end of the installation process. Make a note of it!
Example password from an installation process:
**************************************************************************
**************************************************************************
** The superuser password for this installation is: **
** **
** NlMTe2Ds1K **
** **
** You can change it to your taste once you have logged in. **
**************************************************************************
**************************************************************************
Step 6: Start internal web server#
Start the internal imperia CMS web server from the installation directory:
perl /home/otto/imperia/dev/site/bin/site_imperia.pl
Step 7: Call imperia CMS in your browser#
imperia CMS now runs on your computer under port 2404. Call the following URL in your browser:
http://localhost:2404/imp/dashboard
Step 8: Login to imperia CMS#
Log in with the name superuser and the password noted in step 4.
Name: superuser
Passwort: NlMTe2Ds1K
Step 9: Enter license data#
Currently imperia CMS is still in trial mode. To activate imperia CMS completely, you have to enter the license data you received from imperia Support.
Copy file regkey.bin#
Copy the file regkey.bin, which you also received from imperia support, into the site/config directory of the installation directory.
cp /home/otto/Downloads/regkey.bin /home/otto/imperia/dev/site/config
Enter license key#
In the imperia editorial system, navigate to the menu item System -> Registration key and enter your licensee and registration key here.
Click OK to complete the registration.
Step 10: Install a target system#
To install a target system, follow the same steps as for installing a development system. Only when selecting the server type, specify "LIVE".
During the installation, the directories for the target system must be defined. The directories that do not exist are automatically created by the script.
How do you proceed from here?#
The local installation should above all give an impression of how the installation process of imperia CMS basically works. For a detailed step-by-step guide for productive environments, read the following instructions:
Installation with Ubuntu and Apache oder Installation with Ubuntu and Nginx
As an alternative to the native installation via the installation script, you can also simply run imperia CMS in a docker container. Here all software dependencies are pre-installed and imperia can be started directly:
You don't know why you have to install a target system in addition to the CMS? Then take a look at the operating concept: