Logo

_images/joomla.png

Joomla!¶

Joomla is a free and open-source content management system (CMS) for publishing web content, developed by Open Source Matters, Inc. It is built on a model–view–controller web application framework that can be used independently of the CMS. Joomla is distributed under the GPLv2 license.

Note

For this guide you should be familiar with the basic concepts of

Prerequisites¶

We’re using PHP in the stable version 7.1:

[isabell@stardust ~]$ uberspace tools version show php
Using 'PHP' version: '7.1'
[isabell@stardust ~]$

You’ll need your MySQL credentials. Get them with my_print_defaults:

[isabell@stardust ~]$ my_print_defaults client
--default-character-set=utf8mb4
--user=isabell
--password=MySuperSecretPassword
[isabell@stardust ~]$

If you want to use Joomla! with your own domain you need to setup your domains first:

[isabell@stardust ~]$ uberspace web domain list
isabell.uber.space
[isabell@stardust ~]$

Installation¶

cd to your document root, then download the latest release of Joomla! and extract it:

Note

The link to the lastest version can be found at Joomla!’s download page.

[isabell@stardust ~]$ cd /var/www/virtual/$USER/html/
[isabell@stardust html]$ wget https://downloads.joomla.org/cms/joomla3/3-8-12/Joomla_3-8-12-Stable-Full_Package.zip
[isabell@stardust html]$ unzip Joomla_3-8-12-Stable-Full_Package.zip

Now point your browser to your uberspace URL or domain and follow the instructions.

You will (at least) need to enter the following information:

Page 1 - Configuration:
  • Site Name: Enter the name of your website, e.g. isabell.uber.space
  • Email: Enter the email address of the website administrator, e.g. isabell@uber.space
  • Username: Set the user name of the administrator account, e.g. admin
  • Password and Confirm Administrator Password: Set the password of the administrator account, e.g. superstrongadminpassword
Page 2 - Database Configuration:
  • Database Type: Set it to MySQLi
  • Host Name: localhost
  • Username: isabell
  • Password: yourMySQLPassword (you should know your MySQL credentials by now; if you don’t, start reading again at the top.)
  • Database Name: your Joomla! database name: we suggest you use an additional database. For example: isabell_joomla
  • Table Prefix: just stick to the randomly generated one
  • Old Database Process: Backup to be sure
Page 3 - Finalization
  • Install Sample Data: up to you…
  • Email Configuration: up to you…
  • Check that all Pre-Installation Checks are fullfilled (a green Yes)
  • Check that all Recommended Settings are fullfilled (for me the only difference was Output Buffering which is recommended to off, but is on in my case – it does not matter, Joomla! will still operate)

Hit Install! You should see a message Congratulations! Joomla! is now installed You can also install optionally extra languages by clicking on Extra steps: Install languages

Important: Click Remove installation folder. You will not be able to proceed beyond this point until the installation folder has been removed. This is a security feature of Joomla!

Updates¶

The easiest way to update Joomla! is to use the web updater provided in the admin section of your website, e.g. isabell.uber.space/administrator

Tested with Joomla! 3.8.12, Uberspace 7.1.12

Written by: Willi Mutschler <willi@mutschler.eu>