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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
|
[
{ 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
}
]
|