summaryrefslogtreecommitdiff
path: root/devel/phabricator/files/pkg-message.in
blob: 5c0291d96ac662f35419a0fbca39699fe48b2318 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
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
========================================================================