Installation

1. Installation of Debian

We currently don't provide any installer images that are Progress Linux specific. Therefore you need to first install Debian. There is a lot of good documentation on the internet on how to do that.

2. Upgrading from Debian

Debian systems can be upgraded to Progress Linux by:

either by using the progress-linux package to create the necessary repository configuration automatically
or by doing everything manually

It does not matter which way you choose as the manual instructions below result in the exact same configuration.

2.1 Assisted upgrade from Debian

Debian 10 (buster) or newer can upgrade to Progress Linux directly.


  sudo apt install progress-linux

If you don't see any Debconf configuration dialogs, you may have a too high Debconf priority configured. In this case run a package reconfigure.


  sudo dpkg-reconfigure -plow progress-linux

After enabling the desired repositories, upgrade your system.


  sudo apt update
  sudo apt upgrade
  sudo apt full-upgrade
  sudo apt autopurge

2.2 Manual upgrade from Debian

If you prefer not using the assisted upgrade, here's an example on how to manually upgrade from a Debian 12 (bookworm) system to the corresponding Progress Linux release.


  sudo apt install --yes --no-install-recommends ca-certificates gnupg debian-keyring wget


  sudo mkdir -p /usr/share/progress-linux/pgp-keys
  sudo wget https://deb.progress-linux.org/packages/project/pgp/progress-linux-7-graograman-archive-key.pub -O /usr/share/progress-linux/pgp-keys/deb.progress-linux.org.gpg
  sudo wget https://deb.progress-linux.org/packages/project/pgp/progress-linux-7-graograman-archive-key.pub.sig -O /usr/share/progress-linux/pgp-keys/deb.progress-linux.org.gpg.sig

  gpg --keyring /usr/share/keyrings/debian-keyring.gpg --keyring /usr/share/keyrings/debian-maintainers.gpg --verify /usr/share/progress-linux/pgp-keys/deb.progress-linux.org.gpg.sig
  rm -f /usr/share/progress-linux/pgp-keys/deb.progress-linux.org.gpg.sig

  sudo gpg --import /usr/share/progress-linux/pgp-keys/deb.progress-linux.org.gpg
  sudo rm -f /usr/share/progress-linux/pgp-keys/deb.progress-linux.org.gpg
  sudo gpg -o /usr/share/progress-linux/pgp-keys/deb.progress-linux.org.gpg --export 0650B427DE77D598819129B47A8EB2C58FE6A7E6


  cat > /etc/apt/sources.list.d/debian.sources << EOF
  # /etc/apt/sources.list.d/debian.sources

  Types: deb
  URIs: https://deb.debian.org/debian
  Suites: bookworm
  Components: main contrib non-free non-free-firmware
  PDiffs: no
  Signed-By: /usr/share/keyrings/debian-archive-bookworm-stable.gpg

  Types: deb
  URIs: https://deb.debian.org/debian
  Suites: bookworm-updates
  Components: main contrib non-free non-free-firmware
  PDiffs: no
  Signed-By: /usr/share/keyrings/debian-archive-bookworm-automatic.gpg

  Types: deb
  URIs: https://security.debian.org
  Suites: bookworm-security
  Components: main contrib non-free non-free-firmware
  PDiffs: no
  Signed-By: /usr/share/keyrings/debian-archive-bookworm-security-automatic.gpg
  EOF


  cat > /etc/apt/sources.list.d/progress-linux.sources << EOF
  # /etc/apt/sources.list.d/progress-linux.sources

  Types: deb
  URIs: https://deb.progress-linux.org/packages
  Suites: graograman graograman-security graograman-updates graograman-backports
  Components: main contrib non-free non-free-firmware
  PDiffs: no
  Signed-By: /usr/share/progress-linux/pgp-keys/deb.progress-linux.org.gpg

  Types: deb
  URIs: https://deb.progress-linux.org/packages
  Suites: graograman-extras graograman-backports-extras
  Components: main contrib non-free non-free-firmware restricted
  PDiffs: no
  Signed-By: /usr/share/progress-linux/pgp-keys/deb.progress-linux.org.gpg
  EOF


  cat > /etc/apt/preferences.d/progress-linux.pref << EOF
  # /etc/apt/preferences.d/progress-linux.pref

  Package: *
  Pin: release n=graograman
  Pin-Priority: 999

  Package: *
  Pin: release n=graograman-security
  Pin-Priority: 999

  Package: *
  Pin: release n=graograman-updates
  Pin-Priority: 999

  Package: *
  Pin: release n=graograman-extras
  Pin-Priority: 999

  Package: *
  Pin: release n=graograman-backports
  Pin-Priority: 999

  Package: *
  Pin: release n=graograman-backports-extras
  Pin-Priority: 999
  EOF


  # If you have no other custom repositories, you can remove your old sources.list
  sudo rm -f /etc/apt/sources.list /etc/apt/sources.list~


  sudo apt update
  sudo apt upgrade
  sudo apt full-upgrade
  sudo apt autopurge

3. Metapackages

3.1 Base System


  sudo apt install progress-linux-host progress-linux-base-system

3.2 GNOME Desktop


  sudo apt install progress-linux-host progress-linux-gnome-desktop

3.3 Container Server


  sudo apt install progress-linux-host progress-linux-container-server