FASTPANELWIKI

OS Upgrade

Upgrade Debian 10 to Debian 11

On this page

Description

In this article, we will describe the process of upgrading the OS from Debian 10 to Debian 11.

Upgrading

WARNING

Before upgrading the operating system, we strongly recommend making a full backup of all data on the server. This will serve as an insurance policy in case of problems, allowing you to restore the system in the event of an emergency.

important

All commands during OS upgrade are executed in the server terminal under the root user.

Refuse system suggestions to replace configuration files (default action).

The names of repository files in /etc/apt/sources.list.d of your OS may be different from those used in these instructions.

  1. Make sure you have the correct repositories in /etc/apt/sources.list . The list of repositories for Debian 9 can be found below.
Debian 10 repositories
deb http://archive.debian.org/debian/ buster main contrib non-free
deb-src http://archive.debian.org/debian/ buster main contrib non-free
 
deb http://archive.debian.org/debian/ buster-updates main contrib non-free
deb-src http://archive.debian.org/debian/ buster-updates main contrib non-free
 
deb http://archive.debian.org/debian-security buster/updates main contrib non-free
deb-src http://archive.debian.org/debian-security buster/updates main contrib non-free
  1. Update all current packages to the latest versions
apt update && apt dist-upgrade
  1. Replace the list of repositories in /etc/apt/sources.list to those from Debian 11. The list of repositories for Debian 11 can be found below.
Debian 11 repositories
deb http://deb.debian.org/debian/ bullseye main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye main contrib non-free
 
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free
 
deb http://security.debian.org/debian-security bullseye-security main contrib non-free
deb-src http://security.debian.org/debian-security bullseye-security main contrib non-free
  1. Resolve potential proftpd update errors
sed -e 's/^IdentLookups/#IdentLookups/' -i /etc/proftpd/proftpd.conf
  1. Update packages. Run the following commands one at a time
apt update
apt upgrade
apt dist-upgrade
  1. Update other repositories
