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 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

As of Debian 10 (buster) you 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

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


  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 bookworm-updates
  Components: main contrib non-free non-free-firmware
  PDiffs: no

  Types: deb
  URIs: https://security.debian.org
  Suites: bookworm-security
  Components: main contrib non-free non-free-firmware
  PDiffs: no
  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/apt.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/apt.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


  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/apt.progress-linux.org.gpg


  # 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 sh -c "apt update && apt upgrade && apt dist-upgrade && apt clean && apt autoremove --purge"

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