ports/devel/phabricator/files/pkg-message.in
Michael Gmelin 42ba12da1a Upgrade devel/libphutil, devel/arcanist and devel/phabricator to 20181231
Also incorporate a couple of changes from PR 233183:
- A more complete local.json example configuration
- A more elaborate pkg-message (explain git usage)
- Add sudoers example configuration
- Patch ssh hook and sshd example configuration
2018-12-31 00:13:24 +00:00

72 lines
2.3 KiB
Text

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
Don't forget to update the database schema after update:
service phd stop
cd %%PREFIX%%/lib/php/phabricator
./bin/storage upgrade
service phd start
You also might want to stop the web server while upgrading the database.
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
========================================================================