This is an old revision of the document!

Information

Prerequisites

Dependencies

sudo zypper install php-composer2 php8-curl php-gd php8-gmp php8-pdo php8-mbstring php8-intl php8-mysql php8-zip php8-openssl php8-posix

Download Source

https://github.com/friendica/friendica/commits/develop/

sudo git clone --branch 'develop' --depth '1' --recurse-submodules 'https://github.com/friendica/friendica.git' '/srv/www/social' && sudo chown -R 'wwwrun':'www' '/srv/www/social' && sudo chmod -R '0755' '/srv/www/social'

Addons

https://github.com/friendica/friendica-addons/commits/develop/
Required for composer install even without addons actively used

sudo git clone --branch 'develop' --depth '1' --recurse-submodules 'https://github.com/friendica/friendica-addons.git' '/srv/www/social/addon' && sudo chown -R 'wwwrun':'www' '/srv/www/social/addon' && sudo chmod -R '0755' '/srv/www/social/addon'

Environment

Composer

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

cd '/tmp' && '/usr/bin/composer' --working-dir='/srv/www/social' --no-cache install --no-dev

exit

Database

sudo mariadb

CREATE DATABASE friendica;

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

GRANT ALL PRIVILEGES ON friendica.* to 'friendica'@'localhost';

FLUSH PRIVILEGES;

EXIT

nginx + PHP-FPM Configuration

PHP-FPM Socket

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

[social]

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

; Socket
listen = "/run/php-fpm/social.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[log_errors] = "0"
php_value[error_reporting] = "~E_ALL"
php_value[date.timezone] = "America/New_York"
php_value[max_execution_time] = "200"
php_value[memory_limit] = "512M"
php_value[post_max_size] = "10M"
php_value[upload_max_filesize] = "10M"
php_value[max_file_uploads] = "100"
php_value[register_argc_argv] = "On"

; End

FastCGI

social.sock

sudo -e '/etc/nginx/default.d/social.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/social.sock;
}

# End

Server Block

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

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

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

    client_max_body_size '10M';

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

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

    location ^~ /.well-known/ {
        allow all;
        rewrite ^ /index.php?pagename=$uri;
    }

    location ~* \.(tpl|md|tgz|log|out)$ {
        deny all;
    }

    location ~ /\. {
        deny all;
    }
}

# End

Initial Setup

Initialize

Change --dbpass, and --admin to email

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

cd '/srv/www/social' && '/srv/www/social/bin/console' autoinstall --dbhost 'localhost' --dbport '3365' --dbuser 'friendica' --dbdata 'friendica' --url 'https://social.realmofespionage.xyz' --dbpass 'x' --admin 'x'

Website

https://social.realmofespionage.xyz
Be sure the email matches what was used on the above command

User

x is the nickname chosen at website registration, lower-case

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

cd '/srv/www/social' && '/srv/www/social/bin/console' user password x

Etc

cd '/srv/www/social' && '/usr/bin/php' '/srv/www/social/bin/console.php' -h

cd '/srv/www/social' && '/usr/bin/php' '/srv/www/social/bin/console.php' worker

cd '/srv/www/social' && '/usr/bin/php' '/srv/www/social/bin/console.php' dbstructure update --force

cd '/srv/www/social' && '/usr/bin/php' '/srv/www/social/bin/console.php' dbstructure drop --execute

cd '/srv/www/social' && '/usr/bin/php' '/srv/www/social/bin/console.php' postupdate

cd '/srv/www/social' && '/usr/bin/php' '/srv/www/social/bin/console.php' cache clear

cd '/srv/www/social' && '/usr/bin/php' '/srv/www/social/bin/console.php' clearavatarcache

nano '/srv/www/social/config/local.config.php'

Settings

frio Theme

Navigation bar background color: 3d8bff
Navigation bar icon color: ffffff
Link color: 3d8bff
Set the background color: dedede
Login page background color: 484848

Copy or paste schemestring:

{"nav_bg":"#3d8bff","nav_icon_color":"#ffffff","link_color":"#3d8bff","background_color":"#dedede","background_image":"","contentbg_transp":"100","login_bg_image":"","login_bg_color":"#484848"}

Services

Worker

Service

sudo -e '/etc/systemd/system/social-d.service'

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

WorkingDirectory=/srv/www/social

ExecStart='/usr/bin/php' '/srv/www/social/bin/console.php' worker

ExecStartPost='/usr/bin/sync'

# End

Timer

Every 12 hours

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

[Unit]
Description=Friendica Worker Daemon
After=network-online.target
Wants=network-online.target

[Timer]
OnBootSec=12h
OnUnitActiveSec=12h

[Install]
WantedBy=timers.target

# End

Updater

Service

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

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

WorkingDirectory=/srv/www/social
Environment="COMPOSER_CACHE_DIR=/dev/null"

ExecStart='/usr/bin/git' -C '/srv/www/social' pull origin 'develop'
ExecStart='/usr/bin/git' -C '/srv/www/social/addon' pull origin 'develop'

ExecStart='/usr/bin/composer' --working-dir='/srv/www/social' --no-cache install --no-dev

ExecStart='/usr/bin/php' '/srv/www/social/bin/console.php' dbstructure update --force
ExecStart='/usr/bin/php' '/srv/www/social/bin/console.php' dbstructure drop --execute
ExecStart='/usr/bin/php' '/srv/www/social/bin/console.php' postupdate
ExecStart='/usr/bin/php' '/srv/www/social/bin/console.php' cache clear
ExecStart='/usr/bin/php' '/srv/www/social/bin/console.php' clearavatarcache

ExecStartPost='/usr/bin/sync'

# End

Timer

Every day at 04:00:00

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

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

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

[Install]
WantedBy=timers.target

