Red Hat AMQ

A lightweight, high-performance, robust messaging platform

Hello World!

Build Something Today

Let's walk through everything you need to build your first application.

Hello World!

1. Set up your development environment

5 minutes


Download and Install AMQ Broker:

  1. Download and extract:

    1. Download the latest version of Red Hat AMQ Broker. The latest at the time of this writing is Red Hat AMQ Broker 7.5.0 GA.

    2. Unzip AMQ Broker to any destination. The document will refer to this directory as AMQ_HOME.

      • On Windows or Mac, you can extract the contents of the ZIP archive by double clicking on the ZIP file.

      • On Red Hat Enterprise Linux, open a terminal window in the target machine and navigate to where the ZIP file was downloaded. Extract the ZIP file by executing the following command:


2. Create and Run an AMQ Broker Instance

3 minutes


Create and Run an AMQ Broker Instance:

The artemis script located in the bin folder is the starting point to manage our AMQ installation.

  1. Create a Broker Instance:

    1. Execute the following command to create a new broker in the instances folder.

      $ <AMQ_HOME>/bin/artemis create --user admin --password password --role admin --allow-anonymous y <AMQ_HOME>/instances/mybroker

      This command creates a broker in <AMQ_HOME>/instances/mybroker folder, with the admin default user with admin role and password as their password. This broker also accepts anonymous users to connect to the broker from localhost.  The folder where the broker is installed is referred as AMQ_INSTANCE.

  2. Start the Broker Instance:

    To start the broker you only need to run this command from the <AMQ_INSTANCE> folder:

    $ bin/artemis run

    After you run this command a console log will appear and the broker will be running.

3. Start using the Broker

1 minutes


Produce and consume messages:

  1. Sending 1000 messages to the broker:

    • AMQ_INSTANCE/bin/artemis producer

  2. Consume messages from broker:

    • AMQ_INSTANCE/bin/artemis consumer

You just sent and received messages via Red Hat A­MQ Broker. Visit frequently to view more tutorials on connecting via MQTT, STOMP and other topics around A­MQ.

Build Something Today

Let's walk through everything you need to build your first application.