# Sharing a Ruby gem I've written to streamline Convox installations

**URL:** https://community.convox.com/t/sharing-a-ruby-gem-ive-written-to-streamline-convox-installations/525
**Category:** CLI
**Created:** [May 9, 2019, 1:16pm UTC](https://community.convox.com/t/sharing-a-ruby-gem-ive-written-to-streamline-convox-installations/525 "2019-05-09T13:16:14Z")
**Posts on this page:** 2
**Page:** 1

<div class="post-metadata">

### Author: ![nathan.f77](https://yyz1.discourse-cdn.com/flex029/user_avatar/community.convox.com/nathan.f77/32/256_2.png) [@nathan.f77](https://community.convox.com/u/nathan.f77)
#### Post date: [May 9, 2019, 1:16pm UTC](https://community.convox.com/t/sharing-a-ruby-gem-ive-written-to-streamline-convox-installations/525/1 "2019-05-09T13:16:14Z")

</div>

Hi everyone,

I wanted to share a Ruby gem I’ve been working on, which makes it easier to build a convox installation workflow.

The gem is called [convox\_installer](https://github.com/FormAPI/convox_installer), and you can include it in a single Ruby file with `bundler/inline`. So you can have an `install.rb` script that starts like this:

```ruby
#!/usr/bin/env ruby
require 'bundler/inline'

gemfile do
  source 'https://rubygems.org'
  gem 'convox_installer'
end

require "convox_installer"
include ConvoxInstaller

# Your installation script here

```

Including the `ConvoxInstaller` module gives you some Ruby methods you can call to perform various operations. These methods are all [documented in the README](https://github.com/FormAPI/convox_installer#convoxinstaller-dsl).

Here’s a [full example of a Convox install script](https://github.com/FormAPI/convox_installer/blob/master/examples/full_installation.rb), which includes some custom config prompts, CORS settings for an S3 bucket, setting ENV vars, data setup and seeding, health check upgrade flow, and a final summary that you can customize for your users.

Please check it out, and I hope someone finds this useful!

Many thanks to the Convox devs for the awesome `convox/rack` and CLI tool. This is a really awesome and easy way to get open source projects or on-premise deployments set up on your own AWS infrastructure.

---

<div class="post-metadata">

### Author: ![edfricker](https://yyz1.discourse-cdn.com/flex029/user_avatar/community.convox.com/edfricker/32/95_2.png) [@edfricker](https://community.convox.com/u/edfricker)
#### Post date: [August 7, 2019, 7:14pm UTC](https://community.convox.com/t/sharing-a-ruby-gem-ive-written-to-streamline-convox-installations/525/2 "2019-08-07T19:14:40Z")

</div>

Really nice idea! 😁
