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 8.1:

[isabell@stardust ~]$ uberspace tools version show php
Using 'PHP' version: '8.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 latest 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/joomla4/4-2-5/Joomla_4-2-5-Stable-Full_Package.zip
[isabell@stardust html]$ unzip Joomla_4-2-5-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

Page 3 - Finalization
  • Install Sample Data: up to you…

  • Email Configuration: up to you…

  • Check that all Pre-Installation Checks are fulfilled (a green Yes)

  • Check that all Recommended Settings are fulfilled (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

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! 4.2.5, Uberspace 7.13, PHP 8.1

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