nativeInstallerphabricator

Configure and enable Conpherence

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

NOTE: The Approach A sections referred to below do not apply to Bitnami native installers. Users of Bitnami native installers should refer only to the Approach B sections.

To enable Conpherence, follow these steps:

  • Install Node.js and npm (if not already installed) using the official installation instructions.

  • Set the Node.js environment variable:

      $ export NODE_PATH=/usr/lib/node_modules
    
  • Install ws globally:

      $ sudo npm install -g ws
    
  • Start the Aphlict service:

    • Approach A (Bitnami installations using system packages):

        $ sudo installdir/phabricator/bin/aphlict start --config installdir/phabricator/conf/aphlict/aphlict.default.json
      
    • Approach B (Self-contained Bitnami installations):

        $ sudo installdir/apps/phabricator/htdocs/bin/aphlict start --config installdir/apps/phabricator/htdocs/conf/aphlict/aphlict.default.json
      
  • Log in to Phabricator as an administrator and navigate to the “Configuration -> Core Settings -> Notifications” section.

  • Modify the notification.servers value by entering the following configuration, ensuring the IP-ADDRESS placeholder reflects the IP address of the server hosting Phabricator. Click the “Save Config Entry” button once done.

      [ { "type": "client", "host": "IP-ADDRESS", "port": 22280, "protocol": "http" }, { "type": "admin", "host": "127.0.0.1", "port": 22281, "protocol": "http" } ]
    

    Here’s what the result should look like:

    Server configuration

  • Open port 22280 in the server firewall. Refer to the FAQ for Windows, Linux and macOS for more information.

Real-time notifications should now be enabled.

Last modification June 16, 2021