{"id":45779321,"url":"https://github.com/plesk/ubuntu18to20","last_synced_at":"2026-02-26T10:58:25.159Z","repository":{"id":203098451,"uuid":"708808812","full_name":"plesk/ubuntu18to20","owner":"plesk","description":"The tool to distupgrade Ubuntu 18 to Ubuntu 20","archived":false,"fork":false,"pushed_at":"2026-02-10T12:56:39.000Z","size":80,"stargazers_count":5,"open_issues_count":3,"forks_count":0,"subscribers_count":23,"default_branch":"master","last_synced_at":"2026-02-10T17:17:47.649Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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-10-23T12:42:26.000Z","updated_at":"2026-02-10T12:56:40.000Z","dependencies_parsed_at":"2023-10-26T14:21:48.118Z","dependency_job_id":"09ab6772-6ea1-4e13-930b-493c896e4b55","html_url":"https://github.com/plesk/ubuntu18to20","commit_stats":null,"previous_names":["plesk/ubuntu18to20"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/plesk/ubuntu18to20","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plesk%2Fubuntu18to20","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plesk%2Fubuntu18to20/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plesk%2Fubuntu18to20/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plesk%2Fubuntu18to20/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/plesk","download_url":"https://codeload.github.com/plesk/ubuntu18to20/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plesk%2Fubuntu18to20/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:23.884Z","updated_at":"2026-02-26T10:58:25.140Z","avatar_url":"https://github.com/plesk.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# The tool to dist-upgrade servers with Plesk from Ubuntu 18 to 20\n\n## Introduction\nThis utility is the official tool to dist-upgrade servers with Plesk from Ubuntu 18 to 20.\n\nThe utility uses [Plesk dist-upgrader](https://github.com/plesk/dist-upgrader).\n\n## Preparation\nTo avoid downtime and data loss, make sure you have read and understood the following information before using the utility:\n1. **Upgrade Plesk to the last version.**\n2. **Create a full server backup.** Before the upgrade, make a full server backup (which includes a full backup of all the databases).\n3. Notify the customers about upcoming downtime. Expected downtime is 20-30 minutes.\n4. **Remote management module must be installed on the server**.\n5. We strongly recommend that you **create a snapshot you can use as a recovery point** in case the conversion process fails.\n6. Read the [Known issues](#known-issues) section below for the list of known issues.\n\n## Timing\nThe conversion process should run between 20 and 30 minutes. **Plesk services, hosted websites, and e-mails will be unavailable during the entirety of the conversion process**.\n\n## Known issues\n### Blockers\nDo not use the utility if any of the following is true:\n- **Your system is in a container (like Virtuozzo containers, Docker Containers, etc).**\n\n## Requirements\n- Last Plesk version.\n- At least 5 GB of free disk space.\n- At least 2 GB of RAM.\n\n## Conversion phases\nThe conversion process consists of two phases:\n1. The \"convert\" phase contains preparation and upgrading actions.\n2. The \"finish\" phase is the last phase containing all finishing actions.\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## Using the utility\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 attached archive.\n\nTo prepare the latest version of the tool for use, please run the following commands:\n```shell\n\u003e wget https://github.com/plesk/ubuntu18to20/releases/download/v2.2.3/ubuntu18to20-2.2.3.zip\n\u003e unzip ubuntu18to20-2.2.3.zip\n\u003e chmod 755 ubuntu18to20\n```\n\nTo monitor the conversion process, we recommend using the ['screen' utility](https://www.gnu.org/software/screen/) to run the utility in the background. To do so, run the following command:\n```shell\n\u003e screen -S ubuntu18to20\n\u003e ./ubuntu18to20\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 ubuntu18to20\n```\n\nYou can also call ubuntu18to20 in the background:\n```shell\n\u003e ./ubuntu18to20 \u0026\n```\n\nAnd monitor its status with the '--status' or '--monitor' flags:\n```shell\n\u003e ./ubuntu18to20 --status\n\u003e ./ubuntu18to20 --monitor\n... live monitor session ...\n```\n\nThe conversion process requires 3 reboots. It will be resumed automatically after reboot by the `plesk-dist-upgrader` systemd service. In addition to `--status` and `--monitor`, you can check the status of the conversion process by running the following command:\n```shell\n\u003e systemctl status plesk-dist-upgrader\n```\n\nRunning dist-upgrader without any arguments initiates the conversion process. The utility performs preliminary checks, and if any issues are detected, it provides descriptions of the problems along with guidance on how to resolve them.\nFollowing the preliminary checks, the tool proceeds with the dist-upgrade process, which is divided into multiple stages. Some stages end with a reboot. You can check the list of stages and steps by `./ubuntu18to20 --show-plan`.\nWhen dist-upgrade is finished, you will see the following login message:\n```\n===============================================================================\nMessage from the Plesk dist-upgrader tool:\nThe server has been upgraded to Ubuntu 20.\nYou can remove this message from the /etc/motd file.\n===============================================================================\n```\n\n## Logs\nIf something goes wrong, read the logs to identify the problem.\nThe dist-upgrader writes its log to the `/var/log/plesk/ubuntu18to20.log` file, as well as to stdout.\nAfter the first reboot, the process is resumed by the `plesk-dist-upgrader` service, so its output is available in system logs (see `systemctl status plesk-dist-upgrader` and `journalctl -u plesk-dist-upgrader`).\n\n## Revert\nIf the utility fails during the the \"convert\" stage before actual dist-upgrade of packages, you can use the dist-upgrader utility with the `-r` or `--revert` options to restore Plesk to normal operation. The dist-upgrader 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 dist-upgrade of packages, because packages provided by the new OS version are already installed.\n- `--revert` mode is not perfect, it can fail or be unable to restore the initial state of the system. So, the importance of creating full server backup or snapshot before starting dist-upgrade can't be stressed enough.\n\n### Checking the status of the conversion process and monitoring its progress\nTo check the status of the conversion process, use the `--status` option. You can see the current stage of the conversion process, the elapsed time, and the estimated time until finish.\n```shell\n\u003e ./ubuntu18to20 --status\n```\n\nTo monitor the progress of the conversion process in real time, use the `--monitor` option.\n```shell\n\u003e ./ubuntu18to20 --monitor\n( stage 3 / action re-installing plesk components  ) 02:26 / 06:18\n```\n\n## Issue handling\nIf for some reason the process has failed, inspect the log. By default, it's put to `/var/log/plesk/ubuntu18to20.log`. If the process was interrupted before the first reboot, you can restart it with the `--resume` option. If the problem has happened after the first reboot, you can restart the process by running `systemctl restart plesk-dist-upgrader`.\n\nIf something goes wrong, you will be informed on the next login with this message:\n```\n===============================================================================\nMessage from Plesk dist-upgrader tool:\nSomething went wrong during dist-upgrade by ubuntu18to20.\nSee the /var/log/plesk/ubuntu18to20.log file for more information.\nYou can remove this message from the /etc/motd file.\n===============================================================================\n```\n\n### Send feedback\nIf you got any error, please [create an issue on github](https://github.com/plesk/ubuntu18to20/issues). Describe your problem and attach the feedback archive or at least the log to the issue. The feedback archive can be created by calling the tool with the `--prepare-feedback` option:\n```shell\n\u003e ./ubuntu18to20 --prepare-feedback\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplesk%2Fubuntu18to20","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplesk%2Fubuntu18to20","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplesk%2Fubuntu18to20/lists"}