sed -i 's|buster|bullseye|g' /etc/apt/sources.list.d/*.list
  1. Add nginx repository keys
wget -q -O - http://nginx.org/keys/nginx_signing.key |apt-key add -
important

The Debian 11 repository does not have older versions of the database servers. To upgrade further, you need to specify versions 8.0 and 10.5 for MySQL and MariaDB respectively in /etc/apt/sources.list.d/. You can find out the current database server version by executing the command

mysql -V

If MySQL is used, change the package version and add the repository key:

sed -i 's/mysql-5.7/mysql-8.0/g' /etc/apt/sources.list.d/mysql.list
wget -q -O - http://repo.mysql.com/RPM-GPG-KEY-mysql |apt-key add -

For MariaDB less then 10.5 use:

sed -i 's/10.[0-4]/10.9/' /etc/apt/sources.list.d/mariadb.list
  1. Update packages
apt update
apt dist-upgrade
  1. Install PHP 7.3 with base modules, PHP7.3-FPM and the Apache2 module
dpkg -l | awk '/php7.3/ {print $2}' | sed -e 's/7.3/7.4/'  | xargs apt install -y

apt install -f php php-fpm libapache2-mod-php libapache2-mod-php7.4 php-common php7.4-cgi php7.4-cli php7.4-common php7.4-curl php7.4-gd php7.4-json php7.4-mbstring php7.4-mysql php7.4-opcache php7.4-readline php7.4-xml php7.4-xmlrpc php-imagick php-memcached

phpenmod calendar ctype curl dom exif fileinfo ftp gd gettext iconv json mbstring mysqli mysqlnd pdo pdo_mysql phar posix readline shmop simplexml sockets sysvmsg sysvsem sysvshm tokenizer wddx xml xmlreader xmlrpc xmlwriter xsl opcache imagick memcached
  1. Replace PHP-FPM configurations
mv /opt/php74/etc/php-fpm.d/* /etc/php/7.4/fpm/pool.d/

rm /etc/php/7.3/fpm/pool.d/www.conf

mv /etc/php/7.3/fpm/pool.d/* /opt/php73/etc/php-fpm.d/
  1. Remove PHP 7.3
apt purge php7.3*
  1. Activate PHP 7.4
a2enmod php7.4
  1. Correct PHP version in FASTPANEL base
sqlite3 /usr/local/fastpanel2/app/db/fastpanel2.db "update site set php_version = 74 where mode = 'mpm_itk';"
  1. Install the Dovecot component required for receiving mail
apt install dovecot-lmtpd
  1. Reconfigure services
mogwai services configure -f
  1. Additional configuration depending on the database server used

For MySQL 8 - add compatibility settings

echo 'disable-log-bin
mysqlx                         = OFF
default-authentication-plugin  = mysql_native_password
character-set-server           = utf8
collation-server               = utf8_unicode_ci
' >> /etc/mysql/my.cnf.fastpanel/99-fastpanel.cnf

For MariaDB - run mysql_upgrade

mysql_upgrade
  1. Restart the server
reboot
  1. Make sure that all services are started after reboot
systemctl --failed

Upgrade complete.

Upgrade Debian 11 to Debian 12

On this page

Description

In this article, we will describe the process of upgrading the OS from Debian 11 to Debian 12.

Upgrading

WARNING

Before upgrading the operating system, we strongly recommend making a full backup of all data on the server. This will serve as an insurance policy in case of problems, allowing you to restore the system in the event of an emergency.

important

All commands during OS upgrade are executed in the server terminal under the root user.

Refuse system suggestions to replace configuration files (default action).

The names of repository files in /etc/apt/sources.list.d of your OS may be different from those used in these instructions.

  1. Make sure you have the correct repositories in /etc/apt/sources.list . The list of repositories for Debian 11 can be found below.
Debian 11 repositories
deb http://deb.debian.org/debian/ bullseye main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye main contrib non-free
 
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free
 
deb http://security.debian.org/debian-security bullseye-security main contrib non-free
deb-src http://security.debian.org/debian-security bullseye-security main contrib non-free
  1. Update all current packages to the latest versions
apt update && apt dist-upgrade
  1. Replace the list of repositories in /etc/apt/sources.list to repositories from Debian 12. The list of repositories for Debian 12 can be found below.
Debian 12 repositories
deb http://deb.debian.org/debian/ bookworm main contrib non-free
deb-src http://deb.debian.org/debian/ bookworm main contrib non-free

deb http://deb.debian.org/debian/ bookworm-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bookworm-updates main contrib non-free

deb http://deb.debian.org/debian-security bookworm-security main contrib non-free
deb-src http://deb.debian.org/debian-security bookworm-security main contrib non-free
  1. Resolving potential apache2 upgrade errors
a2dismod php7.4
  1. Update packages. Run the following commands one at a time
apt update
apt upgrade
apt dist-upgrade
  1. Updating other repositories
sed -i 's|bullseye|bookworm|g' /etc/apt/sources.list.d/*.list
  1. Add nginx repository keys
wget -q -O - http://nginx.org/keys/nginx_signing.key |apt-key add -
important

If MariaDB is used on the server, we need to correct the repository to specify a version of at least 10.11.

You can find out the version of the database server in use by running the command

mysql -V

If MySQL is used, correct the repository, update its key and add the Debian 11 security repository:

sed -i 's|bookworm|bullseye|g' /etc/apt/sources.list.d/mysql.list
echo "deb http://security.debian.org/debian-security bullseye-security main" > /etc/apt/sources.list.d/bullseye-security.list
wget -q -O - http://repo.mysql.com/RPM-GPG-KEY-mysql |apt-key add -

For MariaDB less then 10.5 use:

sed 's/10.[0-9]/11.1/' /etc/apt/sources.list.d/mariadb.list
  1. Update packages
apt update
apt dist-upgrade
  1. Install PHP 8.2 with base modules, PHP7.3-FPM and the Apache2 module
apt install -f php php-fpm libapache2-mod-php libapache2-mod-php8.2 php-common php8.2-cgi php8.2-cli php8.2-common php8.2-curl php8.2-gd php8.2-mbstring php8.2-mysql php8.2-opcache php8.2-readline php8.2-xml php8.2-xmlrpc php-imagick php-memcached

phpenmod calendar ctype curl dom exif fileinfo ftp gd gettext iconv mbstring mysqli mysqlnd pdo pdo_mysql phar posix readline shmop simplexml sockets sysvmsg sysvsem sysvshm tokenizer xml xmlreader xmlrpc xmlwriter xsl opcache imagick memcached
  1. Move PHP-FPM configurations
mv /opt/php82/etc/php-fpm.d/* /etc/php/8.2/fpm/pool.d/

rm /etc/php/7.4/fpm/pool.d/www.conf

mv /etc/php/7.4/fpm/pool.d/* /opt/php74/etc/php-fpm.d/
  1. Replace PHP 7.4
apt-get purge php7.4*
  1. Activate PHP 8.2
a2enmod php8.2
  1. Correct PHP version in FASTPANEL base
sqlite3 /usr/local/fastpanel2/app/db/fastpanel2.db "update site set php_version = 82 where mode = 'mpm_itk';"
  1. Install the Dovecot component required for receiving mail
apt install dovecot-lmtpd
  1. Reconfigure services
mogwai services configure -f
  1. Additional configuration depending on the database server used

For MariaDB - run mysql_upgrade

mysql_upgrade
  1. Restart the server
reboot
  1. Make sure that all services are started after reboot
systemctl --failed

Upgrade complete.

Upgrade Debian 9 to Debian 10

On this page

Description

In this article, we will describe the process of upgrading the OS from Debian 9 to Debian 10.

Upgrading

WARNING

Before upgrading the operating system, we strongly recommend making a full backup of all data on the server. This will serve as an insurance policy in case of problems, allowing you to restore the system in the event of an emergency.

important

All commands during OS upgrade are executed in the server terminal under the root user.

Refuse system suggestions to replace configuration files (default action).

The names of repository files in /etc/apt/sources.list.d of your OS may be different from those used in these instructions.

  1. Make sure you have the correct repositories in /etc/apt/sources.list . The list of repositories for Debian 9 can be found below.
Debian 9 repositories
deb http://archive.debian.org/debian/ stretch main contrib non-free
deb-src http://archive.debian.org/debian/ stretch main contrib non-free
  
deb http://archive.debian.org/debian-security/ stretch/updates main contrib non-free
deb-src http://archive.debian.org/debian-security/ stretch/updates main contrib non-free
  1. Update all current packages to the latest versions
apt update && apt dist-upgrade
  1. Replace the list of repositories in /etc/apt/sources.list to repositories from Debian 10. The list of repositories for Debian 10 can be found below.
Debian 10 repositories
deb http://archive.debian.org/debian/ buster main contrib non-free
deb-src http://archive.debian.org/debian/ buster main contrib non-free
 
deb http://archive.debian.org/debian/ buster-updates main contrib non-free
deb-src http://archive.debian.org/debian/ buster-updates main contrib non-free
 
deb http://archive.debian.org/debian-security buster/updates main contrib non-free
deb-src http://archive.debian.org/debian-security buster/updates main contrib non-free
  1. Update packages. Run the following commands one at a time
apt update
apt upgrade
apt dist-upgrade
  1. Update other repositories
sed -i 's|stretch|buster|g' /etc/apt/sources.list.d/*.list
  1. Add repository keys from MySQL and nginx
wget -q -O - http://repo.mysql.com/RPM-GPG-KEY-mysql |apt-key add -  

wget -q -O - http://nginx.org/keys/nginx_signing.key |apt-key add -  

apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 467B942D3A79BD29
  1. Update packages
apt update

apt dist-upgrade
  1. Install PHP 7.3 with base modules, PHP7.3-FPM and the Apache2 module
dpkg -l | awk '/php7.0/ {print $2}' | sed -e 's/7.0/7.3/' | grep -v mcrypt | xargs apt install -y 

apt install -f php php-fpm libapache2-mod-php libapache2-mod-php7.3 php-common php7.3-cgi php7.3-cli php7.3-common php7.3-curl php7.3-gd php7.3-json php7.3-mbstring php7.3-mysql php7.3-opcache php7.3-readline php7.3-xml php7.3-xmlrpc php-imagick php-memcached 

phpenmod calendar ctype curl dom exif fileinfo ftp gd gettext iconv json mbstring mysqli mysqlnd pdo pdo_mysql phar posix readline shmop simplexml sockets sysvmsg sysvsem sysvshm tokenizer wddx xml xmlreader xmlrpc xmlwriter xsl opcache imagick memcached
  1. Replace PHP-FPM configurations
mv /opt/php73/etc/php-fpm.d/* /etc/php/7.3/fpm/pool.d/

rm /etc/php/7.0/fpm/pool.d/www.conf

mv /etc/php/7.0/fpm/pool.d/* /etc/php/7.3/fpm/pool.d/
  1. Remove PHP 7.0
apt purge php7.0*
  1. Activate PHP 7.3
a2enmod php7.3
  1. Correct PHP version in FASTPANEL base
sqlite3 /usr/local/fastpanel2/app/db/fastpanel2.db "update site set php_version = 73 where mode = 'mpm_itk';"
  1. Fixing dovecot
mv /etc/dovecot/private/dovecot{.pem,.key}
mv /etc/dovecot/dovecot.pem /etc/dovecot/private/dovecot.pem

apt install dovecot-lmtpd
  1. Reconfigure services
mogwai services configure -f
  1. Reboot the server
reboot
  1. Make sure that all services are started after reboot
systemctl --failed

Upgrade complete

Description

FASTPANEL® supports upgrading major versions of OS distributions. In this section we describe the procedure for upgrading Debian/Ubuntu distributions with FASTPANEL installed.

important

Despite the benefits of upgrading, you should keep in mind that the upgrade process does not always go smoothly. Updating your operating system can lead to undesirable consequences, including compatibility issues with outdated software, system malfunctions and even data loss.

Upgrade Ubuntu 18 to Ubuntu 20

On this page

Description

In this article, we will describe the process of upgrading the OS from Ubuntu 18.04 to Ubuntu 20.04.

Upgrading

WARNING

Before upgrading the operating system, we strongly recommend making a full backup of all data on the server. This will serve as an insurance policy in case of problems, allowing you to restore the system in the event of an emergency.

important

All commands during OS upgrade are executed in the server terminal under the root user.

Refuse system suggestions to replace configuration files (default action).

The names of repository files in /etc/apt/sources.list.d of your OS may be different from those used in these instructions.

  1. Make sure you have the correct repositories in /etc/apt/sources.list . The list of repositories for Ubuntu 18.04 can be found below.
Ubuntu 18 repositories
### Main repo for Ubuntu bionic
deb http://archive.ubuntu.com/ubuntu/ bionic main restricted universe multiverse  
deb-src http://archive.ubuntu.com/ubuntu/ bionic main restricted universe multiverse

### Updates repo for Ubuntu bionic
deb http://archive.ubuntu.com/ubuntu/ bionic-updates main restricted universe multiverse  
deb-src http://archive.ubuntu.com/ubuntu/ bionic-updates main restricted universe multiverse

### Security repo for Ubuntu bionic
deb http://security.ubuntu.com/ubuntu bionic-security main restricted universe multiverse  
deb-src http://security.ubuntu.com/ubuntu bionic-security main restricted universe multiverse

### Backports repo for Ubuntu bionic
deb http://archive.ubuntu.com/ubuntu/ bionic-backports main restricted universe multiverse  
deb-src http://archive.ubuntu.com/ubuntu/ bionic-backports main restricted universe multiverse

### Proposed repo for Ubuntu bionic
deb http://archive.ubuntu.com/ubuntu/ bionic-proposed main restricted universe multiverse  
deb-src http://archive.ubuntu.com/ubuntu/ bionic-proposed main restricted universe multiverse
  1. Update all current packages to the latest versions
apt update && apt dist-upgrade
  1. Resolve potential proftpd and apache2 upgrade errors
a2dismod php7.2
sed -e 's/^IdentLookups/#IdentLookups/' -i /etc/proftpd/proftpd.conf
  1. Remove all query-cache entries from the mysql configuration and adjust the mysql repository:
sed -i 's/^query[_,-]cache[^ ]*//' /etc/mysql/my.cnf.fastpanel/99-fastpanel.cnf
  1. Run the update
