{"id":13512382,"url":"https://github.com/gh2o/digitalocean-debian-to-arch","last_synced_at":"2025-12-17T01:03:07.197Z","repository":{"id":18597750,"uuid":"21802513","full_name":"gh2o/digitalocean-debian-to-arch","owner":"gh2o","description":"Script to convert a Debian installation on DigitalOcean to Arch Linux","archived":false,"fork":false,"pushed_at":"2024-06-21T08:10:41.000Z","size":215,"stargazers_count":830,"open_issues_count":7,"forks_count":69,"subscribers_count":30,"default_branch":"debian9","last_synced_at":"2024-11-01T14:37:31.994Z","etag":null,"topics":["arch-installer","arch-linux","digitalocean","vps"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gh2o.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}},"created_at":"2014-07-14T00:11:38.000Z","updated_at":"2024-09-20T02:00:43.000Z","dependencies_parsed_at":"2024-04-16T20:57:53.352Z","dependency_job_id":"0d38da0c-78b8-4c7c-8e86-327b9767b014","html_url":"https://github.com/gh2o/digitalocean-debian-to-arch","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gh2o%2Fdigitalocean-debian-to-arch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gh2o%2Fdigitalocean-debian-to-arch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gh2o%2Fdigitalocean-debian-to-arch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gh2o%2Fdigitalocean-debian-to-arch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gh2o","download_url":"https://codeload.github.com/gh2o/digitalocean-debian-to-arch/tar.gz/refs/heads/debian9","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246390873,"owners_count":20769476,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["arch-installer","arch-linux","digitalocean","vps"],"created_at":"2024-08-01T03:01:47.942Z","updated_at":"2025-12-17T01:03:07.121Z","avatar_url":"https://github.com/gh2o.png","language":"Shell","funding_links":[],"categories":["Shell","Automation"],"sub_categories":["Controllers"],"readme":"DigitalOcean Debian to Arch\n===========================\nDigitalOcean deprecated Arch Linux a while back because it was relatively\ndifficult to support due to the rolling updates. I wrote this script to\nbring it back! This script downloads a bootstrap Arch Linux image, updates it\nto the latest version, then overwrites the host operating system with it.\n\nWarning / Disclaimer\n--------------------\n\u003ch3\u003eALL DATA ON THE DROPLET WILL BE UNCONDITIONALLY DESTROYED.\u003c/h3\u003e\nThis script may cause your VPS to become unbootable.\nI only recommend running this script on newly created droplets with no\nimportant data.\n\nInstallation\n------------\n1. Create a new Debian 9.x droplet (either 32-bit or 64-bit is fine).\n2. In the droplet, run the following as root:\n\n        # wget https://raw.githubusercontent.com/gh2o/digitalocean-debian-to-arch/debian9/install.sh -O install.sh\n        # bash install.sh\n\n3. Follow the instructions when prompted.\n4. Sit back and relax! The system will automatically reboot once complete,\n   and you should have a fully updated Arch Linux system in within minutes.\n\nAdvanced Configuration\n----------------------\nThis script supports several flags, all of which are optional.\n\n* `--archlinux_mirror`  \n  The Arch Linux mirror from which the bootstrap image and packages should be\n  downloaded. Defaults to http://mirrors.kernel.org/archlinux.\n* `--extra_packages`  \n  Installs any extra packages to the Arch installation (e.g. base-devel).\n  Packages should be space-separated and quoted\n  (e.g. `--extra_packages \"git wget\"`).\n* `--grub_timeout`  \n  Overrides the default GRUB_TIMEOUT value of 5 seconds.\n* `--kernel_package`  \n  The kernel package to install. Defaults to the vanilla `linux` package.\n  Other options include `linux-lts` for long term support and `linux-hardened` for\n  a kernel with patches from [linux-hardened](https://github.com/thestinger/linux-hardened).\n* `--mkfs_options`  \n  Extra options to pass to `mkfs`. Useful for settings bytes per inode on ext4,\n  e.g. `--mkfs_options=\"-i 65536\"`.\n* `--target_architecture`  \n  The architecture of the new Arch Linux installation. Defaults to the\n  architecture of the original Debian image as provided by `uname -m`.\n  A 64-bit Debian image may convert to either `x86_64` or `i686`.\n  A 32-bit Debian image may only convert to `i686`.\n* `--target_disklabel`  \n  The type of partition table to use. Defaults to `gpt` (GUID partition table\n  as used by EFI). The alternative is `dos` (traditional MBR).\n* `--target_filesystem`  \n  The filesystem on which the Arch Linux installation should be installed.\n  Defaults to `ext4`. The alternative is `btrfs`.\n\nHow it Works\n------------\n1. A sparse disk image is created with the same size of the droplet's disk.\n2. Three partitions are made and formatted.\n   * **DORoot**: A \"dummy\" partition to keep DigitalOcean happy. When snapshots\n       are restored, new passwords are written here.\n   * **BIOSBoot**: The virtual machine BIOS cannot boot from GPT partitions\n       directly, so a small partition is placed here for bootloader code.\n   * **ArchRoot**: The main root filesystem for Arch Linux.\n3. The Arch Linux bootstrap image is downloaded and unpacked onto ArchRoot.\n4. `pacman -Syu` is called inside the image to pull in all the base packages\n   along with OpenSSH and any other packages put in the --extra_packages option.\n5. The root password and SSH host keys are copied into the image.\n6. A special script called `digitalocean-synchronize` is installed into\n   the image. This script is run at every startup to autodetect the network\n   settings from the metadata service. It also detects if the droplet\n   was just restored, and if so, it resets the root password and regenerates\n   the host SSH keys.\n7. The image is now ready. The script then generates a \"blockplan\". It is\n   essentially a list of instructions to image the virtual disk with the\n   sparse disk image without requiring any extra space.\n8. A minimal root filesystem is generated on RAM so that the disk can\n   be unmounted.\n9. The script calls `systemctl switch-root` to enter the minimal\n   root filesystem.\n10. The disk is unmounted.\n11. The blockplan is executed.\n12. The bootloader (Grub) is installed.\n13. Reboot!\n14. Done!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgh2o%2Fdigitalocean-debian-to-arch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgh2o%2Fdigitalocean-debian-to-arch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgh2o%2Fdigitalocean-debian-to-arch/lists"}