This is an old revision of the document!

Information

Prerequisites

Dependencies

sudo zypper install nodejs-common php-composer2 php-gd php8-intl php-ldap php8-mysql php8-openssl php8-sodium php8-fileinfo php8-mbstring

Download Source

sudo git clone --branch '6.1-dev' --depth '1' --recurse-submodules 'https://github.com/joomla/joomla-cms.git' '/srv/www/main' && sudo chown -R 'wwwrun':'www' '/srv/www/main'

Environment

https://docs.joomla.org/Special:MyLanguage/J5.x:Setting_Up_Your_Local_Environment

Composer

sudo su 'wwwrun' -s '/bin/bash'

cd '/srv/www/main' && composer install

Node.js

sudo su 'wwwrun' -s '/bin/bash'

npm --prefix '/srv/www/main' ci && npm --prefix '/srv/www/main' audit fix

Databases

sudo mariadb

CREATE DATABASE joomla_db;

CREATE USER 'joomla'@'localhost' IDENTIFIED BY 'x';

GRANT ALL PRIVILEGES ON joomla_db.* to 'joomla'@'localhost';

FLUSH PRIVILEGES;

EXIT

nginx + PHP-FPM Configuration

PHP-FPM Socket

sudo -e '/etc/php8/fpm/php-fpm.d/main.conf' && sudo systemctl restart 'php-fpm'

[main]

; User/Group
user = "wwwrun"
group = "www"

; Socket
listen = "/run/php-fpm/main.sock"
listen.owner = "wwwrun"
listen.group = "www"
listen.mode = "0662"

; Process Management
pm = "ondemand"
pm.max_children = "4"
pm.process_idle_timeout = "30"

; openSUSE php.ini Defaults
php_value[session.save_path] = "/var/lib/php8/sessions"

; General
php_value[date.timezone] = "America/New_York"
php_value[max_execution_time] = "200"
php_value[memory_limit] = "512M"
php_value[post_max_size] = "30M"
php_value[upload_max_filesize] = "30M"
php_value[max_file_uploads] = "100"

; End

FastCGI

main.sock

sudo -e '/etc/nginx/default.d/main.conf'

location ~ \.(php|phar)(/.*)?$ {
    fastcgi_split_path_info ^(.+\.(?:php|phar))(/.*)$;
    fastcgi_intercept_errors on;
    fastcgi_index index.php;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_param PATH_INFO $fastcgi_path_info;
    fastcgi_pass unix:/run/php-fpm/main.sock;
}

# End

Server Block

Nginx - Joomla! Documentation

sudo -e '/etc/nginx/vhosts.d/main.conf' && sudo systemctl reload 'nginx'

server {
    listen '443' 'ssl';
    http2 'on';
    server_name 'realmofespionage.xyz';
    root '/srv/www/main';
    index 'index.php';

    include '/etc/nginx/default.d/main.conf';
    include '/etc/nginx/default.d/headers.conf';

    client_max_body_size '30M';

#    access_log  /var/log/nginx/main-access.log;
#    error_log  /var/log/nginx/main-error.log;

    location /api/ {
	try_files $uri $uri/ /api/index.php?$args;
    }

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~* /(images|cache|media|logs|tmp)/.*\.(php|pl|py|jsp|asp|sh|cgi)$ {
        return 403;
        error_page 403 /403_error.html;
    }

    location ~* \.(ico|pdf|flv)$ {
        expires 1y;
    }

    location ~* \.(js|css|png|jpg|jpeg|gif|swf|xml|txt)$ {
        expires 14d;
    }
 
}

# End

Initial Setup

https://realmofespionage.xyz
If Joomla gives a 500 error, it's likely the sessions folder not having the right permissions, see nginx - Permissions

Settings

Purity III Template

Purity III

Install

Downloads
Download Purity III Template and T3 System Plugin ( not 20 MB+ quickstarts; not Purity III for Joomla 5)

System Dashboard

Templates → Site Template Styles
Set purity_III - Default to Default

Theme Settings

General → Show T3 Logo: Off

Theme → Logo Type: Text
Theme → Site Name: Realm of Espionage

Navigation → Megamenu Configuration → Animation: Fading
Navigation → Megamenu Configuration → Duration: 300

