Skip to content

Versions and Compatibilities

Tatsuya Ono edited this page Nov 3, 2024 · 26 revisions

The version of RabbitMQ here means the Erlang client version which this library uses internally.

The RabbitMQ team always update the client and server together and they share the version number between them. The client usually works with a server on a lower version (especially if it's only a patch version difference) so we generally recommend you use the latest client.

However, it is also recommended that you upgrade the server regularly to avoid unexpected behaviours caused by the version mismatch.

See also:

You can specify the version for amqp_client in your mix.exs.

def deps do
  [
    {:amqp, "~> 4.0"},
    {:amqp_client, "~> 4.0.3"}
  ]
end

4.x

Status: current stable version

  • Elixir: ~> 1.14
  • OTP: ~> 26
  • RabbitMQ: ~> 4.x and ~> 3.9

RabbitMQ requires specific OTP versions. Please check the OTP compatibility here.

Also, note that the RabbitMQ team reported some performance regressions with OTP 27.

3.x

Status: maintenance version (upgrade highly recommended)

  • Elixir: 1.11 - 1.17
  • OTP: 23.2 - 26.x
  • RabbitMQ: ~> 3.9

2.x

Status: no longer supported (upgrade highly recommended)

  • Elixir: ~> 1.8
  • OTP: ~> 21 and ~< 23
  • RabbitMQ: ~> 3.8.0

1.6.x

Status: no longer supported (upgrade highly recommended)

  • Elixir: ~> 1.7
  • OTP: ~> 21
  • RabbitMQ: ~> 3.8.0

1.5.x

Status: no longer supported (upgrade highly recommended)

  • Elixir: ~> 1.7
  • OTP: ~> 21
  • RabbitMQ: ~> 3.8.0

1.4.x

Status: no longer supported (upgrade highly recommended)

  • Elixir: ~> 1.7
  • OTP: ~> 21
  • RabbitMQ: ~> 3.8.0

1.3.x

Status: no longer supported (upgrade highly recommended)

  • Elixir: ~> 1.7
  • OTP: ~> 21
  • RabbitMQ: ~> 3.7.11

1.2.x

Status: no longer supported (upgrade highly recommended)

  • Elixir: ~> 1.7
  • OTP: ~> 21
  • RabbitMQ: ~> 3.7.11

1.1.x

Status: no longer supported (upgrade highly recommended)

  • Elixir: ~> 1.5
  • OTP: ~> 21
  • RabbitMQ: ~> 3.7.9

1.0.x

Status: no longer supported (upgrade highly recommended)

  • Elixir: ~> 1.5
  • OTP: 19 ~ 20
  • RabbitMQ: ~> 3.7.3

0.3.x

Status: no longer supported (upgrade highly recommended)

  • Elixir: ~> 1.3
  • OTP: 19 ~ 20
  • RabbitMQ: ~> 3.6.7

For OTP 20.0+, you need amqp_client 3.6.11+.

For OTP 22.0+, you need amqp_client 3.6.15+.

0.2.x

Status: no longer supported (upgrade highly recommended)

  • Elixir: 1.3 ~ 1.5
  • OTP: 19 ~ 20
  • RabbitMQ: ~> 3.6.7

0.1.x

Status: no longer supported (upgrade highly recommended)

  • Elixir: 1.0 ~ 1.4
  • OTP: 17 - 18
  • RabbitMQ: ~< 3.6.6