| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| servers:bsd:nginx:dokuwiki [2025/05/24 05:14] – Sean Rhone | servers:bsd:nginx:dokuwiki [2025/09/11 06:43] (current) – external edit 127.0.0.1 |
|---|
| ===== Prerequisites ===== | ===== Prerequisites ===== |
| |
| * [[bsd:server:freebsd_14.2|FreeBSD 14.2]] | * [[bsd:server:freebsd_14.3|FreeBSD 14.3]] |
| * [[servers:bsd:nginx_php_php-fpm|nginx + PHP + PHP-FPM]] | * [[servers:bsd:nginx_php_php-fpm|nginx + PHP + PHP-FPM]] |
| * [[servers:bsd:nginx:lets_encrypt|Let's Encrypt]] | * [[servers:bsd:nginx:lets_encrypt|Let's Encrypt]] |
| su - | su - |
| |
| git clone --branch 'master' --depth '1' --recurse-submodules 'https://github.com/splitbrain/dokuwiki.git' '/usr/local/www/wiki' && chown -R 'www':'www' '/usr/local/www/wiki' && sync | git clone --branch 'master' --depth '1' --recurse-submodules 'https://github.com/splitbrain/dokuwiki.git' '/usr/local/www/wiki' && chown -R 'www':'www' '/usr/local/www/wiki' |
| |
| ====== nginx + PHP-FPM Configuration ====== | ====== nginx + PHP-FPM Configuration ====== |
| su - | su - |
| |
| ee '/usr/local/etc/php-fpm.d/wiki.conf' && service 'php_fpm' restart | ee '/usr/local/etc/php-fpm.d/wiki.conf' && service 'php_fpm' reload |
| |
| <code> | <code> |
| |
| <code> | <code> |
| # PHP-FPM | |
| location ~ \.(php|phar)(/.*)?$ { | location ~ \.(php|phar)(/.*)?$ { |
| fastcgi_split_path_info ^(.+\.(?:php|phar))(/.*)$; | fastcgi_split_path_info ^(.+\.(?:php|phar))(/.*)$; |
| su - | su - |
| |
| ee '/usr/local/etc/nginx/vhosts.d/wiki.conf' && service 'nginx' reload && sync | ee '/usr/local/etc/nginx/vhosts.d/wiki.conf' && service 'nginx' reload |
| |
| <code> | <code> |
| server { | server { |
| listen '443' 'ssl'; | listen '443' 'ssl'; |
| # http2 'on'; | http2 'on'; |
| server_name 'wiki.realmofespionage.xyz'; | server_name 'wiki.realmofespionage.xyz'; |
| root '/usr/local/www/wiki'; | root '/usr/local/www/wiki'; |
| * Do after initial setup | * Do after initial setup |
| |
| sudo -e '/etc/nginx/vhosts.d/wiki.conf' && sudo systemctl reload 'nginx' | su - |
| | |
| | ee '/usr/local/etc/nginx/vhosts.d/wiki.conf' && service 'nginx' reload |
| |
| ===== URL Rewrite ===== | ===== URL Rewrite ===== |
| |
| * This prevents -- from becoming a – (long hyphen), which breaks some command's syntax | * This prevents -- from becoming a – (long hyphen), which breaks some command's syntax |
| | * :!: TODO: FreeBSD |
| |
| echo '-- --' | sudo tee '/var/www/wiki/conf/entities.local.conf' > '/dev/null' && sudo chown 'nginx':'nginx' '/var/www/wiki/conf/entities.local.conf' && sync | echo '-- --' | sudo tee '/var/www/wiki/conf/entities.local.conf' > '/dev/null' && sudo chown 'nginx':'nginx' '/var/www/wiki/conf/entities.local.conf' && sync |
| su -m 'www' -c "cd '/usr/local/www/wiki' && '/usr/local/www/wiki/bin/indexer.php' --clear" | su -m 'www' -c "cd '/usr/local/www/wiki' && '/usr/local/www/wiki/bin/indexer.php' --clear" |
| |
| ===== Etc ===== | ===== Maintenance ===== |
| |
| su - | su - |
| ====== Backup ====== | ====== Backup ====== |
| |
| ===== Server ===== | ===== Folder ===== |
| | |
| ==== Archive Folders ==== | |
| |
| su - | su - |
| |
| cd '/usr/local/www/wiki' && tar -cvzf '/home/espionage724/dokuwiki-files-manual-'$(date +%Y-%m-%d)'.tar.gz' 'data/pages' 'data/meta' 'data/media' 'data/media_meta' 'data/attic' 'data/media_attic' 'conf' && sync | tar -czf '/home/espionage724/dokuwiki-files-manual-'$(date +%Y-%m-%d)'.tar.gz' -C '/usr/local/www/wiki' 'data/pages' 'data/meta' 'data/media' 'data/media_meta' 'data/attic' 'data/media_attic' 'conf' |
| |
| ===== Client ===== | ===== scp ===== |
| | |
| ==== Transfer Archive to Client ==== | |
| |
| **** | **** |
| |
| scp espionage724@192.168.1.152:~/'dokuwiki-files-'*'.tar.gz' ~/'Downloads' && sync | scp espionage724@192.168.1.152:~/'dokuwiki-files-'*'.tar.gz' ~/'Downloads' |
| |
| ====== Restore ====== | ====== Restore ====== |
| |
| ===== Client ===== | ===== scp ===== |
| | |
| ==== Transfer Archive to Server ==== | |
| |
| **** | **** |
| scp ~/'Downloads/dokuwiki-files-'*'.tar.gz' espionage724@192.168.1.152:~ | scp ~/'Downloads/dokuwiki-files-'*'.tar.gz' espionage724@192.168.1.152:~ |
| |
| ==== Remove Archive ==== | ===== Folder ===== |
| | |
| **** | |
| | |
| rm ~/'Downloads/dokuwiki-files-'*'.tar.gz' && sync | |
| | |
| ===== Server ===== | |
| | |
| ==== Stop nginx ==== | |
| |
| su - | su - |
| |
| service 'nginx' stop | ls '/home/espionage724/dokuwiki-files-'*'.tar.gz' && rm -Rf '/usr/local/www/wiki/data/pages' '/usr/local/www/wiki/data/meta' '/usr/local/www/wiki/data/media' '/usr/local/www/wiki/data/media_meta' '/usr/local/www/wiki/data/attic' '/usr/local/www/wiki/data/media_attic' '/usr/local/www/wiki/conf' |
| | |
| ==== Remove Previous Folders ==== | |
| | |
| su - | |
| | |
| ls '/home/'*'/dokuwiki-files-'*'.tar.gz' && rm -Rf '/usr/local/www/wiki/data/pages' '/usr/local/www/wiki/data/meta' '/usr/local/www/wiki/data/media' '/usr/local/www/wiki/data/media_meta' '/usr/local/www/wiki/data/attic' '/usr/local/www/wiki/data/media_attic' '/usr/local/www/wiki/conf' | |
| | |
| ==== Restore Folders ==== | |
| | |
| su - | |
| | |
| cd '/usr/local/www/wiki' && tar -xvzf '/home/'*'/dokuwiki-files-'*'.tar.gz' 'data/pages' 'data/meta' 'data/media' 'data/media_meta' 'data/attic' 'data/media_attic' 'conf' && chown -R 'www':'www' '/usr/local/www/wiki' && cd ~ && sync | |
| | |
| ==== Start nginx ==== | |
| | |
| su - | |
| | |
| service 'nginx' start | |
| | |
| ==== Remove Archive ==== | |
| | |
| * Verify that DokuWiki works before running | |
| |
| rm -R ~/'dokuwiki-files-'*'.tar.gz' && sync | tar -xzf '/home/espionage724/dokuwiki-files-'*'.tar.gz' -C '/usr/local/www/wiki' 'data/pages' 'data/meta' 'data/media' 'data/media_meta' 'data/attic' 'data/media_attic' 'conf' && chown -R 'www':'www' '/usr/local/www/wiki' && sync |
| |