Add-ons → Off-canvas Sidebar → Enable: Off

Assignment → Toggle Selection

Copyright

Last tested: 2024/02/01 on Joomla 5.1.0-dev, T3 Framework 3.2.0, and Purity III 2.1.0

Logo

wget -O '/tmp/cc-by-sa-40.png' 'https://licensebuttons.net/l/by-sa/4.0/80x15.png' && sudo mv '/tmp/cc-by-sa-40.png' '/var/www/main/images/cc-by-sa-40.png' && sudo chown 'nginx':'nginx' '/var/www/main/images/cc-by-sa-40.png' && sudo restorecon -F -I -R '/var/www/main/images/cc-by-sa-40.png' && sync

Text

Place text within the <section class=“t3-copyright”> section underneath the Bootstrap by Twitter and Font Awesome mentions
Remove Bootstrap by Twitter and Font Awesome mentions

sudo -e '/var/www/main/templates/purity_iii/tpls/blocks/footer.php' && sudo chown 'nginx':'nginx' '/var/www/main/templates/purity_iii/tpls/blocks/footer.php'

          <small>
            <img src="https://realmofespionage.xyz/images/cc-by-sa-40.png" width="80" height="15" /> All content and data available on Realm of Espionage is available under the <a href="https://creativecommons.org/licenses/by-sa/4.0" target="_blank">Creative Commons Attribution-ShareAlike 4.0 International</a> license.
          </small>

Custom CSS

This shrinks the footer height, and places it back at the bottom of the screen instead of floating half-way up the page when little content exists (source 1, source 2)
Also replaces ThemeMagic for Brand Primary Color, Footer Background, and Footer Text Color

Last tested: 2024/02/01 on Joomla 5.1.0-dev, T3 Framework 3.2.0, and Purity III 2.1.0

sudo -e '/var/www/main/templates/purity_iii/css/custom.css' && sudo chown 'nginx':'nginx' '/var/www/main/templates/purity_iii/css/custom.css'

html,

body {
  height: 100%;
}

a {
  color: #3D8BFF;
}

a:hover {
  color: #196BE4;
}

.t3-mainnav {
  background-color: #3D8BFF;
}

.logo a {
  background: none;
}

.logo a:hover {
  background: #196BE4;
}

.t3-wrapper {
  position: relative;
  min-height: 100%;
}

.t3-footer {
  position: absolute;
  bottom: 0;
  left: 0;
  right: 0;
  background-color: #484848;
  color: #FFFFFF;
}

.t3-copyright {
  padding-top: 20px;
  padding-bottom: 0px;
}

Articles

Home

Toggle Editor for raw-HTML paste

<p><br>Welcome! Realm of Espionage is <a href="https://wiki.realmofespionage.xyz/user:espionage724" target="_blank" rel="noopener">my</a> creative space online, and the umbrella name I provide my services under. RoE is entirely self-hosted, in-house, with free and open-source software, and fully-documented in my unique notes style on <a href="https://wiki.realmofespionage.xyz/" target="_blank" rel="noopener">RoE | Wiki</a>, my encyclopedia of technical notes and no-nonsense automation.</p>
<p> </p>
<p>This domain serves as a landing page and provides links to the services I offer, some of my online profiles, and projects showcase. To view them, use the navigation bar (desktop) or the ≡ hamburger icon (mobile) at the top of the screen.</p>
<!-- End -->

Temp

