Manage Remote Servers, in Ruby

Kanrisuru helps you manage your remote servers with objected oriented ruby. Results come back as structured data, parsed, prepared and ready for you to easily use in your applications.

Get Started


With Kanrisuru, there's no need to install agents on the infrastructure you are managing. Instead, the commands are run through remote ssh connections from wherever Kanrisuru is setup and run.


Kanrisuru is meant to be directly plugged into your ruby project. Since it's a library of modules to manage linux servers, it's easy to rapidly develop remote server management code, without large library dependencies.

Structured Commands

All Kanrisuru commands have well tested options with arguments being directly verified. Any Kanrisuru command with output is parsed and assigned to a dedicated object property, making it easy to read results from the remote servers.


Specify the Kanrisuru gem in the Gemfile.

Run bundle install to install the latest version of Kanrisuru

You can also install Kanrisuru globally

Get up and running
gem 'kanrisuru'
bundle install
gem install kanrisuru

Hello Kanrisuru

Kanrisuru is easy to quickly connect to your remote infrastructure. Once the library is installed, you can start running commands with just a few lines of code. Kanrisuru has a robust set of the top 80% of commands used in most linux environments, tested, and ported in a way that makes interacting with remote servers a breeze.

Dive into the commands
require 'kanrisuru'
host = Kanrisuru::Remote::Host.new(host: '', username: 'ubuntu', keys: ['~/.ssh/id_rsa'])

host.env['VAR'] = 'world'
result = host.echo('hello $VAR')

"hello world"

Tested On

Kanrisuru has a strong test suite, including a full integration suite over the top linux distros, including Debian, Ubuntu, Centos, Fedora, Redhat, openSUSE, and SLES. Kanrisuru strives to ensure operational effectiveness with the library with high line coverage and tested on as many flavors of linux as possible.

Learn more
Debian Ubuntu Centos Fedora Redhat Enterprise Linux OpenSUSE SUSE Enterprise Linux