Running Joomla is a cool and sophiscated infrastructure fully built upon the PHP stack. This makes it truely easy to develop and extend the platform. comes with a built in webserver module with PHP-FPM therefore it is possible to install any PHP-App and run it on that platform. The following guide shows how easy it is to install on a Mac and run Wordpress.

Prerequisite: Up and running installation of MySQL

You will need a running installation of (>= Version 1.0.0). If you are new to this project you can easily download and follow the installation guide for your specific OS.

After the setup has finished the is up and running and you can call the welcome page with


By default, is configured to run on port 9080 in order to not to affect any existing webserver installations. You can easily change that in the /opt/appserver/etc/appserver.xml just by going to section

<server name="http"

and change the port within that section for example to 80. After that restart the which can be done with the following command.

sudo /opt/appserver/sbin/appserverctl restart

Of course there is no need to change the port if you only want to check out the capabilities of this amazing platform.


In order to run the application on, download the latest joomla release from

To install joomla there are now two options. The easiest way is to install joomla without creating a vhost. Therefore just unpack the joomla source into your webrootfolder which in case of the appserver is always the webapps folder underneath /opt/appserver/webapps/. In that folder you will still find the already installed example app and of course the welcome page. Just create a folder named „joomla“ and unpack the source there.

After successfully unpacking the joomla sources you are able to use the joomla webinstaller just by open a browser and calling the URL Before you start the installation it is necessary to correct the rights of the joomla folder to ensure joomla is able to write the configuration.

chmod -R 775 /opt/appserver/webapps/joomla/

Now you are free to step through the installation wizard and therefore it is necessary to create a MySQL database. To create a database you can use the MySQL command line or just use another database administration tool like phpMyAdmin. Of course you can also install phpMyAdmin on Just read the tutorial

To create the database by the command line just use the following line

mysql -uroot -p

On the MySQL command line it is easy to create an empty database. Just use the following command.


Now you are ready to install joomla. Just follow the install wizard.

Installing with Virtual Host

To run a virtual host simply follow the steps below. As with any other Webserver using a vhost you have to add the domain you like to use in your hosts file first.

sudo vi /etc/hosts

Add the following lines: joomla.local
::1 joomla.local
fe80::1%lo0 joomla.local

Afterwards add the vhost to the webserver config of the appserver which you also find in /opt/appserver/etc/appserver/conf.d/virtual-hosts.xml. There is already an example virtual host configuration available. Add the following configuration within the tag.

<virtualHost name="joomla.local">
        <param name="admin" type="string"></param>
        <param name="documentRoot" type="string">webapps/joomla</param>

After adding the vhost, restart the appserver and start with the Installation as described at the beginning of this tutorial

sudo /opt/appserver/sbin/appserverctl restart

Load Comments

Please note that by clicking "Load Comments", your browser will establish a connection with servers from Disqus.
For more information, please visit our privacy statement.