<p> </p>
<p>(website is under construction and there aren't any links in the nav bar yet; my <a href="https://wiki.realmofespionage.xyz/">wiki</a> is far-more interesting! <a href="https://wiki.realmofespionage.xyz/user:espionage724">webmaster info</a>, <a href="https://wiki.realmofespionage.xyz/servers:linux:nginx:joomla" target="_blank" rel="noopener">dev notes</a>)</p>
<!-- End -->

Offline Message

This site is being built behind-the-scenes, check back later!
<br />
In the meantime, check out my wiki: <a href="https://wiki.realmofespionage.xyz/">RoE | Wiki</a>

Menus

Main menu headers are: System Links → URL → # to allow tapping as-expected on mobile
Icon sizes are 24×24
Menu entries should be named normally before saving for a proper alias, and then add a space on the title afterwards to make it look better with the icon

Global Configuration

Site Meta Description

Realm of Espionage is my creative space, and the umbrella name I provide my services under. RoE is self-hosted, with free and open-source software, and fully-documented in my unique notes style on "RoE | Wiki", my encyclopedia of technical notes and no-nonsense automation

Content Rights

Creative Commons Attribution-ShareAlike 4.0 International

Articles

System → Global Configuration → Articles

Show Title: Hide
Show Category: Hide
Show Author: Hide
Show Publish Date: Hide
Show Navigation: Hide
Show Hits: Hide

Menus → Main Menu → Home → Link Type → Display in Menu: No
Menus → Main Menu → Home → Page Display → Show Page Heading: Hide

Services

Updater

Service

sudo -e '/etc/systemd/system/main-up.service'

[Service]
User=wwwrun
Group=www
Type=oneshot

Environment="COMPOSER_CACHE_DIR=/dev/null"

ExecStart='/usr/bin/git' -C '/srv/www/main' pull origin '6.1-dev'

ExecStart='/usr/bin/composer' --working-dir='/srv/www/main' --no-cache install
ExecStart='/usr/bin/npm' --prefix '/srv/www/main' ci --logs-max='0'
ExecStart='/usr/bin/npm' --prefix '/srv/www/main' audit fix --audit-level='none' --logs-max='0'

ExecStartPost='/usr/bin/sync'

# End

Timer

Every day at 03:00:00

sudo -e '/etc/systemd/system/main-up.timer' && sudo systemctl daemon-reload && sudo systemctl enable 'main-up.timer' --now && sudo systemctl start 'main-up' && sudo systemctl status 'main-up' -l

[Unit]
Description=Joomla Git Updater
After=network-online.target
Wants=network-online.target

[Timer]
OnCalendar=*-*-* 03:00:00
Persistent=true

[Install]
WantedBy=timers.target

# End

Backup

Files

Service

mkdir -p ~/'backups' && sudo -e '/etc/systemd/system/main-fb.service' && sudo sed -i 's/CHANGEME/'$USER'/g' '/etc/systemd/system/main-fb.service'

[Service]
Type=oneshot

ExecStart='/usr/bin/bash' -c '"/usr/bin/tar" -czf "/home/CHANGEME/backups/joomla-files-auto-"$$(date +%%Y-%%m-%%d)".tar.gz" -C "/srv/www" "main"'

ExecStartPost='/usr/bin/sync'

# End

Timer

01 day of every month at 03:15:00

sudo -e '/etc/systemd/system/main-fb.timer' && sudo systemctl daemon-reload && sudo systemctl enable 'main-fb.timer' --now

[Unit]
Description=Joomla Files Backup

[Timer]
OnCalendar=*-*-01 03:15:00
Persistent=true

[Install]
WantedBy=timers.target

# End

sudo systemctl start 'main-fb' && sudo systemctl status 'main-fb' -l

Database

Database Auth

sudo mkdir -p '/var/lib/mysql/auth' && sudo -e '/var/lib/mysql/auth/joomla' && sudo chown 'mysql':'mysql' '/var/lib/mysql/auth/joomla' && sudo chmod '0600' '/var/lib/mysql/auth/joomla'

[mariadb-dump]
user=joomla
password=x

# End

Service

mkdir -p ~/'backups' && sudo mkdir -p '/var/lib/mysql/tmp' && sudo -e '/etc/systemd/system/main-db.service' && sudo sed -i 's/'CHANGEME'/'$USER'/g' '/etc/systemd/system/main-db.service'

[Service]
Group=mysql
Type=oneshot

ExecStart='/usr/bin/bash' -c '"/usr/bin/mariadb-dump" --defaults-extra-file="/var/lib/mysql/auth/joomla" --single-transaction --quick "joomla_db" -r "/home/CHANGEME/backups/joomla-database-auto-"$$(date +%%Y-%%m-%%d)".sql"'

ExecStartPost='/usr/bin/sync'

# End

Timer

01 day of every month at 03:10:00

sudo -e '/etc/systemd/system/main-db.timer' && sudo systemctl daemon-reload && sudo systemctl enable 'main-db.timer' --now && sudo systemctl start 'main-db' && sudo systemctl status 'main-db' -l

[Unit]
Description=Joomla Database Backup
After=mariadb.service

[Timer]
OnCalendar=*-*-01 03:10:00
Persistent=true

[Install]
WantedBy=timers.target

# End

Maintenance

Service

sudo -e '/etc/systemd/system/main-m.service'

[Service]
User=wwwrun
Group=www
Type=oneshot

ExecStart='/usr/bin/git' -C '/srv/www/main' gc --aggressive --prune='all'
ExecStart='/usr/bin/git' -C '/srv/www/main' fsck --full --strict

ExecStartPost='/usr/bin/sync'

# End

Timer

01 day of every month at 03:30:00

sudo -e '/etc/systemd/system/main-m.timer' && sudo systemctl daemon-reload && sudo systemctl enable 'main-m.timer' --now

[Unit]
Description=Joomla Maintenance
After=network-online.target
Wants=network-online.target

[Timer]
OnCalendar=*-*-01 03:30:00
Persistent=true

[Install]
WantedBy=timers.target

# End

sudo systemctl start 'main-m' && sudo systemctl status 'main-m' -l

Backup

Files

sudo tar -czf ~/'joomla-files-manual-'$(date +%Y-%m-%d)'.tar.gz' -C '/srv/www' 'main'

Database

sudo mariadb-dump --single-transaction --quick 'joomla_db' -r ~/'joomla-database-manual-'$(date +%Y-%m-%d)'.sql'

scp

scp espionage724@192.168.1.152:~/'joomla-files-'*'.tar.gz' ~/'Downloads'

scp espionage724@192.168.1.152:~/'joomla-database-'*'.sql' ~/'Downloads'

Restore

scp

scp ~/'Downloads/joomla-files-'*'.tar.gz' espionage724@192.168.1.152:~

scp ~/'Downloads/joomla'*'.sql' espionage724@192.168.1.152:~

Stop nginx

sudo systemctl stop 'nginx'

Remove Existing Files

ls ~/'joomla-files-'*'.tar.gz' && sudo rm -Rf '/srv/www/main'

Restore Files

sudo tar -xzf ~/'joomla-files-'*'.tar.gz' -C '/srv/www' 'main' && sudo chown -R 'wwwrun':'www' '/srv/www/main' && sudo chmod -R '0755' '/srv/www/main'

Restore Database

Initial set-up

sudo mariadb --execute='DROP DATABASE joomla_db;'

sudo mariadb --execute='CREATE DATABASE joomla_db;'

sudo mariadb 'joomla_db' < ~/'joomla'*'.sql'

dos2unix

find '/srv/www/main' -type f -print0 | sudo xargs -0 dos2unix -- && sudo chown -R 'wwwrun':'www' '/srv/www/main' && sudo chmod -R '0755' '/srv/www/main'

MySQL Connection

Windows uses 127.0.0.1
TODO

sudo -e '/srv/www/blog/wp-config.php' && sudo chown -v 'wwwrun':'www' '/srv/www/blog/wp-config.php'

define( 'DB_HOST', 'localhost' );

Start nginx

sudo systemctl start 'nginx'

Clean-up

rm -fv ~/'joomla-files-'*'.tar.gz' ~/'joomla'*'.sql'

Table of Contents

Information

Prerequisites

Dependencies

Download Source

Environment

Composer

Node.js

Databases

nginx + PHP-FPM Configuration

PHP-FPM Socket

FastCGI

Server Block

Initial Setup

Settings

Purity III Template

Install

System Dashboard

Theme Settings

Footer

Copyright

Logo

Text

Custom CSS

Articles

Home

Temp

Offline Message

Menus

Global Configuration

Site Meta Description

Content Rights

Articles

Menu

Services

Updater

Service

Timer

Backup

Files

Service

Timer

Database

Database Auth

Service

Timer

Maintenance

Service

Timer

Backup

Files

Database

scp

Restore

scp

Stop nginx

Remove Existing Files

Restore Files

Restore Database

dos2unix

MySQL Connection

Start nginx

Clean-up