mirror of
https://git.freebsd.org/ports.git
synced 2025-05-31 02:16:27 -04:00
9ef2994967
Also depend on a version of arcanist-lib that suppresses "string is NULL" deprecation errors. While there, move the only external patch from github into files (makes using `make makepatch` less error-prone).
98 lines
3 KiB
Text
98 lines
3 KiB
Text
[
|
|
{ type: install
|
|
message: <<EOM
|
|
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 %%PREFIX%%/lib/php/phabricator,
|
|
so if the documentation refers to ./bin, this means
|
|
|
|
%%PREFIX%%/lib/php/phabricator/bin,
|
|
|
|
if it refers to webroot, this means
|
|
|
|
%%PREFIX%%/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
|
|
|
|
%%PREFIX%%lib/php/phabricator/resources/sshd/phabricator-sudoers.sample
|
|
|
|
for an example.
|
|
|
|
A phabricator example configuration installed here:
|
|
|
|
%%PREFIX%%lib/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 %%PREFIX%%/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
|
|
========================================================================
|
|
EOM
|
|
},
|
|
{ type: upgrade
|
|
message: <<EOM
|
|
Don't forget to update the database schema after update:
|
|
|
|
service nginx stop
|
|
service php-fpm stop
|
|
service phd stop
|
|
cd %%PREFIX%%/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>
|
|
EOM
|
|
}
|
|
]
|