Southwest Checkin

by snekse


Southwest Checkin 2.X

Build Status


Automatically checks in passengers for their Southwest Flight.

Version 2.0 of this project is a complete rewrite of the service. The brittle HTML parsing and form submissions are a thing of the past. A much better approach is being taken to automate checkins. And, importantly, the new version has a robust test suite. It is even written in a new language (Ruby) and framework (Rails).

If you are interested in the old version, see the 1.0 branch.


  • Accounts
    • an easy and convient way to manage your reservations
    • view or remove your reservations at any time
    • increased security
  • Email Notifications
    • Notified when a reservation is added
    • Notified on successful checkin
  • Checks in all passengers for a given confirmation number
  • Secured via HTTPS
  • Modern UI
  • Modern background processing and job scheduling
  • Full test suite


Can run on Heroku with a single button click Updated for Ruby 2.6.3, Rails 5.2.3 by a non-Rails person

Grab the source for checkin

git clone
cd southwest-checkin

Install the bundled gems

bundle install

Create a db user and give them create privileges (ignore any directory errors) Populate the db

rake db:create db:migrate db:seed

Create a config file replace your website, email, and email server. It must accept mail on port 587 with tls. You can use .env.example as a template

echo 'SITE_NAME=Southwest Checkin

Old but maybe useful bits

Heroku Installation

  1. While not strictly required, it is recommended to install rbenv and ruby-build to manage ruby versions in development. Ruby 2.2 or greater is required.

    • Note: Replace anything inside of <> with your projects information.
    • Note: These instructions do not include steps to add email support.
    • Note: This tutorial assumes you're using a Mac with OSX, if you're running something else you may need to make a few adjustments for your OS but should work mostly the same.
    • Note: I recommend using Homebrew to install dependencies.
  2. Required dependencies

  3. Setup heroku and download latest version of the code:

    • Create an account on Heroku
    • From the Heroku web interface create a new app
    • From the Heroku web interface add the following resources to your project:
      • Redis To Go
      • Heroku Postgres
    • Create a folder and cd into it using Terminal
    cd Your/Project/Folder
    git clone
    heroku git:remote -a <YOUR_HEROKU_APP_NAME>
  4. Get sidekiq to load the redis add-on's URL

    heroku config:set REDIS_PROVIDER=REDISTOGO_URL
  5. Add ruby version to Gemfile:

    • Open the Gemfile located in the project folder and add the following lines near the top, right below source ''"
    ruby '2.2.0'
    gem 'rails_12factor', group: :production
  6. Configure Heroku:

  7. After installing the aforementioned dependencies (see step 2), install the ruby dependencies:

    gem install bundler
    bundle install
  8. Now commit and push your app to heroku:

    git add .
    git commit -am ""
    git push heroku master
  9. Create and seed the database:

    heroku run rake db:create db:migrate db:seed
  10. (Optional) Setup email with Mailgun

    • From the Heroku web interface add the following resource to your project:
      • Mailgun
    • Once Mailgun is installed login to Mailgun (click on the Mailgun resource to automatically be logged in) and add your domain. This might not be necessary but it's the only way I could get it to work for me.
    • Once the domain has been verified, click on the domain to find the values for the following command and run it:
  11. Now browse to your Heroku's app url and start adding reservations.

Create a script to launch everything

echo '#!/bin/sh
service postgresql restart
service redis-server restart
sleep 2
echo Starting rails
tmux new -s rails  -d
tmux send-keys  -t rails "cd /root/southwest-checkin/app" C-m
tmux send-keys  -t rails "/root/.rbenv/shims/rails s -b -p 80 -e development" C-m
tmux new -s sidekiq -d
sleep 2
echo Starting sidekiq
tmux send-keys  -t sidekiq "cd /root/southwest-checkin" C-m
tmux send-keys  -t sidekiq "/root/.rbenv/shims/bundle exec sidekiq &" C-m' > /root/

Enable Email in Dev Mode (update action_mailer settings) nano config/environments/development.rb

Rails.application.configure do
  # Settings specified here will take precedence over those in config/application.rb.

  # In the development environment your application's code is reloaded on
  # every request. This slows down response time but is perfect for development
  # since you don't have to restart the web server when you make code changes.
  config.cache_classes = false

  # Do not eager load code on boot.
  config.eager_load = false

  # Show full error reports and disable caching.
  config.consider_all_requests_local       = true
  config.action_controller.perform_caching = false

  config.action_mailer.asset_host = ENV['ASSET_HOST']
  config.action_mailer.raise_delivery_errors = true
  config.action_mailer.default_url_options = {
    protocol: ENV['MAILER_DEFAULT_PROTOCOL'] || 'https'
  config.action_mailer.default_options  = {
  config.action_mailer.delivery_method = :smtp
  config.action_mailer.smtp_settings = {
    address:              ENV['MAILER_ADDRESS'],
    user_name:            ENV['MAILER_USERNAME'],
    password:             ENV['MAILER_PASSWORD'],
    port:                 587,
    authentication:       'plain',
    enable_starttls_auto: true }

  # Print deprecation notices to the Rails logger.
  config.active_support.deprecation = :log

  # Raise an error on page load if there are pending migrations.
  config.active_record.migration_error = :page_load

  # Debug mode disables concatenation and preprocessing of assets.
  # This option may cause significant delays in view rendering with a large
  # number of complex assets.
  config.assets.debug = true

  # Asset digests allow you to set far-future HTTP expiration dates on all assets,
  # yet still be able to expire them through the digest params.
  config.assets.digest = true

  # Adds additional error checking when serving assets at runtime.
  # Checks for improperly declared sprockets dependencies.
  # Raises helpful error messages.
  config.assets.raise_runtime_errors = true

  # Raises error for missing translations
  # config.action_view.raise_on_missing_translations = true