# End

Maintenance

Service

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

[Service]
User=nginx
Group=nginx
Type=oneshot
ExecStart='/usr/bin/git' -C '/var/www/social' gc --aggressive --prune='all'
ExecStart='/usr/bin/git' -C '/var/www/social' fsck --full --strict
ExecStart='/usr/bin/git' -C '/var/www/social/addon' gc --aggressive --prune='all'
ExecStart='/usr/bin/git' -C '/var/www/social/addon' fsck --full --strict
ExecStartPost='/usr/bin/sync'

Timer

01 day of every month at 03:20:00

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

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

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

[Install]
WantedBy=timers.target

Backup

Files

Service

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

[Service]
Type=oneshot
WorkingDirectory=/var/www
ExecStart='/usr/bin/bash' -c '"/usr/bin/tar" -czf "/home/CHANGEME/backups/friendica-files-auto-"$$(date +%%Y-%%m-%%d)".tar.gz" "social"'
ExecStartPost='/usr/bin/sync'

Timer

01 day of every month at 03:35:00

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

[Unit]
Description=friendica Files Backup

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

[Install]
WantedBy=timers.target

Database

Database Auth

sudo mkdir -p '/var/lib/mysql/auth' && sudo -e '/var/lib/mysql/auth/friendica' && sudo chown -R 'mysql':'mysql' '/var/lib/mysql/auth/friendica' && sudo chmod '600' '/var/lib/mysql/auth/friendica' && sync

[mariadb-dump]
user=friendica
password=x

Service

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

[Service]
Type=oneshot
WorkingDirectory=/var/lib/mysql/tmp
ExecStartPre='/usr/bin/mariadb-dump' --defaults-extra-file='/var/lib/mysql/auth/friendica' --single-transaction 'friendica' -r '/var/lib/mysql/tmp/friendica.sql'
ExecStart='/usr/bin/gzip' -f '/var/lib/mysql/tmp/friendica.sql'
ExecStart='/usr/bin/bash' -c '"/usr/bin/mv" "/var/lib/mysql/tmp/friendica.sql.gz" "/home/CHANGEME/backups/friendica-database-auto-"$$(date +%%Y-%%m-%%d)".sql.gz"'
ExecStartPost='/usr/bin/sync'

Timer

Every day at 03:45:00

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

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

[Timer]
OnCalendar=*-*-* 03:45: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 php-fpm

Backup Folder

cd '/var/www' && sudo tar -cvzf ~/'friendica-files-manual-'$(date +%Y-%m-%d)'.tar.gz' 'social' && cd ~ && sync

Backup Database

sudo mariadb-dump --defaults-extra-file='/var/lib/mysql/auth/friendica' --single-transaction 'friendica' -r ~/'friendica-database-manual-'$(date +%Y-%m-%d)'.sql' && sync

Start Services

sudo systemctl start nginx php-fpm

Client

Transfer Files To Client

scp espionage724@192.168.1.152:~/'friendica-files-'*'.tar.gz' espionage724@192.168.1.152:~/'friendica-database-'*'.sql' ~/'Downloads' && sync

Restore

Client

Uncompress Database

This is only needed if restoring an automated database backup ¹⁾

gunzip ~/'Downloads/friendica-database-'*'.sql.gz'

Transfer Files To Server

scp ~/'Downloads/friendica-files-'*'.tar.gz' ~/'Downloads/friendica-database-'*'.sql' espionage724@192.168.1.152:~

Remove Files

rm -f ~/'Downloads/friendica-files-'*'.tar.gz' ~/'Downloads/friendica-database-'*'.sql' && sync

Server

Stop Services

sudo systemctl stop nginx php-fpm

Remove Previous Folder

sudo rm -Rf '/var/www/social'

Restore Friendica Folder

cd '/var/www' && sudo tar -xvzf ~/'friendica-files-'*'.tar.gz' 'social' && sudo semanage fcontext --add --type 'httpd_sys_rw_content_t' '/var/www/social(/.*)?' && sudo restorecon -F -I -R '/var/www/social' && sudo chown -R 'nginx':'nginx' '/var/www/social' && cd ~ && sync

Drop Previous Database

sudo mariadb

DROP DATABASE friendica;

FLUSH TABLES;

EXIT

Re-create Databases

sudo mariadb

CREATE DATABASE friendica;

EXIT

Restore Database

sudo mariadb 'friendica' < ~/'friendica-database-'*'.sql' && sync

Reapply Permissions

sudo mariadb

GRANT ALL PRIVILEGES ON friendica.* to 'friendica'@'localhost' IDENTIFIED BY 'x';

FLUSH PRIVILEGES;

EXIT

Start Services

sudo systemctl start nginx php-fpm

Remove Backups

Verify that Friendica works before running

rm ~/'friendica-files-'*'.tar.gz' ~/'friendica-database-'*'.sql' && sync

¹⁾

manual doesn't gzip

Table of Contents

Information

Prerequisites

Dependencies

Download Source

Addons

Environment

Composer

Database

nginx + PHP-FPM Configuration

PHP-FPM Socket

FastCGI

Server Block

Initial Setup

Initialize

Website

User

Etc

Settings

frio Theme

Services

Worker

Service

Timer

Updater

Service

Timer

Maintenance

Service

Timer

Backup

Files

Service

Timer

Database

Database Auth

Service

Timer

Backup

Server

Stop Services

Backup Folder

Backup Database

Start Services

Client

Transfer Files To Client

Restore

Client

Uncompress Database

Transfer Files To Server

Remove Files

Server

Stop Services

Remove Previous Folder

Restore Friendica Folder

Drop Previous Database

Re-create Databases

Restore Database

Reapply Permissions

Start Services

Remove Backups