do-release-upgrade --allow-third-party

If for some reason the utility is not installed, you can fix it with the command

apt install update-manager-core
important

Carefully read the output of the utility before confirming, make sure that nothing unnecessary will be deleted in the process.

The upgrade is considered successful if the system prompts you to restart the server.

Accept the reboot

  1. Install PHP 7.4 with base modules, PHP7.4-FPM and the module for Apache2
apt-get install -f php php-fpm libapache2-mod-php libapache2-mod-php7.4 php-common php7.4-cgi php7.4-cli php7.4-common php7.4-curl php7.4-gd php7.4-json php7.4-mbstring php7.4-mysql php7.4-opcache php7.4-readline php7.4-xml php7.4-xmlrpc php-imagick php-memcached

phpenmod calendar ctype curl dom exif fileinfo ftp gd gettext json iconv mbstring mysqli mysqlnd pdo pdo_mysql phar posix readline shmop simplexml sockets sysvmsg sysvsem sysvshm tokenizer  xml xmlreader xmlrpc xmlwriter xsl opcache imagick memcached 
  1. Replace PHP-FPM configuration
mv /opt/php74/etc/php-fpm.d/* /etc/php/7.4/fpm/pool.d/
rm /etc/php/7.2/fpm/pool.d/www.conf
mv /etc/php/7.2/fpm/pool.d/* /etc/php/7.4/fpm/pool.d/
  1. Correct PHP version in FASTPANEL base
sqlite3 /usr/local/fastpanel2/app/db/fastpanel2.db "update site set php_version = 74 where mode = 'mpm_itk';"
  1. Install the Dovecot component required for receiving mail
apt install dovecot-lmtpd
  1. Reconfigure services
mogwai services configure -f
  1. Additional configuration depending on the database server used

For MySQL 8 - add compatibility settings

echo 'disable-log-bin
mysqlx                         = OFF
default-authentication-plugin  = mysql_native_password
character-set-server           = utf8
collation-server               = utf8_unicode_ci
' >> /etc/mysql/my.cnf.fastpanel/99-fastpanel.cnf

For MariaDB - run mysql_upgrade

mysql_upgrade
  1. Restart the server
reboot
  1. Make sure that all services are started after reboot
systemctl --failed

Upgrade complete.

Upgrade Ubuntu 20 to Ubuntu 22

On this page

Description

In this article, we will describe the process of upgrading the OS from Ubuntu 20.04 to Ubuntu 22.04.

Upgrading

WARNING

Before upgrading the operating system, we strongly recommend making a full backup of all data on the server. This will serve as an insurance policy in case of problems, allowing you to restore the system in the event of an emergency.

important

All commands during OS upgrade are executed in the server terminal under the root user.

Refuse system suggestions to replace configuration files (default action).

The names of repository files in /etc/apt/sources.list.d of your OS may be different from those used in these instructions.

  1. Make sure you have the correct repositories in /etc/apt/sources.list . The list of repositories for Ubuntu 20.04 can be found below.
Ubuntu 20 repositories
### Main repo for Ubuntu focal
deb http://archive.ubuntu.com/ubuntu/ focal main restricted universe multiverse  
deb-src http://archive.ubuntu.com/ubuntu/ focal main restricted universe multiverse

### Updates repo for Ubuntu focal
deb http://archive.ubuntu.com/ubuntu/ focal-updates main restricted universe multiverse  
deb-src http://archive.ubuntu.com/ubuntu/ focal-updates main restricted universe multiverse

### Security repo for Ubuntu focal
deb http://security.ubuntu.com/ubuntu focal-security main restricted universe multiverse  
deb-src http://security.ubuntu.com/ubuntu focal-security main restricted universe multiverse

### Backports repo for Ubuntu focal
deb http://archive.ubuntu.com/ubuntu/ focal-backports main restricted universe multiverse  
deb-src http://archive.ubuntu.com/ubuntu/ focal-backports main restricted universe multiverse

### Proposed repo for Ubuntu focal
deb http://archive.ubuntu.com/ubuntu/ focal-proposed main restricted universe multiverse  
deb-src http://archive.ubuntu.com/ubuntu/ focal-proposed main restricted universe multiverse
  1. Update all current packages to the latest versions
apt update && apt dist-upgrade
  1. Resolve potential proftpd and apache2 upgrade errors
a2dismod php7.4

sed -e 's/^IdentLookups/#IdentLookups/' -i /etc/proftpd/proftpd.conf
  1. Run the upgrade
do-release-upgrade --allow-third-party

If for some reason the utility is not installed, you can fix it with the command

apt install update-manager-core
important

Carefully read the output of the utility before confirming, make sure that nothing unnecessary will be deleted in the process.

The upgrade is considered successful if the system prompts you to restart the server.

Accept the reboot

  1. Install PHP 8.1 with base modules, PHP8.1-FPM and the module for Apache2
apt install -f php php-fpm libapache2-mod-php libapache2-mod-php8.1 php-common php8.1-cgi php8.1-cli php8.1-common php8.1-curl php8.1-gd php8.1-mbstring php8.1-mysql php8.1-opcache php8.1-readline php8.1-xml php8.1-xmlrpc php-imagick php-memcached

phpenmod calendar ctype curl dom exif fileinfo ftp gd gettext iconv mbstring mysqli mysqlnd pdo pdo_mysql phar posix readline shmop simplexml sockets sysvmsg sysvsem sysvshm tokenizer  xml xmlreader xmlrpc xmlwriter xsl opcache imagick memcached 
  1. Replace PHP-FPM configuration
mv /opt/php81/etc/php-fpm.d/* /etc/php/8.1/fpm/pool.d/

rm /etc/php/7.4/fpm/pool.d/www.conf

mv /etc/php/7.4/fpm/pool.d/* /opt/php74/etc/php-fpm.d/
  1. Remove PHP 7.4
apt purge php7.4*
  1. Activate PHP 8.1
a2enmod php8.1
  1. Correct PHP version in FASTPANEL base
sqlite3 /usr/local/fastpanel2/app/db/fastpanel2.db "update site set php_version = 81 where mode = 'mpm_itk';"
  1. Install the Dovecot component required for receiving mail
apt install dovecot-lmtpd
  1. Reconfigure services
mogwai services configure -f
  1. Restart the server
reboot
  1. Make sure that all services are started after reboot
systemctl --failed

Upgrade complete.

Upgrade Ubuntu 22 to Ubuntu 24

On this page

Description

In this article, we will describe the process of upgrading the OS from Ubuntu 22.04 to Ubuntu 24.04.

Upgrading

WARNING

Before upgrading the operating system, we strongly recommend making a full backup of all data on the server. This will serve as an insurance policy in case of problems, allowing you to restore the system in the event of an emergency.

important

All commands during OS upgrade are executed in the server terminal under the root user.

Refuse system suggestions to replace configuration files (default action).

The names of repository files in /etc/apt/sources.list.d of your OS may be different from those used in these instructions.

  1. Make sure you have the correct repositories in /etc/apt/sources.list . The list of repositories for Ubuntu 22.04 can be found below.
Ubuntu 22 repositories
### Main repo for Ubuntu jammy
deb http://archive.ubuntu.com/ubuntu/ jammy main restricted universe multiverse  
deb-src http://archive.ubuntu.com/ubuntu/ jammy main restricted universe multiverse

### Updates repo for Ubuntu jammy
deb http://archive.ubuntu.com/ubuntu/ jammy-updates main restricted universe multiverse  
deb-src http://archive.ubuntu.com/ubuntu/ jammy-updates main restricted universe multiverse

### Security repo for Ubuntu jammy
deb http://security.ubuntu.com/ubuntu jammy-security main restricted universe multiverse  
deb-src http://security.ubuntu.com/ubuntu jammy-security main restricted universe multiverse

### Backports repo for Ubuntu jammy
deb http://archive.ubuntu.com/ubuntu/ jammy-backports main restricted universe multiverse  
deb-src http://archive.ubuntu.com/ubuntu/ jammy-backports main restricted universe multiverse

### Proposed repo for Ubuntu jammy
deb http://archive.ubuntu.com/ubuntu/ jammy-proposed main restricted universe multiverse  
deb-src http://archive.ubuntu.com/ubuntu/ jammy-proposed main restricted universe multiverse
  1. Update all current packages to the latest versions
apt update && apt dist-upgrade
  1. Resolve potential proftpd and apache2 upgrade errors
a2dismod php8.3

sed -e 's/^IdentLookups/#IdentLookups/' -i /etc/proftpd/proftpd.conf
  1. Run the upgrade
do-release-upgrade --allow-third-party

If for some reason the utility is not installed, you can fix it with the command

apt install update-manager-core
important

Carefully read the output of the utility before confirming, make sure that nothing unnecessary will be deleted in the process.

The upgrade is considered successful if the system prompts you to restart the server.

Accept the reboot

  1. Install PHP 8.3 with base modules, PHP8.3-FPM and the module for Apache2
apt install -f php php-fpm libapache2-mod-php libapache2-mod-php8.3 php-common php8.3-cgi php8.3-cli php8.3-common php8.3-curl php8.3-gd php8.3-mbstring php8.3-mysql php8.3-opcache php8.3-readline php8.3-xml php8.3-xmlrpc php-imagick php-memcached

phpenmod calendar ctype curl dom exif fileinfo ftp gd gettext iconv mbstring mysqli mysqlnd pdo pdo_mysql phar posix readline shmop simplexml sockets sysvmsg sysvsem sysvshm tokenizer  xml xmlreader xmlrpc xmlwriter xsl opcache imagick memcached 
  1. Replace PHP-FPM configuration
mv /opt/php83/etc/php-fpm.d/* /etc/php/8.3/fpm/pool.d/

rm /etc/php/8.1/fpm/pool.d/www.conf

mv /etc/php/8.1/fpm/pool.d/* /opt/php81/etc/php-fpm.d/
  1. Remove PHP 8.1
apt purge php8.1*
  1. Activate PHP 8.3
a2enmod php8.3
  1. Correct PHP version in FASTPANEL base
sqlite3 /usr/local/fastpanel2/app/db/fastpanel2.db "update site set php_version = 83 where mode = 'mpm_itk';"
  1. Install the Dovecot component required for receiving mail
apt install dovecot-lmtpd
  1. Reconfigure services
mogwai services configure -f
  1. Restart the server
reboot
  1. Make sure that all services are started after reboot
systemctl --failed

Upgrade complete.