AnyCable Rails

AnyCable allows you to use any WebSocket server (written in any language) as a replacement for built-in Rails Action Cable server.

With AnyCable you can use channels, client-side JS, broadcasting - (almost) all that you can do with Action Cable.

You can even use Action Cable in development and not be afraid of compatibility issues.

💾 Example Application

📑 Documentation.

Requirements

Ruby ~> 2.4; NOTE: for Ruby 2.6 use RC version of google-protobuf gem. In your Gemfile: gem "google-protobuf", '>=3.7.0.rc.2'
Rails ~> 5.0;
Redis (see other options for broadcasting)

How It Works?

Usage

Add anycable-rails gem to your Gemfile:

gem "anycable-rails"

# when using Redis broadcast adapter
gem "redis", ">= 4.0"

(and don't forget to run bundle install).

Next, specify AnyCable subscription adapter for Action Cable:

# config/cable.yml
production:
  adapter: any_cable # or anycable

and specify AnyCable WebSocket server URL:

# For development it's likely the localhost

# config/environments/development.rb
config.action_cable.url = "ws://localhost:3334/cable"

# For production it's likely to have a sub-domain and secure connection

# config/environments/production.rb
config.action_cable.url = "wss://ws.example.com/cable"

hen, run AnyCable RPC server:

$ bundle exec anycable

# don't forget to provide Rails env

$ RAILS_ENV=production bundle exec anycable

And, finally, run AnyCable WebSocket server, e.g. anycable-go:

anycable-go --host=localhost --port=3334

See documentation for more information on AnyCable + Rails usage.

Action Cable Compatibility

See documentation.

Talks

One cable to rule them all, RubyKaigi 2018, slides and video (EN)
Wroc_Love.rb 2018 slides and video (EN)

Compatible WebSocket servers

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/anycable/anycable-rails.

License

The gem is available as open source under the terms of the MIT License.