Installing Oxid eShop on Ubuntu

Submitted by olaf on 2015-08-04

For a small project, I had to install Oxid eShop on my Ubuntu system. There are installation instructions at Server and system requirements and Oxid Wiki - Installation, though these are generic instructions for any system.

For Ubuntu, you can simplify the first steps by just installing the necessary packages. First, you must install a LAMP (Linux, Apache, MySQL, PHP) stack. This is done simply by

apt-get install apache2 mysql-server php5 php5-mysql

Oxid also needs PHP bindings for the GD Graphics library and cURL

apt-get install php5-gd php5-curl

Apache’s mod_rewrite module is also needed and activated by

a2enmod rewrite
service apache2 reload

To enable mod_rewrite for Oxid, you need the following in your Apache configuration, e.g. /etc/apache2/conf-available/oxid.conf symlinked to /etc/apache2/conf-enabled or activated with a2enconf oxid. Assume Oxid is installed in the directory /var/www/oxid

Alias /oxid /var/www/oxid

<Directory /var/www/oxid>
	Options +FollowSymLinks
	AllowOverride All
</Directory>

As described at Files & Folder Permission Setup, you must allow write access to

cd /var/www/oxid
chown -R www-data.www-data config.inc.php .htaccess log/ tmp/ out/pictures/ out/media/ export/

After installation config.inc.php and .htaccess may be read only.

Finally, create a database for Oxid

mysqladmin -u root -p create oxid

and give access to some Oxid user

grant all privileges on oxid.* to 'oxid'@'localhost' identified by 'SeCrEtPaSsWoRd;

Normal password rules apply. Note the user and password, you need it later for setup.

That’s it for preparation, now go to http://localhost/oxid or http://www.example.com/oxid and follow setup instructions.

Post a comment

All comments are held for moderation; Markdown and basic HTML formatting accepted. If you want to stay anonymous, leave name, e-mail and website empty.