FreshRSS Howto (1)

This howto is based on the following documentation:

Installation

Install FreshRSS from the repository using Git:

NOTE:

Find the latest tag on GitHub.

mkdir '<HTDOCS>/rss'

cd '<HTDOCS>/rss'

git clone 'https://github.com/FreshRSS/FreshRSS.git' '.'

git checkout 'tags/1.25.0'

Create the needed directories in <HTDOCS>/rss/data:

cd '<HTDOCS>/rss'

./cli/prepare.php

Delete unused directories:

cd '<HTDOCS>/rss'

for dir in 'Docker' 'docs' 'tests'; do
  if [[ -d "${dir}" ]]; then
    rm -r "${dir}"
  fi
done

Ignore the repository's file permissions:

cd '<HTDOCS>/rss'

git config 'core.fileMode' 'false'

Set file permissions:

cd '<HTDOCS>/rss'

sudo chown --recursive 'raysoft:raysoft' '.'

find '.' '(' -type 'd' -execdir chmod -v -v 0755 '{}' '+' ')' \
     -or '(' -type 'f' -execdir chmod -v -v 0644 '{}' '+' ')'

Upgrade

Update FreshRSS:

NOTE:

Find the latest tag on GitHub.

cd '<HTDOCS>/rss'

git fetch

git checkout 'tags/1.25.0'

Delete unused directories:

cd '<HTDOCS>/rss'

for dir in 'Docker' 'docs' 'tests'; do
  if [[ -d "${dir}" ]]; then
    rm -r "${dir}"
  fi
done

Set file permissions:

cd '<HTDOCS>/rss'

sudo chown --recursive 'raysoft:raysoft' '.'

find '.' '(' -type 'd' -execdir chmod -v -v 0755 '{}' '+' ')' \
     -or '(' -type 'f' -execdir chmod -v -v 0644 '{}' '+' ')'

Configuration

Configure FreshRSS

cd '<HTDOCS>/rss'

./cli/do-install.php \
  --default_user 'admin' \
  --auth_type 'form' \
  --environment 'production' \
  --base_url 'https://www.raysoft.ch/rss/p' \
  --language 'en' \
  --title 'FreshRSS' \
  --api_enabled \
  --db-type 'sqlite'

Create the users 'admin' & 'alex'

cd '<HTDOCS>/rss'

./cli/create-user.php \
  --user 'admin' \
  --password 'XXXXXXXXXX' \
  --language 'en' \
  --email 'admin@raysoft.ch' \
  --no_default_feeds

./cli/create-user.php \
  --user 'alex' \
  --password 'XXXXXXXXXX' \
  --api_password 'XXXXXXXXXX' \
  --language 'en' \
  --email 'alex@raysoft.ch' \
  --no_default_feeds

Configure cron jobs:

crontab -e

*/10 * * * * /usr/local/bin/php ${HOME}/www/raysoft/rss/app/actualize_script.php

30 1 1 * *   /usr/local/bin/php ${HOME}/www/raysoft/rss/cli/db-optimize.php --user 'alex'