devel/phabricator 20211218_5 DragonFly

Configuration

No options to configure.

Service scripts

none

Flavors

phabricator-php82-20211218_5, phabricator-php83-20211218_5, phabricator-php84-20211218_5

Message after installing

Make sure to run phabricator using a production PHP configuration,
e.g., %%PREFIX/etc/php.ini-production, particularly
using the recommended error_reporting setting for production:

  error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT

To run the phabricator daemons from startup, add phd_enable="YES"
to /etc/rc.conf. You can control the daemons using

service phd start
service phd stop
etc.

Before starting the daemons, please finish configuring your Phabricator
instance. This involves configuring a web server (Apache, NGINX, LightHTTP)
and a database server (MySQL, MariaDB). You can find detailed instructions
on how to finish your setup at:

https://secure.phabricator.com/book/phabricator/article/configuration_guide/

Please note that all files are located in /usr/local/lib/php/phabricator,
so if the documentation refers to ./bin, this means

  /usr/local/lib/php/phabricator/bin,

if it refers to webroot, this means

  /usr/local/lib/php/phabricator/webroot.

You might want to install textproc/py-pygments to improve syntax
highlighting.

Starting with version 20170630, phabricator daemons run as user www
by default. If you're updating from a version before 20170630 you will need
to fix permissions of /var/tmp/phd and repositories. Alternatively
you can continue to run phabricator daemons as root by adding
phd_user="root" to /etc/rc.conf.

Phabricator daemons and ssh-git requires setting up sudo, see

  /usr/locallib/php/phabricator/resources/sshd/phabricator-sudoers.sample

for an example.

A phabricator example configuration installed here:

  /usr/locallib/php/phabricator/conf/local/local.json.sample

If you want to access phabricator hosted git repositories via git,
you can add the following configuration snippet to /etc/sshd_config
and reload sshd afterwards (`service sshd reload'):

========================================================================
Match User git
 AllowUsers git
 AuthorizedKeysCommand /usr/local/lib/php/phabricator/resources/sshd/phabricator-ssh-hook.sh
 AuthorizedKeysCommandUser git
 AuthorizedKeysFile none
 AuthenticationMethods publickey
 PermitRootLogin no
 PasswordAuthentication no
 PermitTTY no
 AllowAgentForwarding no
 AllowTcpForwarding no
 GatewayPorts no
 PermitOpen none
 PermitTunnel no
 X11Forwarding no
========================================================================

Don't forget to update the database schema after update:

  service nginx stop
  service php-fpm stop
  service phd stop
  cd /usr/local/lib/php/phabricator
  ./bin/storage upgrade
  service phd start
  service php-fpm start
  service nginx start

The above procedure is for users of nginx and php-fpm, please adapt
accordingly to match your setup.

If your configuration uses an unprivileged user to connect to the database,
you may have to override the default user so the schema changes can be
applied with root or some other admin user:

  ./bin/storage upgrade --user <user> --password <password>