This repository demonstrates a small WebSocket-capable Rack application on Phusion Passenger. The application performs a WebSocket handshake and sends 10 "hello world" messages to the client with a 1 second delay between each message. Anything that the client sends is echoed back to the client, after an at most 1 second delay.
If you like this demo, please tweet about it or follow us on Twitter.
More information about Phusion Passenger:
Clone this repository, install the gem bundle and start Phusion Passenger Standalone.
git clone https://github.com/phusion/passenger-ruby-websocket-demo.git
cd passenger-ruby-websocket-demo
bundle install
bundle exec passenger start
You also need to install wssh, the WebSocket command line client:
git clone https://github.com/progrium/wssh.git ~/wssh
cd ~/wssh
sudo python setup.py install
Note that wssh requires libevent (because wssh uses gevent). If you installed libevent with MacPorts then gevent may have trouble finding event.h. Use this command tell gevent where it can find libevent: sudo env C_INCLUDE_PATH=/opt/local/include LIBRARY_PATH=/opt/local/lib python setup.py install
Once the server is started, perform a request and see it in action:
wssh localhost:3000/
(wssh may be in /opt/local/Library/Frameworks/Python.framework/Versions/2.7/bin if you're using Python 2.7 from MacPorts)
While wssh is active, whenever you type anything into the console and press Enter, the server will echo it back to you.
- This app uses plain Rack, and thus is framework agnostic.
- WebSockets works on Phusion Passenger for Apache, Phusion Passenger for Nginx and Phusion Passenger Standalone.
- At least version 4.0.5 of Phusion Passenger is required.
- Only the RFC 6455 version of the WebSocket protocol is supported.
WebSockets work great on both the open source variant of Phusion Passenger, as well as on Phusion Passenger Enterprise. For optimal performance, Phusion Passenger Enterprise with multithreading is recommended. You should use the following settings for enabling multithreading. The more concurrent users you have, the higher your thread count should be. As a rule, your thread count should be at least the number of WebSocket sessions you have.
Apache:
PassengerConcurrencyModel thread
PassengerThreadCount 64
Nginx:
passenger_concurrency_model thread
passenger_thread_count 64
- Using WebSockets on Phusion Passenger? Tweet about us, follow us on Twitter or fork us on Github.
- Having problems? Please post a message at the community discussion forum.
Please enjoy Phusion Passenger, a product by Phusion. :-)