servers:linux:nginx:joomla
This is an old revision of the document!
Table of Contents
Information
Prerequisites
Dependencies
sudo apt install composer nodejs npm php-xml php-gd php-mysql php-mbstring php-mcrypt php-curl php-intl php-json php-ldap
Download Source
sudo git clone --branch '6.1-dev' --depth '1' --recurse-submodules 'https://github.com/joomla/joomla-cms.git' '/var/www/main' && sudo chown -R 'www-data':'www-data' '/var/www/main' && sudo chmod -R '0755' '/var/www/main'
Environment
Composer
sudo su 'www-data' -s '/bin/bash'
cd '/tmp' && composer --working-dir='/var/www/main' --no-cache install --no-dev
Node.js
sudo su 'www-data' -s '/bin/bash'
cd '/tmp' && CYPRESS_CACHE_FOLDER='/var/www/main' '/usr/bin/node' '/usr/share/nodejs/npm/bin/npm-cli.js' --prefix '/var/www/main' ci --cache '/var/www/main' --force --verbose
exit
Database
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/php/8.4/fpm/pool.d/main.conf' && sudo systemctl restart 'php8.4-fpm'
[main] ; User/Group user = "www-data" group = "www-data" ; Socket listen = "/run/php/main.sock" listen.owner = "www-data" listen.group = "www-data" listen.mode = "0662" ; Process Management pm = "ondemand" pm.max_children = "4" pm.process_idle_timeout = "30" ; Logging php_value[log_errors] = "0" php_value[error_reporting] = "~E_ALL" ; General php_value[date.timezone] = "America/New_York" ; End
FastCGI
sudo -e '/etc/nginx/snippets/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_param 'HTTPS' 'on';
fastcgi_pass 'unix:/run/php/main.sock';
}
# End
Server Block
sudo -e '/etc/nginx/sites-available/main.conf'
server {
listen '443' 'ssl';
http2 'on';
server_name 'realmofespionage.xyz';
root '/var/www/main';
index 'index.php';
include '/etc/nginx/snippets/main.conf';
include '/etc/nginx/snippets/headers.conf';
# 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
sudo ln -s -f '/etc/nginx/sites-available/main.conf' '/etc/nginx/sites-enabled/main.conf' && sudo systemctl reload 'nginx'
Initial Setup
- Disable Automated Updates
Don't remove installation folder
Compat Extension Fix
sudo rm -fv '/var/www/main/administrator/cache/autoload_psr4.php'
Settings
System Dashboard
- Templates → Site Template Styles
- Set
purity_III - Defaultto Default
Theme Settings
Footer
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 theBootstrap by TwitterandFont Awesomementions - Remove
Bootstrap by TwitterandFont Awesomementions
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>
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
Menu
- 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=www-data Group=www-data Type=oneshot WorkingDirectory=/var/www/main Environment="CYPRESS_CACHE_FOLDER='/var/www/main'" ExecStart='/usr/bin/git' -C '/var/www/main' reset --hard 'origin/6.1-dev' ExecStart='/usr/bin/git' -C '/var/www/main' pull origin '6.1-dev' --rebase ExecStart='/usr/bin/composer' --working-dir='/var/www/main' --no-cache install --no-dev ExecStart='/usr/bin/node' '/usr/share/nodejs/npm/bin/npm-cli.js' --prefix '/var/www/main' ci --cache '/var/www/main' --force --logs-max='0' ExecStartPost='/usr/bin/sync' # End
Timer
- Daily
03:00:00 AM
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 WorkingDirectory=/var/www/main ExecStart='/usr/bin/bash' -c '"/usr/bin/tar" -czf "/home/CHANGEME/backups/joomla-files-auto-"$$(date +%%Y-%%m-%%d)".tar.gz" -C "/var/www" "main"' ExecStartPost='/usr/bin/sync' # End
Timer
- Monthly (4th)
03:15:00 AM
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=*-*-04 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 WorkingDirectory=/var/lib/mysql 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
- Monthly (4th)
03:10:00 AM
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=*-*-04 03:10:00 Persistent=true [Install] WantedBy=timers.target # End
Maintenance
Service
sudo -e '/etc/systemd/system/main-m.service'
[Service] User=www-data Group=www-data Type=oneshot WorkingDirectory=/var/www/main ExecStart='/usr/bin/git' -C '/var/www/main' gc --aggressive --prune='all' ExecStart='/usr/bin/git' -C '/var/www/main' fsck --full --strict ExecStartPost='/usr/bin/sync' # End
Timer
- Monthly (4th)
03:30:00 AM
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=*-*-04 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 '/var/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 '/var/www/main'
Restore Files
sudo tar -xzf ~/'joomla-files-'*'.tar.gz' -C '/var/www' 'main' && sudo chown -R 'www-data':'www-data' '/var/www/main' && sudo chmod -R '0755' '/var/www/main'
Git Fix
Set email for
user.email
sudo su 'www-data' -s '/bin/bash'
rm -Rf '/var/www/main/.git'
git -C '/var/www/main' init --initial-branch='6.1-dev'
git -C '/var/www/main' add '.'
git -C '/var/www/main' config 'user.email' 'espionage724@x'
git -C '/var/www/main' commit --message='x'
git -C '/var/www/main' remote add 'origin' 'https://github.com/joomla/joomla-cms.git'
git -C '/var/www/main' pull --depth '1' --recurse-submodules 'origin' '6.1-dev' --rebase
git -C '/var/www/main' reset --hard 'origin/6.1-dev'
git -C '/var/www/main' gc --aggressive --prune='all'
git -C '/var/www/main' fsck --full --strict
exit
Restore Database
sudo mariadb --execute='DROP DATABASE joomla_db;'
sudo mariadb --execute='CREATE DATABASE joomla_db;'
sudo mariadb 'joomla_db' < ~/'joomla'*'.sql'
Start nginx
sudo systemctl start 'nginx'
Clean-up
rm -fv ~/'joomla-files-'*'.tar.gz' ~/'joomla'*'.sql'
/var/www/wiki/data/attic/servers/linux/nginx/joomla.1766405023.txt.gz · Last modified: by Sean Rhone
