Running Etherpad on Phusion Passenger

FooBarWidget edited this page Sep 15, 2014 · 1 revision

General

Resources

For Developers

How to's

Set up

Advanced steps

Integrating Etherpad in your web app

for Developers

Clone this wiki locally

Etherpad can be run on the Phusion Passenger application server for Node.js. Phusion Passenger 4.0.48 or later is required.

Phusion Passenger for Nginx

Add an Nginx virtual host as follows:

server {
    listen 80;
    server_name www.yourdomain.com;

    # Tells Phusion Passenger where Etherpad and its static files are.
    root /path-to-etherpad/src/static;
    passenger_app_root /path-to-etherpad;

    # Enables Phusion Passenger and tells it that it's a Node.js app.
    passenger_enabled on;
    passenger_app_type node;
    passenger_startup_file node_modules/ep_etherpad-lite/node/server.js;
}

Phusion Passenger for Apache

At this time, it is not possible to run Etherpad on Phusion Passenger for Apache, because there are some problems with WebSockets. Please use Phusion Passenger for Nginx or Phusion Passenger Standalone instead.

Phusion Passenger Standalone

You need to pass --app-type node --startup-file node_modules/ep_etherpad-lite/node/server.js to Phusion Passenger Standalone. Here is an example, which starts Etherpad in Phusion Passenger Standalone on port 9001:

cd /path-to-etherpad
passenger start --app-type node --startup-file node_modules/ep_etherpad-lite/node/server.js --port 9001