How to Implement Apple Push Notifications in Rails

Photo of Zuzanna Stolińska

Zuzanna Stolińska

Updated Jun 22, 2021 • 7 min read

Mobile notifications are a great feature for your app, especially when you integrate desktop and mobile solutions. Here's a quick guide on how to setup Apple notifications in your Ruby on Rails project.

I assume you already have these:

  • Apple certificatefor your application,

  • Rails app or API user interface implemented,

  • for production: any tool set for managing background jobs.

What You Will Use:

  • Houston- gem for sending push notifications,

  • iPhone or iPad to test your notifications.


  • easy to implement,

  • provides integration with background jobs,

  • allows testing notifications from the command line.


  • documentation does not cover some use cases (i.e. Safari push notifications).

Step 1

Add Houston gem to your Gemfile:

gem 'houston'

Run bundle install. Houston comes with Apple Push Notification binary which enables testing notifications from the command line.

Step 2

If you don’t have it yet - create a Device model which will store users’ unique device id (uuid) in the database.


Step 3

Add a migration for the Device model. The `uuid` column and references to the user table are required in our case, the rest depends on your specifications.


Run the migration.

Step 4

You’ll also need to prepare an action in which the user’s device will be created and saved to the database. You could do it when the user registers or when the mobile app calls to some API endpoint.
To create the device object, we’ll use SecureRandom.uuid method:

Device.create(user: user_id, uuid: SecureRandom.uuid)

Step 5

If you’re using environment variables, Houston will read them automatically, so you can add APN_CERTIFICATEand APN_CERTIFICATE_PASSPHRASEto your config file.
See more configuration options in this section:

If you’re using AppConfig to store variables, you can define them on initialising APN connection. Here’s an example of a snippet:


Notice the environment option:

You can initialise the production the same way:

Step 6

It’s time to create the Notification that will alert a “Hello, World!” message to our user.

notification = token)
notification.alert = "Hello, World!"

There are several options from which you can choose when creating a custom notification:

notification.alert = "Hello, World!
set an alert message
notification.badge = 57
change a badge count
notification.sound = "sosumi.aiff"
custom notification sound
notification.category = "INVITE_CATEGORY"
add a category identifier
notification.content_available = true
indicate available Newsstand content
notification.custom_data = {foo: "bar"}
pass custom data

Silent Notifications:

If you want to alert the user without a sound effect, you have to set sound to an empty string: => '', :content_available => true)

For more options, head over to Houston Githubpage.

Step 7

Everything looks good, so now, using APN method defined in step 4, we can invoke the action that will send a push notification to your device:


Important note: if you want to test receiving the notification on your device - make sure your app is in the background or closed. Otherwise, the message won’t show up on your screen.

You can also test if the notifications are working from the included command line APN method.

Use APN push method with your device uuid as and argument and define

-c path_to_your_certificate and -m “your message”

$ apn push "<uuid>" -c /path/to/apple_push_notification.pem -m "Hello from the command line! " 

Step 8 (Production)

Apple encourages using a queued background job over synchronous connection to their servers. That is why, Houston allows us to establish a persistent connection to their servers.

You could create your background job this way:


Notice the APPLE_PRODUCTION_GATEWAY_URIused to establish a connection.
Again - you can also connect to the development gateway:



Thanks for reaching to the end! I hope my guide will be helpful in your development efforts. To sum up, in this tutorial you have learned:

  • how to prepare your application for managing unique userdevices,

  • how to set up Houston to send push notifications to Apple devices,

  • how to schedule sending notifications in a background job.

Photo of Zuzanna Stolińska

More posts by this author

Zuzanna Stolińska

At first, Zuzanna dreamed about becoming a music star so she learned how to play the guitar....
Lost with AI?  Get the most important news weekly, straight to your inbox, curated by our CEO  Subscribe to AI'm Informed

We're Netguru!

At Netguru we specialize in designing, building, shipping and scaling beautiful, usable products with blazing-fast efficiency

Let's talk business!

Trusted by: