Skip to content

Commit 68f2d8a

Browse files
Debian and Ubuntu guide: drop some distributions
Debian Trixie is nowhere near the release and currently Erlang fails to build on it because they have bumped autoconf to 2.72. Buster is nearly completely dead. So are non-LTS Ubuntu distributions. Finally, Launchpad really isn't meant to support Debian, so let's stop recommending using Bionic packages because they do not even provide Erlang 26, which is required by RabbitMQ 4.0.x and 3.13.x.
1 parent 1216c94 commit 68f2d8a

File tree

3 files changed

+15
-462
lines changed

3 files changed

+15
-462
lines changed

docs/install-debian.md

Lines changed: 5 additions & 154 deletions
Original file line numberDiff line numberDiff line change
@@ -89,8 +89,8 @@ i.e. inline with [distribution EOL policy](https://wiki.debian.org/DebianRelease
8989

9090
Currently the list of supported Debian-based distributions includes
9191

92-
* Ubuntu 20.04, 22.04 and 24.04
93-
* Debian Bullseye (11), Bookworm (12), and Trixie ("testing")
92+
* Ubuntu 20.04 (Focal), 22.04 (Jammy) and 24.04 (Noble)
93+
* Debian Bullseye (11), Bookworm (12)
9494

9595
The package may work on other Debian-based distributions
9696
if [dependencies](#manual-installation) are satisfied (e.g. using a backports repository)
@@ -388,104 +388,6 @@ EOF
388388
## Update package indices
389389
sudo apt-get update -y
390390

391-
## Install Erlang packages
392-
sudo apt-get install -y erlang-base \
393-
erlang-asn1 erlang-crypto erlang-eldap erlang-ftp erlang-inets \
394-
erlang-mnesia erlang-os-mon erlang-parsetools erlang-public-key \
395-
erlang-runtime-tools erlang-snmp erlang-ssl \
396-
erlang-syntax-tools erlang-tftp erlang-tools erlang-xmerl
397-
398-
## Install rabbitmq-server and its dependencies
399-
sudo apt-get install rabbitmq-server -y --fix-missing
400-
```
401-
</TabItem>
402-
403-
<TabItem value="debian-buster" label="Debian Buster">
404-
```bash
405-
#!/bin/sh
406-
407-
sudo apt-get install curl gnupg apt-transport-https -y
408-
409-
## Team RabbitMQ's main signing key
410-
curl -1sLf "https://keys.openpgp.org/vks/v1/by-fingerprint/0A9AF2115F4687BD29803A206B73A36E6026DFCA" | sudo gpg --dearmor | sudo tee /usr/share/keyrings/com.rabbitmq.team.gpg > /dev/null
411-
## Community mirror of Cloudsmith: modern Erlang repository
412-
curl -1sLf https://github.com/rabbitmq/signing-keys/releases/download/3.0/cloudsmith.rabbitmq-erlang.E495BB49CC4BBE5B.key | sudo gpg --dearmor | sudo tee /usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg > /dev/null
413-
## Community mirror of Cloudsmith: RabbitMQ repository
414-
curl -1sLf https://github.com/rabbitmq/signing-keys/releases/download/3.0/cloudsmith.rabbitmq-server.9F4587F226208342.key | sudo gpg --dearmor | sudo tee /usr/share/keyrings/rabbitmq.9F4587F226208342.gpg > /dev/null
415-
416-
## Add apt repositories maintained by Team RabbitMQ
417-
sudo tee /etc/apt/sources.list.d/rabbitmq.list <<EOF
418-
## Provides modern Erlang/OTP releases
419-
##
420-
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa1.rabbitmq.com/rabbitmq/rabbitmq-erlang/deb/debian buster main
421-
deb-src [signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa1.rabbitmq.com/rabbitmq/rabbitmq-erlang/deb/debian buster main
422-
423-
# another mirror for redundancy
424-
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa2.rabbitmq.com/rabbitmq/rabbitmq-erlang/deb/debian buster main
425-
deb-src [signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa2.rabbitmq.com/rabbitmq/rabbitmq-erlang/deb/debian buster main
426-
427-
## Provides RabbitMQ
428-
##
429-
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa1.rabbitmq.com/rabbitmq/rabbitmq-server/deb/debian buster main
430-
deb-src [signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa1.rabbitmq.com/rabbitmq/rabbitmq-server/deb/debian buster main
431-
432-
# another mirror for redundancy
433-
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa2.rabbitmq.com/rabbitmq/rabbitmq-server/deb/debian buster main
434-
deb-src [signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa2.rabbitmq.com/rabbitmq/rabbitmq-server/deb/debian buster main
435-
EOF
436-
437-
## Update package indices
438-
sudo apt-get update -y
439-
440-
## Install Erlang packages
441-
sudo apt-get install -y erlang-base \
442-
erlang-asn1 erlang-crypto erlang-eldap erlang-ftp erlang-inets \
443-
erlang-mnesia erlang-os-mon erlang-parsetools erlang-public-key \
444-
erlang-runtime-tools erlang-snmp erlang-ssl \
445-
erlang-syntax-tools erlang-tftp erlang-tools erlang-xmerl
446-
447-
## Install rabbitmq-server and its dependencies
448-
sudo apt-get install rabbitmq-server -y --fix-missing
449-
```
450-
</TabItem>
451-
452-
<TabItem value="debian-trixie" label="Debian Trixie and Debian Sid">
453-
```bash
454-
#!/bin/sh
455-
456-
sudo apt-get install curl gnupg apt-transport-https -y
457-
458-
## Team RabbitMQ's main signing key
459-
curl -1sLf "https://keys.openpgp.org/vks/v1/by-fingerprint/0A9AF2115F4687BD29803A206B73A36E6026DFCA" | sudo gpg --dearmor | sudo tee /usr/share/keyrings/com.rabbitmq.team.gpg > /dev/null
460-
## Community mirror of Cloudsmith: modern Erlang repository
461-
curl -1sLf https://github.com/rabbitmq/signing-keys/releases/download/3.0/cloudsmith.rabbitmq-erlang.E495BB49CC4BBE5B.key | sudo gpg --dearmor | sudo tee /usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg > /dev/null
462-
## Community mirror of Cloudsmith: RabbitMQ repository
463-
curl -1sLf https://github.com/rabbitmq/signing-keys/releases/download/3.0/cloudsmith.rabbitmq-server.9F4587F226208342.key | sudo gpg --dearmor | sudo tee /usr/share/keyrings/rabbitmq.9F4587F226208342.gpg > /dev/null
464-
465-
## Add apt repositories maintained by Team RabbitMQ
466-
sudo tee /etc/apt/sources.list.d/rabbitmq.list <<EOF
467-
## Provides modern Erlang/OTP releases
468-
##
469-
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa1.rabbitmq.com/rabbitmq/rabbitmq-erlang/deb/debian trixie main
470-
deb-src [signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa1.rabbitmq.com/rabbitmq/rabbitmq-erlang/deb/debian trixie main
471-
472-
# another mirror for redundancy
473-
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa2.rabbitmq.com/rabbitmq/rabbitmq-erlang/deb/debian trixie main
474-
deb-src [signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa2.rabbitmq.com/rabbitmq/rabbitmq-erlang/deb/debian trixie main
475-
476-
## Provides RabbitMQ
477-
##
478-
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa1.rabbitmq.com/rabbitmq/rabbitmq-server/deb/debian trixie main
479-
deb-src [signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa1.rabbitmq.com/rabbitmq/rabbitmq-server/deb/debian trixie main
480-
481-
# another mirror for redundancy
482-
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa2.rabbitmq.com/rabbitmq/rabbitmq-server/deb/debian trixie main
483-
deb-src [signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa2.rabbitmq.com/rabbitmq/rabbitmq-server/deb/debian trixie main
484-
EOF
485-
486-
## Update package indices
487-
sudo apt-get update -y
488-
489391
## Install Erlang packages
490392
sudo apt-get install -y erlang-base \
491393
erlang-asn1 erlang-crypto erlang-eldap erlang-ftp erlang-inets \
@@ -686,54 +588,6 @@ deb-src [signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://pp
686588
EOF
687589
```
688590
</TabItem>
689-
690-
<TabItem value="debian-buster" label="Debian Buster">
691-
```bash
692-
sudo tee /etc/apt/sources.list.d/rabbitmq.list <<EOF
693-
## Provides modern Erlang/OTP releases from a Cloudsmith mirror
694-
##
695-
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa1.rabbitmq.com/rabbitmq/rabbitmq-erlang/deb/debian buster main
696-
deb-src [signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa1.rabbitmq.com/rabbitmq/rabbitmq-erlang/deb/debian buster main
697-
698-
# another mirror for redundancy
699-
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa2.rabbitmq.com/rabbitmq/rabbitmq-erlang/deb/debian buster main
700-
deb-src [signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa2.rabbitmq.com/rabbitmq/rabbitmq-erlang/deb/debian buster main
701-
702-
## Provides RabbitMQ from a Cloudsmith mirror
703-
##
704-
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa1.rabbitmq.com/rabbitmq/rabbitmq-server/deb/debian buster main
705-
deb-src [signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa1.rabbitmq.com/rabbitmq/rabbitmq-server/deb/debian buster main
706-
707-
# another mirror for redundancy
708-
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa2.rabbitmq.com/rabbitmq/rabbitmq-server/deb/debian buster main
709-
deb-src [signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa2.rabbitmq.com/rabbitmq/rabbitmq-server/deb/debian buster main
710-
EOF
711-
```
712-
</TabItem>
713-
714-
<TabItem value="debian-trixie" label="Debian Trixie and Debian Sid">
715-
```bash
716-
sudo tee /etc/apt/sources.list.d/rabbitmq.list <<EOF
717-
## Provides modern Erlang/OTP releases from a Cloudsmith mirror
718-
##
719-
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa1.rabbitmq.com/rabbitmq/rabbitmq-erlang/deb/debian trixie main
720-
deb-src [signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa1.rabbitmq.com/rabbitmq/rabbitmq-erlang/deb/debian trixie main
721-
722-
# another mirror for redundancy
723-
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa2.rabbitmq.com/rabbitmq/rabbitmq-erlang/deb/debian trixie main
724-
deb-src [signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa2.rabbitmq.com/rabbitmq/rabbitmq-erlang/deb/debian trixie main
725-
726-
## Provides RabbitMQ from a Cloudsmith mirror
727-
##
728-
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa1.rabbitmq.com/rabbitmq/rabbitmq-server/deb/debian trixie main
729-
deb-src [signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa1.rabbitmq.com/rabbitmq/rabbitmq-server/deb/debian trixie main
730-
731-
# another mirror for redundancy
732-
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa2.rabbitmq.com/rabbitmq/rabbitmq-server/deb/debian trixie main
733-
deb-src [signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa2.rabbitmq.com/rabbitmq/rabbitmq-server/deb/debian trixie main
734-
EOF
735-
```
736-
</TabItem>
737591
</Tabs>
738592

739593

@@ -1201,8 +1055,7 @@ contents will vary from Ubuntu version to Ubuntu version.
12011055
```bash
12021056
# This Launchpad PPA repository provides Erlang packages produced by the RabbitMQ team
12031057
#
1204-
# Replace $distribution with the name of the Ubuntu release used. On Debian,
1205-
# use "bionic"
1058+
# Replace $distribution with the name of the Ubuntu release used
12061059
deb [arch=amd64 signed-by=/usr/share/keyrings/net.launchpad.ppa.rabbitmq.erlang.gpg] http://ppa.launchpad.net/rabbitmq/rabbitmq-erlang/ubuntu noble main
12071060
deb-src [signed-by=/usr/share/keyrings/net.launchpad.ppa.rabbitmq.erlang.gpg] http://ppa.launchpad.net/rabbitmq/rabbitmq-erlang/ubuntu noble main
12081061
```
@@ -1213,8 +1066,7 @@ deb-src [signed-by=/usr/share/keyrings/net.launchpad.ppa.rabbitmq.erlang.gpg] ht
12131066
```bash
12141067
# This Launchpad PPA repository provides Erlang packages produced by the RabbitMQ team
12151068
#
1216-
# Replace $distribution with the name of the Ubuntu release used. On Debian,
1217-
# use "bionic"
1069+
# Replace $distribution with the name of the Ubuntu release used
12181070
deb [arch=amd64 signed-by=/usr/share/keyrings/net.launchpad.ppa.rabbitmq.erlang.gpg] http://ppa.launchpad.net/rabbitmq/rabbitmq-erlang/ubuntu jammy main
12191071
deb-src [signed-by=/usr/share/keyrings/net.launchpad.ppa.rabbitmq.erlang.gpg] http://ppa.launchpad.net/rabbitmq/rabbitmq-erlang/ubuntu jammy main
12201072
```
@@ -1224,8 +1076,7 @@ deb-src [signed-by=/usr/share/keyrings/net.launchpad.ppa.rabbitmq.erlang.gpg] ht
12241076
```bash
12251077
# This Launchpad PPA repository provides Erlang packages produced by the RabbitMQ team
12261078
#
1227-
# Replace $distribution with the name of the Ubuntu release used. On Debian,
1228-
# use "bionic"
1079+
# Replace $distribution with the name of the Ubuntu release used
12291080
deb [arch=amd64 signed-by=/usr/share/keyrings/net.launchpad.ppa.rabbitmq.erlang.gpg] http://ppa.launchpad.net/rabbitmq/rabbitmq-erlang/ubuntu focal main
12301081
deb-src [signed-by=/usr/share/keyrings/net.launchpad.ppa.rabbitmq.erlang.gpg] http://ppa.launchpad.net/rabbitmq/rabbitmq-erlang/ubuntu focal main
12311082
```

0 commit comments

Comments
 (0)