kennethreitz · December 10, 2021 16:45 · Aug 11, 2017 · Aug 11, 2017 · Aug 11, 2017 · Aug 11, 2017
diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -11,7 +11,7 @@ This is a supplement to the official [Phabricator Installation Guide](https://se
     $ sudo add-apt-repository -y ppa:ondrej/php
     $ sudo apt-get update -y
 
-    $ sudo apt-get install -y php7.1 libapache2-mod-php7.1 php7.1-cli php7.1-common php7.1-mbstring php7.1-gd php7.1-intl php7.1-xml php7.1-mysql php7.1-mcrypt php7.1-zip php7.1-curl
+    $ sudo apt-get install -y php7.1 libapache2-mod-php7.1 php7.1-cli php7.1-common php7.1-mbstring php7.1-gd php7.1-intl php7.1-xml php7.1-mysql php7.1-mcrypt php7.1-zip php7.1-curl php7.1-apcu
 
     $ sudo a2enmod php7.1
 

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -11,7 +11,7 @@ This is a supplement to the official [Phabricator Installation Guide](https://se
     $ sudo add-apt-repository -y ppa:ondrej/php
     $ sudo apt-get update -y
 
-    $ sudo apt-get install -y php7.1 libapache2-mod-php7.1 php7.1-cli php7.1-common php7.1-mbstring php7.1-gd php7.1-intl php7.1-xml php7.1-mysql php7.1-mcrypt php7.1-zip
+    $ sudo apt-get install -y php7.1 libapache2-mod-php7.1 php7.1-cli php7.1-common php7.1-mbstring php7.1-gd php7.1-intl php7.1-xml php7.1-mysql php7.1-mcrypt php7.1-zip php7.1-curl
 
     $ sudo a2enmod php7.1
 

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -15,7 +15,7 @@ This is a supplement to the official [Phabricator Installation Guide](https://se
 
     $ sudo a2enmod php7.1
 
-    # sudo apt install mysql-server
+    $ sudo apt install mysql-server
 
 #### Install bonus packages:
 

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -14,6 +14,8 @@ This is a supplement to the official [Phabricator Installation Guide](https://se
     $ sudo apt-get install -y php7.1 libapache2-mod-php7.1 php7.1-cli php7.1-common php7.1-mbstring php7.1-gd php7.1-intl php7.1-xml php7.1-mysql php7.1-mcrypt php7.1-zip
 
     $ sudo a2enmod php7.1
+
+    # sudo apt install mysql-server
 
 #### Install bonus packages:
 

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -1,5 +1,5 @@
-Phabricator Ubuntu 16.04 Installation Guide
--------------------------------------------
+Phabricator Ubuntu 16.04 Installation Guide (Updated)
+-----------------------------------------------------
 
 This is a supplement to the official [Phabricator Installation Guide](https://secure.phabricator.com/book/phabricator/article/installation_guide/), because their guide will leave you with all kinds of permission and config errors and ~15,000 setup issues on startup.
 

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -12,6 +12,8 @@ This is a supplement to the official [Phabricator Installation Guide](https://se
     $ sudo apt-get update -y
 
     $ sudo apt-get install -y php7.1 libapache2-mod-php7.1 php7.1-cli php7.1-common php7.1-mbstring php7.1-gd php7.1-intl php7.1-xml php7.1-mysql php7.1-mcrypt php7.1-zip
+
+    $ sudo a2enmod php7.1
 
 #### Install bonus packages:
 

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -3,6 +3,16 @@ Phabricator Ubuntu 16.04 Installation Guide
 
 This is a supplement to the official [Phabricator Installation Guide](https://secure.phabricator.com/book/phabricator/article/installation_guide/), because their guide will leave you with all kinds of permission and config errors and ~15,000 setup issues on startup.
 
+#### Install Apache and php7.1
+
+    $ apt install apache2
+
+    $ sudo apt-get install -y python-software-properties
+    $ sudo add-apt-repository -y ppa:ondrej/php
+    $ sudo apt-get update -y
+
+    $ sudo apt-get install -y php7.1 libapache2-mod-php7.1 php7.1-cli php7.1-common php7.1-mbstring php7.1-gd php7.1-intl php7.1-xml php7.1-mysql php7.1-mcrypt php7.1-zip
+
 #### Install bonus packages:
 
     $ apt-get install mercurial subversion python-pygments sendmail imagemagick

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -5,25 +5,25 @@ This is a supplement to the official [Phabricator Installation Guide](https://se
 
 #### Install bonus packages:
 
-    # apt-get install mercurial subversion python-pygments sendmail imagemagick
+    $ apt-get install mercurial subversion python-pygments sendmail imagemagick
 
 #### Create necessary users and add phd-user to sudoers:
 
-    # adduser phd --home /home/phd
-    # adduser phd sudo
-    # adduser git
+    $ adduser phd --home /home/phd
+    $ adduser phd sudo
+    $ adduser git
 
 And create repo directory if phabricator will be hosting repos:
 
-    # mkdir /var/repo
-    # chown -R phd /var/repo
-    # chgrp -R phd /var/repo
+    $ mkdir /var/repo
+    $ chown -R phd /var/repo
+    $ chgrp -R phd /var/repo
 
 #### Install phabricator:
 
     su phd
     cd /home/phd
-    wget http://www.phabricator.com/rsrc/install/install_ubuntu.sh
+    wget https://p.phcdn.net/file/data/@secure/jgjyrauu6suiajiywmi5/PHID-FILE-ntsbjlxyz6dafmofgirl/install_ubuntu.sh
     bash install_ubuntu.sh
 
 #### Recommended Phabricator Configurations to set:

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -1,5 +1,5 @@
-Phabricator Ubuntu Installation Guide
--------------------------------------
+Phabricator Ubuntu 16.04 Installation Guide
+-------------------------------------------
 
 This is a supplement to the official [Phabricator Installation Guide](https://secure.phabricator.com/book/phabricator/article/installation_guide/), because their guide will leave you with all kinds of permission and config errors and ~15,000 setup issues on startup.
 

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -228,6 +228,6 @@ And get output like this:
 
 #### Refer to the phabricator configuration guide for next steps:
 
-At this point, you should be able to host and clone repositories via HTTP & SSH. Refer the the [Diffusion Hosting Configuration Guide](https://secure.phabricator.com/book/phabricator/article/diffusion_hosting/) for trouble-shooting.
+At this point, you should be able to host and clone repositories via HTTP & SSH. Refer to the [Diffusion Hosting Configuration Guide](https://secure.phabricator.com/book/phabricator/article/diffusion_hosting/) for trouble-shooting.
 
 Also see the official [Phabricator Configuration Guide](https://secure.phabricator.com/book/phabricator/article/configuration_guide/) for additional advanced configuration steps.
diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -187,7 +187,7 @@ Then restart apache
 
 #### Enable ssh clone & push
 
-Change default ssh port to something other than port 22
+Change default ssh port to something other than port 22 (I like to use 2222)
 
 ```bash
 # edit Port setting here

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -187,6 +187,15 @@ Then restart apache
 
 #### Enable ssh clone & push
 
+Change default ssh port to something other than port 22
+
+```bash
+# edit Port setting here
+vim /etc/ssh/sshd_config
+# restart sshd service
+service sshd restart
+```
+
 Make executable ssh hook for phabricator ssh daemon
 
 ```bash

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -211,8 +211,8 @@ vim /etc/ssh/sshd_config.phabricator
 
 Now you should be able to run this command:
 
-    echo {} | ssh vcs-user@phabricator.yourcompany.com conduit conduit.ping
-    
+    echo {} | ssh git@phabricator.mydomain.net conduit conduit.ping
+
 And get output like this:
 
     {"result":"orbital","error_code":null,"error_info":null}

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -187,6 +187,8 @@ Then restart apache
 
 #### Enable ssh clone & push
 
+Make executable ssh hook for phabricator ssh daemon
+
 ```bash
 # copy ssh hook to executable location
 cp /home/phd/phabricator/resources/sshd/phabricator-ssh-hook.sh /usr/lib/phabricator-ssh-hook.sh
@@ -196,6 +198,8 @@ chmod 755 /usr/lib/phabricator-ssh-hook.sh
 vim /usr/lib/phabricator-ssh-hook.sh
 ```
 
+Create phabricator ssh daemon on port 22
+
 ```bash
 # Copy the examply sshd config
 cp /home/phd/phabricator/resources/sshd/sshd_config.phabricator.example /etc/ssh/sshd_config.phabricator

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -205,8 +205,16 @@ vim /etc/ssh/sshd_config.phabricator
 /usr/sbin/sshd -f /etc/ssh/sshd_config.phabricator
 ```
 
+Now you should be able to run this command:
+
+    echo {} | ssh [email protected] conduit conduit.ping
+
+And get output like this:
+
+    {"result":"orbital","error_code":null,"error_info":null}
+
 #### Refer to the phabricator configuration guide for next steps:
 
-At this point, you should be able to host and clone repositories via HTTP. Refer the the [Diffusion Hosting Configuration Guide](https://secure.phabricator.com/book/phabricator/article/diffusion_hosting/) to setup ssh repo access.
+At this point, you should be able to host and clone repositories via HTTP & SSH. Refer the the [Diffusion Hosting Configuration Guide](https://secure.phabricator.com/book/phabricator/article/diffusion_hosting/) for trouble-shooting.
 
 Also see the official [Phabricator Configuration Guide](https://secure.phabricator.com/book/phabricator/article/configuration_guide/) for additional advanced configuration steps.
diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -185,9 +185,25 @@ Then restart apache
 
     ./bin/phd restart
 
-#### Get the phabricator update script:
+#### Enable ssh clone & push
 
-    wget http://www.phabricator.com/rsrc/install/update_phabricator.sh
+```bash
+# copy ssh hook to executable location
+cp /home/phd/phabricator/resources/sshd/phabricator-ssh-hook.sh /usr/lib/phabricator-ssh-hook.sh
+chown root /usr/lib/phabricator-ssh-hook.sh
+chmod 755 /usr/lib/phabricator-ssh-hook.sh
+# Modify hook to match your system (hint: vcs-user == git)
+vim /usr/lib/phabricator-ssh-hook.sh
+```
+
+```bash
+# Copy the examply sshd config
+cp /home/phd/phabricator/resources/sshd/sshd_config.phabricator.example /etc/ssh/sshd_config.phabricator
+# Edit AuthorizedKeysCommand, AuthorizedKeysCommandUser, and AllowUsers
+vim /etc/ssh/sshd_config.phabricator
+# Start the phabricator sshd
+/usr/sbin/sshd -f /etc/ssh/sshd_config.phabricator
+```
 
 #### Refer to the phabricator configuration guide for next steps:
 

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -147,22 +147,24 @@ Make sure `mod_php` and `mod_rewrite` are enabled, and `mod_ssl` if you intend t
     # a2ensite phabricator
     # service apache2 restart
 
-#### Add these lines to /etc/mysql/my.cnf under the [mysqld] heading:
+#### Configure mysql and storage:
+
+Add these new lines to /etc/mysql/my.cnf under the [mysqld] heading:
 
     sql_mode=STRICT_ALL_TABLES
     ft_boolean_syntax=' |-><()~*:""&^'
     ft_stopword_file=/home/phd/phabricator/resources/sql/stopwords.txt
     ft_min_word_len=3
 
-This line should be about 40% of the memory of the box:
+This new line should be about 40% of the memory of the box:
 
     innodb_buffer_pool_size=800M
 
 And also adjust max_allowed_packet to 32M (this line will already exist)
 
     max_allowed_packet      = 32M
 
-#### Restart mysql and run phabricator storage upgrade:
+Restart mysql and run phabricator storage upgrade:
 
     service restart mysql
     ./bin/storage upgrade

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -162,7 +162,7 @@ And also adjust max_allowed_packet to 32M (this line will already exist)
 
     max_allowed_packet      = 32M
 
-#### Restart `mysql` and run phabricator storage upgrade:
+#### Restart mysql and run phabricator storage upgrade:
 
     service restart mysql
     ./bin/storage upgrade

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -167,6 +167,18 @@ And also adjust max_allowed_packet to 32M (this line will already exist)
     service restart mysql
     ./bin/storage upgrade
 
+#### Configure php:
+
+Adjust the following fields in `/etc/php5/apache2/php.ini`
+
+    post_max_size = 8M
+    date.timezone = Etc/UTC
+    opcache.validate_timestamps=0
+
+Then restart apache
+
+    service apache2 restart
+
 #### Restart phd daemons:
 
     ./bin/phd restart

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -164,7 +164,7 @@ And also adjust max_allowed_packet to 32M (this line will already exist)
 
 #### Restart `mysql` and run phabricator storage upgrade:
 
-    # service restart mysql
+    service restart mysql
     ./bin/storage upgrade
 
 #### Restart phd daemons:

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -154,11 +154,11 @@ Make sure `mod_php` and `mod_rewrite` are enabled, and `mod_ssl` if you intend t
     ft_stopword_file=/home/phd/phabricator/resources/sql/stopwords.txt
     ft_min_word_len=3
 
-This should be about 40% of the memory of the box:
+This line should be about 40% of the memory of the box:
 
     innodb_buffer_pool_size=800M
 
-And also adjust max_allowed_packet to 32M
+And also adjust max_allowed_packet to 32M (this line will already exist)
 
     max_allowed_packet      = 32M
 

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -153,18 +153,25 @@ Make sure `mod_php` and `mod_rewrite` are enabled, and `mod_ssl` if you intend t
     ft_boolean_syntax=' |-><()~*:""&^'
     ft_stopword_file=/home/phd/phabricator/resources/sql/stopwords.txt
     ft_min_word_len=3
+
+This should be about 40% of the memory of the box:
 
-#### Wrap-up:
+    innodb_buffer_pool_size=800M
+
+And also adjust max_allowed_packet to 32M
 
-##### Configure MySQL
+    max_allowed_packet      = 32M
 
+#### Restart `mysql` and run phabricator storage upgrade:
+
+    # service restart mysql
     ./bin/storage upgrade
 
-##### Restart phd daemons (This must work for phd user):
+#### Restart phd daemons:
 
     ./bin/phd restart
 
-##### Get the phabricator update script:
+#### Get the phabricator update script:
 
     wget http://www.phabricator.com/rsrc/install/update_phabricator.sh
 

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -154,25 +154,17 @@ Make sure `mod_php` and `mod_rewrite` are enabled, and `mod_ssl` if you intend t
     ft_stopword_file=/home/phd/phabricator/resources/sql/stopwords.txt
     ft_min_word_len=3
 
-#### All phabricator directories should be owned by the phd user:
+#### Wrap-up:
 
-    root@bdr-gerrit-01:/home/phd# ls -l /home/phd
-    total 20
-    drwxr-xr-x  8 phd phd 4096 Jun 19 19:19 arcanist
-    -rw-r--r--  1 phd phd 2052 Jun 19 19:18 install_ubuntu.sh
-    drwxr-xr-x  8 phd phd 4096 Jun 19 19:19 libphutil
-    drwxr-xr-x 12 phd phd 4096 Jun 23 20:10 phabricator
-    drwxrwxrwx 69 phd phd 4096 Jun 24 18:58 phabricator-files
-
-#### Configure MySQL
+##### Configure MySQL
 
     ./bin/storage upgrade
 
-#### Restart phd daemons (This must work for phd user):
+##### Restart phd daemons (This must work for phd user):
 
     ./bin/phd restart
 
-#### Get the phabricator update script:
+##### Get the phabricator update script:
 
     wget http://www.phabricator.com/rsrc/install/update_phabricator.sh
 

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -178,6 +178,6 @@ Make sure `mod_php` and `mod_rewrite` are enabled, and `mod_ssl` if you intend t
 
 #### Refer to the phabricator configuration guide for next steps:
 
-At this point, you should be able to host and clone repositories via HTTP. Refer the the [Diffusion Hosting Configuration Guide](https://secure.phabricator.com/book/phabricator/article/diffusion_hosting/) to setup ssh repo hosting.
+At this point, you should be able to host and clone repositories via HTTP. Refer the the [Diffusion Hosting Configuration Guide](https://secure.phabricator.com/book/phabricator/article/diffusion_hosting/) to setup ssh repo access.
 
-Also see [General Phabricator Configuration Guide](https://secure.phabricator.com/book/phabricator/article/configuration_guide/) for additional advanced configuration steps.
+Also see the official [Phabricator Configuration Guide](https://secure.phabricator.com/book/phabricator/article/configuration_guide/) for additional advanced configuration steps.
diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -1,7 +1,7 @@
 Phabricator Ubuntu Installation Guide
 -------------------------------------
 
-This is a supplement to the [official Phabricator Installation Guide](https://secure.phabricator.com/book/phabricator/article/installation_guide/), because their guide will leave you with all kinds of permission and config errors and ~15,000 setup issues on startup.
+This is a supplement to the official [Phabricator Installation Guide](https://secure.phabricator.com/book/phabricator/article/installation_guide/), because their guide will leave you with all kinds of permission and config errors and ~15,000 setup issues on startup.
 
 #### Install bonus packages:
 

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -178,8 +178,6 @@ Make sure `mod_php` and `mod_rewrite` are enabled, and `mod_ssl` if you intend t
 
 #### Refer to the phabricator configuration guide for next steps:
 
-General configuration:
-<https://secure.phabricator.com/book/phabricator/article/configuration_guide/>
+At this point, you should be able to host and clone repositories via HTTP. Refer the the [Diffusion Hosting Configuration Guide](https://secure.phabricator.com/book/phabricator/article/diffusion_hosting/) to setup ssh repo hosting.
 
-Repository hosting configuration:
-<https://secure.phabricator.com/book/phabricator/article/diffusion_hosting/>
+Also see [General Phabricator Configuration Guide](https://secure.phabricator.com/book/phabricator/article/configuration_guide/) for additional advanced configuration steps.
diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -33,7 +33,7 @@ cd /home/phd/phabricator
 
 # Generally acceptable settings:
 ./bin/config set mysql.pass <MYSQL_ROOT_PASSWD>
-./bin/config set phabricator.base-uri 'http://phabricator.eng.mydomain.net/'
+./bin/config set phabricator.base-uri 'http://phabricator.mydomain.net/'
 ./bin/config set phd.user phd
 ./bin/config set environment.append-paths '["/usr/lib/git-core"]'
 ./bin/config set diffusion.ssh-user git
@@ -77,8 +77,8 @@ then setup apache configuration file (see examples below) and enable phabricator
             # match this virtual host. For the default virtual host (this file) this
             # value is not decisive as it is used as a last resort host regardless.
             # However, you must set it for any further virtual host explicitly.
-            ServerName phabricator.eng.mydomain.net
-            ServerAlias phabricator.eng.mydomain.net
+            ServerName phabricator.mydomain.net
+            ServerAlias phabricator.mydomain.net
             ServerAdmin [email protected]
 
             DocumentRoot /home/phd/phabricator/webroot

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -5,11 +5,11 @@ This is a supplement to the [official Phabricator Installation Guide](https://se
 
 #### Install bonus packages:
 
-    # apt-get install mercurial subversion zsh python-pygments sendmail imagemagick
+    # apt-get install mercurial subversion python-pygments sendmail imagemagick
 
 #### Create necessary users and add phd-user to sudoers:
 
-    # adduser phd --home /home/phd --shell /usr/bin/zsh
+    # adduser phd --home /home/phd
     # adduser phd sudo
     # adduser git
 

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -141,6 +141,8 @@ And here is an example of an HTTPS-enabled phabricator conf:
             </VirtualHost>
     </IfModule>
 
+Make sure `mod_php` and `mod_rewrite` are enabled, and `mod_ssl` if you intend to set up SSL
+
     # a2dissite 000-default
     # a2ensite phabricator
     # service apache2 restart

diff --git a/phabricator_readme.md b/phabricator_readme.md
@@ -129,13 +129,13 @@ And here is an example of an HTTPS-enabled phabricator conf:
                     # out from GitHub when following the Installation Guide.
                     #
                     # Make sure you include "/webroot" at the end!
-                    DocumentRoot /etc/phabricator/webroot
+                    DocumentRoot /home/phd/phabricator/webroot
 
                     RewriteEngine on
                     RewriteRule ^/rsrc/(.*)     -                       [L,QSA]
                     RewriteRule ^/favicon.ico   -                       [L,QSA]
                     RewriteRule ^(.*)$          /index.php?__path__=$1  [B,L,QSA]
-                    <Directory "/etc/phabricator/webroot">
+                    <Directory "/home/phd/phabricator/webroot">
                             Require all granted
                     </Directory>
             </VirtualHost>