====== Information ====== * Zenphoto ((https://www.zenphoto.org/)) ((https://github.com/zenphoto/zenphoto)) * [[Information:Realm of Espionage]] * https://media.realmofespionage.xyz ===== Prerequisites ===== * [[distros:ubuntu_server|Ubuntu Server]] ((Last tested on 20.04)) * [[servers;linux;mariadb|MariaDB]] * [[servers;linux;nginx_php_php-fpm|nginx + PHP + PHP-FPM]] * [[servers;linux;nginx;lets_encrypt|Let's Encrypt]] ====== Download Source ====== **** sudo rm -Rf '/var/www/media' && sudo git clone --branch 'master' --depth '1' --recurse-submodules 'https://github.com/zenphoto/zenphoto.git' '/var/www/media' && sudo chown -R 'www-data':'www-data' '/var/www/media' && sync ====== Database ====== sudo mysql CREATE DATABASE zenphoto; GRANT ALL PRIVILEGES ON zenphoto.* to 'zenphoto'@'localhost' IDENTIFIED BY 'x'; FLUSH PRIVILEGES; EXIT ====== nginx + PHP-FPM Configuration ====== ===== PHP-FPM Socket ===== sudo -e '/etc/php/7.4/fpm/pool.d/media.conf' && sudo systemctl restart 'php7.4-fpm' [media] user = www-data group = www-data listen = /run/php/media.sock listen.owner = www-data listen.group = www-data listen.allowed_clients = 127.0.0.1 pm = dynamic pm.max_children = 8 pm.start_servers = 3 pm.min_spare_servers = 2 pm.max_spare_servers = 4 php_value[date.timezone] = "America/New_York" php_value[upload_tmp_dir] = "/tmp" php_value[max_execution_time] = "300" php_value[memory_limit] = "512M" php_value[post_max_size] = "500M" php_value[upload_max_filesize] = "500M" php_value[max_file_uploads] = "100" php_value[session.save_handler] = "files" php_value[session.save_path] = "/var/lib/php/sessions" php_value[soap.wsdl_cache_dir] = "/var/lib/php/wsdlcache" php_value[opcache.file_cache] = "/var/lib/php/opcache" ===== FastCGI ===== sudo -e '/etc/nginx/snippets/media.conf' # PHP-FPM 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/media.sock; } ===== Server Block ===== sudo -e '/etc/nginx/sites-available/media.conf' server { listen '443' 'ssl' 'http2'; server_name 'media.realmofespionage.xyz'; root '/var/www/media'; index 'index.php'; include '/etc/nginx/snippets/media.conf'; include '/etc/nginx/snippets/headers.conf'; client_max_body_size '500M'; add_header Content-Security-Policy "default-src 'self'; script-src 'self' 'unsafe-inline' 'unsafe-eval'; style-src 'self' 'unsafe-inline'; img-src 'self' blob:" always; # access_log /var/log/nginx/media-access.log; # error_log /var/log/nginx/media-error.log; location / { try_files $uri $uri/ /index.php?$args; } } ==== Enable ==== **** sudo rm -f '/etc/nginx/sites-enabled/media.conf' && sudo ln -s '/etc/nginx/sites-available/media.conf' '/etc/nginx/sites-enabled/media.conf' && sudo systemctl reload 'nginx' && sync ====== Initial Setup ====== ===== UTF-8 Test ===== * Zenphoto tests for a UTF8-compliant filesystem and expects the following file to exist sudo -u 'www-data' touch '/var/www/media/zp-data/charset_tést' ===== Site ===== * https://media.realmofespionage.xyz ====== Services ====== ===== Updater ===== ==== Service ==== sudo -e '/etc/systemd/system/media-up.service' [Service] User=www-data Group=www-data Type=oneshot WorkingDirectory=/var/www/media ExecStart='/usr/bin/git' -C '/var/www/media' pull origin 'master' ExecStartPost='/bin/sync' ==== Timer ==== * Every day at ''05:00:00'' sudo -e '/etc/systemd/system/media-up.timer' && sudo systemctl daemon-reload && sudo systemctl enable 'media-up.timer' --now && sudo systemctl start 'media-up' && sudo systemctl status 'media-up' -l [Unit] Description=Zenphoto Updater After=network-online.target Wants=network-online.target [Timer] OnCalendar=*-*-* 05:00:00 Persistent=true [Install] WantedBy=timers.target ===== Maintenance ===== ==== Service ==== sudo -e '/etc/systemd/system/media-m.service' [Service] User=www-data Group=www-data Type=oneshot ExecStart='/usr/bin/git' -C '/var/www/media' gc --aggressive --prune='all' ExecStart='/usr/bin/git' -C '/var/www/media' fsck --full --strict ExecStartPost='/bin/sync' ==== Timer ==== * ''01'' day of every month at ''05:20:00'' sudo -e '/etc/systemd/system/media-m.timer' && sudo systemctl daemon-reload && sudo systemctl enable 'media-m.timer' --now [Unit] Description=Zenphoto Maintenance After=network-online.target Wants=network-online.target [Timer] OnCalendar=*-*-01 05:20:00 Persistent=true [Install] WantedBy=timers.target ===== Backup ===== ==== Files ==== === Service === mkdir -p ~/'backups' && sudo -e '/etc/systemd/system/media-fb.service' && sudo sed -i 's/CHANGEME/'$USER'/g' '/etc/systemd/system/media-fb.service' [Service] Type=oneshot WorkingDirectory=/var/www ExecStart='/bin/bash' -c '"/bin/tar" -cvzf "/home/CHANGEME/backups/zenphoto-files-auto-"$$(date +%%Y-%%m-%%d)".tar.gz" "media"' ExecStartPost='/bin/sync' === Timer === * ''01'' day of every month at ''05:50:00'' sudo -e '/etc/systemd/system/media-fb.timer' && sudo systemctl daemon-reload && sudo systemctl enable 'media-fb.timer' --now && sudo systemctl start 'media-fb' && sudo systemctl status 'media-fb' -l [Unit] Description=Zenphoto Files Backup [Timer] OnCalendar=*-*-01 05:50:00 Persistent=true [Install] WantedBy=timers.target ==== Database ==== === Database Auth === sudo -u 'mysql' -e '/var/lib/mysql/auth/zenphoto' && sudo chmod '600' '/var/lib/mysql/auth/zenphoto' [mysqldump] user=zenphoto password=x === Service === mkdir -p ~/'backups' && sudo -u 'mysql' mkdir -p '/var/lib/mysql/tmp' && sudo -e '/etc/systemd/system/media-db.service' && sudo sed -i 's/'CHANGEME'/'$USER'/g' '/etc/systemd/system/media-db.service' [Service] Type=oneshot WorkingDirectory=/var/lib/mysql/tmp ExecStartPre='/usr/bin/mysqldump' --defaults-extra-file='/var/lib/mysql/auth/zenphoto' --single-transaction 'zenphoto' -r '/var/lib/mysql/tmp/zenphoto.sql' ExecStart='/bin/gzip' -f '/var/lib/mysql/tmp/zenphoto.sql' ExecStart='/bin/bash' -c '"/bin/mv" "/var/lib/mysql/tmp/zenphoto.sql.gz" "/home/CHANGEME/backups/zenphoto-database-auto-"$$(date +%%Y-%%m-%%d)".sql.gz"' ExecStartPost='/bin/sync' === Timer === * Every day at ''05:15:00'' sudo -e '/etc/systemd/system/media-db.timer' && sudo systemctl daemon-reload && sudo systemctl enable 'media-db.timer' --now && sudo systemctl start 'media-db' && sudo systemctl status 'media-db' -l [Unit] Description=Zenphoto Database Backup After=mariadb.service [Timer] OnCalendar=*-*-* 05:15:00 Persistent=true [Install] WantedBy=timers.target ====== Backup ====== * Create backup archive on server and transfer to client computer ===== Server ===== ==== Stop Services ==== **** sudo systemctl stop nginx php7.4-fpm ==== Backup Folder ==== **** cd '/var/www' && sudo tar -cvzf ~/'zenphoto-files-manual-'$(date +%Y-%m-%d)'.tar.gz' 'media' && cd ~ && sync ==== Backup Database ==== **** sudo mysqldump --defaults-extra-file='/var/lib/mysql/auth/zenphoto' --single-transaction 'zenphoto' -r ~/'zenphoto-database-manual-'$(date +%Y-%m-%d)'.sql' && sync ==== Start Services ==== **** sudo systemctl start nginx php7.4-fpm ===== Client ===== ==== Transfer Files To Client ==== **** scp espionage724@192.168.1.153:~/'zenphoto-files-'*'.tar.gz' espionage724@192.168.1.153:~/'zenphoto-database-'*'.sql' ~/'Downloads' && sync ====== Restore ====== ===== Client ===== ==== Uncompress Database ==== * This is only needed if restoring an **automated** database backup ((manual doesn't gzip)) gunzip ~/'Downloads/zenphoto-database-'*'.sql.gz' ==== Transfer Files To Server ==== **** scp ~/'Downloads/zenphoto-files-'*'.tar.gz' ~/'Downloads/zenphoto-database-'*'.sql' espionage724@192.168.1.153:~ ==== Remove Files ==== **** rm -f ~/'Downloads/zenphoto-files-'*'.tar.gz' ~/'Downloads/zenphoto-database-'*'.sql' && sync ===== Server ===== ==== Stop Services ==== **** sudo systemctl stop nginx php7.4-fpm ==== Remove Previous Folder ==== **** sudo rm -Rf '/var/www/media' ==== Restore Zenphoto Folder ==== **** cd '/var/www' && sudo tar -xvzf ~/'zenphoto-files-'*'.tar.gz' 'media' && sudo chown -R 'www-data':'www-data' '/var/www/media' && cd ~ && sync ==== Drop Previous Database ==== sudo mysql DROP DATABASE zenphoto; FLUSH TABLES; EXIT ==== Re-create Databases ==== sudo mysql CREATE DATABASE zenphoto; EXIT ==== Restore Database ==== **** sudo mysql 'zenphoto' < ~/'zenphoto-database-'*'.sql' && sync ==== Reapply Permissions ==== sudo mysql GRANT ALL PRIVILEGES ON zenphoto.* to 'zenphoto'@'localhost' IDENTIFIED BY 'x'; FLUSH PRIVILEGES; EXIT ==== Start Services ==== **** sudo systemctl start nginx php7.4-fpm ==== Remove Backups ==== * Verify that Zenphoto works before running rm ~/'zenphoto-files-'*'.tar.gz' ~/'zenphoto-database-'*'.sql' && sync