{"id":45779258,"url":"https://github.com/plesk/centos2alma","last_synced_at":"2026-02-26T10:58:06.358Z","repository":{"id":154468929,"uuid":"584733091","full_name":"plesk/centos2alma","owner":"plesk","description":"CentOS 7 to AlmaLinux 8 conversion tool","archived":false,"fork":false,"pushed_at":"2026-02-13T13:44:24.000Z","size":689,"stargazers_count":44,"open_issues_count":46,"forks_count":11,"subscribers_count":23,"default_branch":"master","last_synced_at":"2026-02-13T22:41:12.600Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/plesk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-01-03T11:29:28.000Z","updated_at":"2026-02-13T13:44:24.000Z","dependencies_parsed_at":"2023-10-25T08:56:19.142Z","dependency_job_id":"91cfeac4-165b-44b7-a987-ccc49e6c0f9b","html_url":"https://github.com/plesk/centos2alma","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/plesk/centos2alma","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plesk%2Fcentos2alma","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plesk%2Fcentos2alma/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plesk%2Fcentos2alma/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plesk%2Fcentos2alma/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/plesk","download_url":"https://codeload.github.com/plesk/centos2alma/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plesk%2Fcentos2alma/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29856783,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-26T08:51:08.701Z","status":"ssl_error","status_checked_at":"2026-02-26T08:50:19.607Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-26T10:58:05.714Z","updated_at":"2026-02-26T10:58:06.351Z","avatar_url":"https://github.com/plesk.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Convert a CentOS 7 server with Plesk to AlmaLinux 8\n\nCentOS 7 to AlmaLinux 8 conversion tool\n\n## Introduction\nThis script is the official tool for converting a CentOS 7 server with Plesk to AlmaLinux 8. It uses the [AlmaLinux ELevate tool](https://wiki.almalinux.org/elevate/ELevate-quickstart-guide.html), which is based on the [leapp modernization framework](https://leapp.readthedocs.io/en/latest/). The script includes additional repository and configuration support provided by Plesk.\n\n## Preparation\nTo avoid downtime and data loss, make sure you have read and understood the following information before using the script:\n1. **Back up all your databases** and have the means to restore them. The script uses standard MariaDB and PostgreSQL tools to upgrade the databases, but this does not guarantee that the process will be free of issues.\n2. **Ensure that you have a way to restart the server without a direct SSH connection**. The conversion process may get stuck once the server boots into the temporary OS distribution that does not start any network interfaces. You can use a serial port connection to the server to monitor the status of the conversion process in real time, and to reboot the server if necessary.\n3. We strongly recommend that you **create a snapshot you can use as a recovery point** in case the conversion process fails.\n4. Read the [Known issues](#known-issues) section below for the list of known issues.\n\n## Timing\nThe conversion process should run between 30 and 60 minutes. **Plesk services, hosted websites, and emails will be unavailable during the entirety of the conversion process**. The conversion process itself consists of three stages:\n- Preparation, which takes between 15 and 25 minutes.\n- Conversion, which takes between 15 and 30 minutes. During this stage, the server will not be available remotely. You can monitor the progress via a serial port console.\n- Finalization, which takes between 5 and 10 minutes.\n\n## Known issues\n### Blockers\nDo not use the script if any of the following is true:\n- **You are running an OS other than CentOS 7.9**. The script was not tested on other Red Hat Enterprise Linux 7-based distributions. The conversion process may have unexpected results if started on a server not running CentOS 7.9. So we add checks to avoid any actions on such kinds of servers.\n- **Plesk version is more than five releases behind the latest version**. The script is only compatible with the most recent versions of Plesk. It will prevent conversion if Plesk version is outdated.\n- **PHP 5.5 and earlier are not supported** in AlmaLinux 8, and will not receive any updates after the conversion. These PHP versions are deprecated and may have security vulnerabilities. So we force to remove this versions before the conversion.\n- **Conversion inside containers (like Virtuozzo containers, Docker Containers, etc) are not supported**. \n- **More than one kernel named interfaces (like ethX) are not supported**. Stability of such names are not guaranteed, so leapp prevent the conversion in such cases.\n- **No ELS repositories on the server**. The script won't be able to install the necessary packages at the final stage due to conflicts between AlmaLinux 8 repositories and ELS repositories. **However, the script can handle ELS provided by the Plesk TuxCare ELS extension**.\n\n## Requirements\n- Plesk version is no older than five releases back from the latest version\n- CentOS 7.9 or later\n- GRUB 2 is installed\n- Minimum of 5 GB of free disk space\n- Minimum of 1 GB of RAM\n- The Linux kernel package must be signed by Red Hat. This is typically the case if you have installed the kernel from the official CentOS repositories\n\n## Conversion pre-requisites\nBefore the conversion process can begin, certain requirements must be fulfilled. The script will automatically verify these conditions and will not start the conversion if any are unmet. Most of these checks match those performed by the leapp preupgrade, thereby avoiding a conversion that would be halted by leapp, which prevents unnecessary interruption of Plesk services.\n\nYou can manually run all pre-checks using the command line options `-c` or `--precheck`:\n```shell\n\u003e ./centos2alma --precheck\n```\n\n## Using the script\nTo retrieve the latest available version of the tool, please navigate to the \"Releases\" section. Once there, locate the most recent version of the tool and download the zip archive. The zip archive will contain the centos2alma tool binary.\n\nTo prepare the latest version of the tool for use from a command line, please run the following commands:\n```shell\n\u003e wget https://github.com/plesk/centos2alma/releases/download/v1.4.14/centos2alma-1.4.14.zip\n\u003e unzip centos2alma-1.4.14.zip\n\u003e chmod 755 centos2alma\n```\n\nTo monitor the conversion process, we recommend using the ['screen' utility](https://www.gnu.org/software/screen/) to run the script in the background. To do so, run the following command:\n```shell\n\u003e screen -S centos2alma\n\u003e ./centos2alma\n```\nIf you lose your SSH connection to the server, you can reconnect to the screen session by running the following command:\n```shell\n\u003e screen -r centos2alma\n```\n\n\nYou can also call centos2alma in the background:\n```shell\n\u003e ./centos2alma \u0026\n```\nAnd monitor its status with the '--status' or '--monitor' flags:\n```shell\n\u003e ./centos2alma --status\n\u003e ./centos2alma --monitor\n... live monitor session ...\n```\n\n\nThis will start the conversion process. During the process, Plesk services will stop, and hosted websites will not be accessible. At the end of the preparation stage, the server will reboot.\nNext, a temporary OS distribution will be used to convert your CentOS 7 system to AlmaLinux 8. This process will take approximately 20 minutes. Once completed, the server will reboot once more. The centos2alma script will then perform the final stages of reconfiguring and restoring Plesk-related services, configurations, and databases. This will take some time, depending on the number of hosted websites.\nOnce the process is complete, the centos2alma script will reboot the server one last time. After that, Plesk should return to normal operation.\nOn the next SSH login, you will be greeted with the following message:\n```\n===============================================================================\nMessage from the Plesk centos2alma tool:\nThe server has been converted to AlmaLinux 8.\nYou can remove this message from the /etc/motd file.\n===============================================================================\n```\n\n### Conversion stage options\nThe conversion process consists of two stage options: \"start\", and \"finish\". To run stages individually, use the \"--start\", and \"--finish\" flags, or the \"-s\" flag with name of the stage you want to run.\n1. The \"start\" stage installs and configures ELevate, disables Plesk services and runs ELevate. It then stops Plesk services and reboots the server.\n2. The \"finish\" stage must be called on the first boot of AlmaLinux 8. You can rerun this stage if something goes wrong during the first boot to ensure that the problem is fixed and Plesk is ready to use.\n\nDuring each phase a conversion plan consisting of stages, which in turn consist of actions, is executed. You can see the general stages in the `--help` output and the detailed plan in the `--show-plan` output.\n\n### Other arguments\n\n### Logs\nIf something goes wrong, read the logs to identify the problem. You can also read the logs to check the status of the finish stage during the first boot.\nThe centos2alma writes its log to the '/var/log/plesk/centos2alma.log' file, as well as to stdout.\nThe ELevate writes its log to the '/var/log/leapp/leapp-upgrade.log' file. Reports can be found in the '/var/log/leapp/leapp-report.txt' and the '/var/log/leapp/leapp-report.json' files.\n\n### Revert\nIf the script fails during the the \"start\" stage before the reboot, you can use the centos2alma script with the '-r' or '--revert' flags to restore Plesk to normal operation. The centos2alma will undo some of the changes it made and restart Plesk services. Once you have resolved the root cause of the failure, you can attempt the conversion again.\nNote:\n- You cannot use revert to undo the changes after the first reboot triggered by centos2alma.\n- Revert does not remove Leapp or packages installed by Leapp. Neither does it free persistent storage disk space reserved by Leapp.\n\n### Check the status of the conversion process and monitor its progress\nTo check the status of the conversion process, use the '--status' flag. You can see the current stage of the conversion process, the elapsed time, and the estimated time until finish.\n```shell\n\u003e ./centos2alma --status\n```\n\nTo monitor the progress of the conversion process in real time, The conversion process can be monitored in real time using the '--monitor' flag.\n```shell\n\u003e ./centos2alma --monitor\n( stage 3 / action re-installing plesk components  ) 02:26 / 06:18\n```\n\n### Special cases\n\n#### Postgresql database before version 10 is installed\nBy default, the tool does not allow conversion when a PostgreSQL database version prior to 10 is installed. This restriction is in place to warn about the potential loss of data during the PostgreSQL upgrade that will be performed as part of the conversion process.\n\nIn such cases, you have two options:\n\n1. Upgrade PostgreSQL to version 10 manually before initiating the conversion.\n2. Create a complete backup of the database and force the conversion using the '--upgrade-postgres' flag.\n\n#### Adjusting Leapp Overlay Size\nThe default Leapp overlay size is 2048 MB. In the centos2alma tool, this is increased to 4096 MB. However, this may still be insufficient for handling all the required upgrade packages, leading to a \"Disk Requirements:\" error from Leapp. To prevent this issue, you can increase the overlay size using the '--leapp-overlay-size' flag. For example, to set the overlay size to 8192 MB, execute the following command:\n\n```shell\n\u003e ./centos2alma --leapp-overlay-size 8192\n```\n\n#### Perl modules installed by CPAN\nDuring the conversion process, if the tool detects Perl modules that were installed via CPAN and cannot determine their corresponding RPM packages, it will fail with a warning. This restriction is in place because such modules will not be available after the conversion. This issue often arises because CPAN-installed modules are specifically built for a particular version of Perl. Consequently, when Perl is updated during the conversion process, these module libraries may encounter errors related to undefined symbols.\n\nTo prevent this issue, there are steps you can check for RPM package analogues for the modules, remove the CPAN modules, and then reinstall them after the conversion is complete. It is recommended to use RPM packages for reinstallation, although reinstalling the modules via CPAN is also an option.\n\nThe centos2alma tool includes a list of RPM mappings for certain modules and can automatically reinstall them. The warning will only raise for modules that mapping to rpm package is unknown by the tool.\n\nIf you are confident that you no longer require the modules installed via CPAN, you can forcefully remove them by running the tool with the '--remove-unknown-perl-modules' flag.\n\n## Issue handling\n### Leapp unable to handle packages\nLeapp may not be able to handle certain installed packages, especially those installed from custom repositories. In this case, the centos2alma will fail while running leapp preupgrade or leapp upgrade. The easiest way to fix this issue is to remove the package(s), and then reinstall them once the conversion is complete.\n\n### Leapp cannot choose which package to install\nThis issue may occur if unsupported repositories are used. For instance, if an unexpected EPEL repository is enabled on the server, the cloudlinux7to8 process will fail when running `leapp preupgrade` or `leapp upgrade`. This is due to conflicting packages between the el8 and el7 repositories. The simplest way to resolve this issue is to switch to the standard repositories.\n\n### Temporary OS distribution hangs\nThis issue may occur, for example, if there is a custom python installation on the server. The conversion process will fail while upgrading the temporary OS distribution, and the temporary OS will hang with no notification. To identify the issue, connect to the server using a serial port console and check the status of the conversion process. To fix the issue, reboot the server. Note that an unfinished installation process may result in missing packages and other issues.\n\n### centos2alma finish fails on the first boot\nIf something goes wrong during the finish stage, you will be informed on the next SSH login with this message:\n```\n===============================================================================\nMessage from Plesk centos2alma tool:\nSomething went wrong during the final stage of CentOS 7 to AlmaLinux 8 conversion\nSee the /var/log/plesk/centos2alma.log file for more information.\nYou can remove this message from the /etc/motd file.\n===============================================================================\n```\nYou can read the centos2alma log to troubleshoot the issue. If the centos2alma finish stage fails for any reason, once you have resolved the root cause of the failure, you can retry by running:\n\n```shell\n\u003e ./centos2alma --resume\n```\n\n### Send feedback\nIf you got any error, please [create an issue on github](https://github.com/plesk/centos2alma/issues). To do generate feedback archive by calling the tool with '-f' or '--prepare-feedback' flags.\n```shell\n./centos2alma --prepare-feedback\n```\nDescribe your problem and attach the feedback archive to the issue.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplesk%2Fcentos2alma","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplesk%2Fcentos2alma","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplesk%2Fcentos2alma/lists"}