Skip to content
Ruby library for IronMQ.
Pull request Compare This branch is 263 commits behind master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

IronMQ Ruby Client

Getting Started

1. Install the gem:

gem install iron_mq

2. Setup your credentials:

3. Create an IronMQ client object:

@ironmq =

The Basics

Get a Queue object

You can have as many queues as you want, each with their own unique set of messages.

@queue = @ironmq.queue("my_queue")

Now you can use it:

Post a message on the queue:"hello world!")

Get a message off the queue:

msg = @queue.get()
puts msg.body

When you pop/get a message from the queue, it will NOT be deleted. It will eventually go back onto the queue after a timeout if you don't delete it (default timeout is 10 minutes).

Delete a message from the queue:

msg.delete # or @queue.delete(

Be sure to delete a message from the queue when you're done with it.

Poll for messages:

@queue.poll do |msg|
  puts msg.body

Polling will automatically delete the message at the end of the block.

Queue Information

queue = @client.queue("my_queue")
puts "size: #{queue.size}"
Something went wrong with that request. Please try again.