Ruby Getting Started

A barebones Ruby on Rails app, which can easily be deployed to Heroku.

This application supports the tutorials for both the Cedar and Fir generations of the Heroku platform. You can check them out here:

• Getting Started on Heroku with Ruby
• Getting Started on Heroku Fir with Ruby

Running Locally

Make sure you have Ruby and the Heroku CLI installed.

$ git clone https://github.com/heroku/ruby-getting-started
$ cd ruby-getting-started
$ bundle install
$ bundle exec rake db:create db:migrate
$ heroku local

Your app should now be running on localhost:5006.

Deploying to Heroku

Using resources for this example app counts towards your usage. Delete your app and database as soon as you are done experimenting to control costs.

Ensure you're in the correct directory:

$ ls
Gemfile		Procfile	Rakefile	app.json	config		db		log		public		tmp
Gemfile.lock	README.md	app		bin		config.ru	lib		package.json	test		vendor

Deploy on Heroku Cedar

By default, apps use Eco dynos if you are subscribed to Eco. Otherwise, it defaults to Basic dynos. The Eco dynos plan is shared across all Eco dynos in your account and is recommended if you plan on deploying many small apps to Heroku. Learn more about our low-cost plans here.

Eligible students can apply for platform credits through our new Heroku for GitHub Students program.

$ heroku create
$ git push heroku main
$ heroku open

Deploy on Heroku Fir

By default, apps on Fir use 1X-Classic dynos. To create an app on Fir you'll need to create a private space first.

$ heroku create --space <space-name>
$ git push heroku main
$ heroku ps:wait
$ heroku open

Documentation

For more information about using Ruby on Heroku, see these Dev Center articles:

• Getting Started on Heroku with Ruby
• Getting Started on Heroku Fir with Ruby
• Ruby articles on the Heroku Dev Center