Using the self-serve net installer: Difference between revisions

From BitFolk
Jump to navigation Jump to search
m (→‎Ubuntu: typo)
m (→‎Debian: typo)
 
(39 intermediate revisions by 2 users not shown)
Line 24: Line 24:
:If you don't know the password then you'll need to do a [[BitFolk password reset|reset]] or contact BitFolk Support.
:If you don't know the password then you'll need to do a [[BitFolk password reset|reset]] or contact BitFolk Support.
* '''Be running a new enough version of Xen Shell.'''
* '''Be running a new enough version of Xen Shell.'''
:Xen Shell stays running if you disconnect from it, so it's possible that you're still running an old version. You need to be running version '''v1.48bitfolk8''' or later.
:Xen Shell stays running if you disconnect from it, so it's possible that you're still running an old version. You need to be running version '''v1.48bitfolk8''' or later. Different installers for different Linux distributions were added over time. See below to find out at what version of the Xen Shell an installer was added.
:You can see the version of a running Xen Shell instance by using the '''help''' command. If yours is too old just '''exit''' from every screen until you're disconnected, and then reconnect.
:You can see the version of a running Xen Shell instance by using the '''help''' command. If yours is too old just '''exit''' from every screen until you're disconnected, and then reconnect.
* '''Have a modern enough VPS configuration.'''
* '''Have a modern enough VPS configuration.'''
Line 34: Line 34:
Use the '''install''' command. It's as simple as:
Use the '''install''' command. It's as simple as:


<syntaxhighlight>
<syntaxhighlight lang="text">
xen-shell v1.48bitfolk2 - type 'help' for help.
xen-shell v1.48bitfolk2 - type 'help' for help.
xen-shell> install debian_lenny
xen-shell> install debian_lenny
Line 56: Line 56:
==General issues to be aware of==
==General issues to be aware of==
===Partitioning===
===Partitioning===
{{warning|You ''must'' place your root filesystem on the first partition of the first disk (i.e. '''xvda1'''), it ''must'' be '''ext3''' filesystem and '''/boot''' ''must'' be contained within it.<br />'''If you don't do this then your VPS almost certainly will not boot again''' after your install is complete.}}
Apart from the restriction of having to have your root filesystem as '''ext3''' on '''xvda1''', you can use your distribution's installer to add extra partitions of any filesystem type that your distribution normally supports, and lay out your filesystems as you please.
For later ease of [[Growing filesystems and disks|resizing]] it is recommended that you restrict yourself to one partition per disk. The typical BitFolk VPS has two disks, '''xvda''' and '''xvdb''' each of which has a single partition spanning the whole disk ('''xvda1''' and '''xvdb1''' respectively). '''xvda1''' would normally be the root filesystem and '''xvdb1''' would usually be used for swap. If you require more partitions then you can add them via the '''disks''' sub-menu of the Xen Shell prior to install. This will give you extra disks, e.g. '''xvdc''', '''xvdd''' and so on. You can split your disk allocation up into as many disk devices as you like.
For later ease of [[Growing filesystems and disks|resizing]] it is recommended that you restrict yourself to one partition per disk. The typical BitFolk VPS has two disks, '''xvda''' and '''xvdb''' each of which has a single partition spanning the whole disk ('''xvda1''' and '''xvdb1''' respectively). '''xvda1''' would normally be the root filesystem and '''xvdb1''' would usually be used for swap. If you require more partitions then you can add them via the '''disks''' sub-menu of the Xen Shell prior to install. This will give you extra disks, e.g. '''xvdc''', '''xvdd''' and so on. You can split your disk allocation up into as many disk devices as you like.


If you ''don't'' do this and instead put multiple partitions on a disk it will still work fine, but if you should ever come to want a disk resized it makes the process more difficult.
If you ''don't'' do this and instead put multiple partitions on a disk it will still work fine, but if you should ever come to want a disk resized it makes the process more difficult.


Consider using [[LVM]] if you plan to have a lot of different filesystems and/or plan to do frequent resizing. As long as you keep the first block device outside of LVM it works fine.
Consider using [[LVM]] if you plan to have a lot of different filesystems and/or plan to do frequent resizing. As long as you keep the partition with '''/boot''' on it outside of LVM it works fine.


==OS-specific notes==
==OS-specific notes==
Line 71: Line 67:
So far supported:
So far supported:


* lenny (5.x)
* 13.x (trixie) from '''v1.48bitfolk82'''
* squeeze (6.x)
:Note that as of this release the Debian kernel uses '''zstd''' compression which is not supported by BitFolk's PV mode bootloader and booting of any kernel will fail at the initial GRUB menu. You should switch to [[PVH]] mode, which BitFolk recommends anyway. No other changes should be necessary.
* wheezy (testing) from '''v1.48bitfolk13'''
* 12.x (bookworm)
:Note that as of this release '''udev''' has learned about Xen virtual Ethernet devices and so will by default rename your eth0 to enX0. Our installer will correctly set up your '''/etc/network/interfaces''' file for this device name. This is not specific to BitFolk or Xen; it's a consequence of the usual "predictable names" scheme. For more information please see the [https://wiki.debian.org/NetworkInterfaceNames Debian Wiki].
* 11.x (bullseye)
* 10.x (buster)
 
Also, experimentally:
 
* testing (forky)


The installation process is pretty much identical to a normal Debian net install, with the following quirks.
The installation process is pretty much identical to a normal Debian net install, with the following quirks.
Line 103: Line 106:
</pre>
</pre>


You're advised to select '''Manual''' so that you can ensure that your root filesystem goes on '''xvda1''' and your swap goes on '''xvdb1''' as per [[#Partitioning|the notes above]].
You're advised to select '''Manual''' so that you can ensure that your root filesystem goes on '''xvda1''' and your swap goes on '''xvdb1''' as per [[#Partitioning|the notes above]]. Using a filesystem label is also smart.


"'''relatime'''" is a good idea as a mount option, and using a filesystem label is also smart.
If using a separate '''/boot''' (commonly-needed for more complicated filesystem layouts, LVM, etc.) then please note that it has been observed that an i686 install of Debian jessie (8.x) with a 20MiB '''/boot''' failed due to lack of space while installing the kernel (actually while creating the initramfs), whereas the same install with a 25MiB '''/boot''' succeeded. A few megabytes could possibly be shaved off by telling it to build a targeted initramfs instead of a generic one (untested).


Once you've selected '''Finish partitioning and write changes to disk''' the installation will proceed as normal. If you don't select any additional software it should only take a few minutes.
Once you've selected '''Finish partitioning and write changes to disk''' the installation will proceed as normal. If you don't select any additional software it should only take a few minutes.
Line 127: Line 130:
Normally at this point you'd select '''<Continue>''' and your machine would reboot into your new install. Under Xen though, a reboot does not fully destroy the virtual machine. If the installer ''did'' do a reboot here, all that would happen is that Xen would restart the installer again. For that reason the installer has been set to halt here. You'll be dropped back to the Xen Shell prompt, and issuing a '''boot''' command will boot up your new VPS:
Normally at this point you'd select '''<Continue>''' and your machine would reboot into your new install. Under Xen though, a reboot does not fully destroy the virtual machine. If the installer ''did'' do a reboot here, all that would happen is that Xen would restart the installer again. For that reason the installer has been set to halt here. You'll be dropped back to the Xen Shell prompt, and issuing a '''boot''' command will boot up your new VPS:


<syntaxhighlight>
<syntaxhighlight lang="text">
The system is going down NOW!ystem...                                      │  
The system is going down NOW!ystem...                                      │  
Sending SIGTERM to all processes                                            │  
Sending SIGTERM to all processes                                            │  
Line 165: Line 168:


You can of course always create a new Xen Shell window, '''shutdown''' or '''destroy''' your running installer VPS and just start over again.
You can of course always create a new Xen Shell window, '''shutdown''' or '''destroy''' your running installer VPS and just start over again.
====Saving logs====
If you're having problems then showing [[BitFolk Support]] the logs from your installer will be helpful. There is a "Save debug logs" option near the end of the main menu of the installer which will create a directory with the logs in it. Available options for saving the logs are:
* '''Floppy'''<br>Which quite clearly doesn't make sense on a VPS.
* '''Web'''<br>Which will start a web server on your VPS's IP address with access to the log files so you can download and save elsewhere.
* '''Mounted file system'''<br>Which will let you save the logs somewhere in the installer VM.
The easiest way to get the logs off is probably the '''Web''' choice, as you can just point your web browser at the VPS's IP and download the files.
Next easiest would probably be to enable SSH support in the installer and then use the '''Mounted file system''' option to save the logs somewhere (e.g. '''/mnt''' as it suggests would be fine), start a shell and '''scp''' them out. To enable SSH in the installer:
# Use the "Change debconf priority" option to change priority to '''low'''.
# Use the "Download installer components" to select '''openssh-client-udeb'''.
Now when you use the "Execute a shell" option you should have '''ssh''' and '''scp''' commands available.
Another possibility would be to use the '''Mounted file system''' option to save the logs somewhere inside the system being installed, which is somewhere under '''/target''' from the point of view of the installer, e.g. '''/target/var/tmp'''. You would then boot into the [[rescue VM]] to access the logs, copy them elsewhere, etc.


===Ubuntu===
===Ubuntu===
So far supported:
:''Main article: [[Ubuntu]]''
 
Currently supported:
 
* 24.04.x LTS (Noble Numbat) from '''v1.48bitfolk76'''
* 22.04.x LTS (Jammy Jellyfish) from '''v1.48bitfolk73'''
* 20.04.x LTS (Focal Fossa) from '''v1.48bitfolk58'''
: Note that from 19.10 Ubuntu have switched to LZ4-compressed kernels which when run in Xen PV mode require [https://github.com/bitfolk/decompress-lz4-kernels a workaround script] be installed in order to work at BitFolk. BitFolk recommends running in PVH mode (which as of November 2020 is the default) where this works fine, but if you stick with PV mode then the installer adds the workaround for you.
* 18.04.x LTS (Bionic Beaver) from '''v1.48bitfolk46'''
: Note that from 18.04 Ubuntu have switched to using [https://netplan.io/ netplan] to configure the network, and Ubuntu installers from 18.04 onwards will reflect this.
* 16.04.x LTS (Xenial Xerus) from '''v1.48bitfolk36'''
 
Starting with Ubuntu 22.04 the install process is the official [https://cloud-images.ubuntu.com/ Ubuntu Cloud Image], customised at first boot for your BitFolk account with [https://cloudinit.readthedocs.io/en/latest/ cloud-init].


* 13.04 (Raring Ringtail) from '''v1.48bitfolk22'''
Prior to Ubuntu 22.04 the process is largely identical to [[#Debian|Debian]] as it uses the Debian installer.
* 12.04 LTS (Precise Pangolin) from '''v1.48bitfolk19'''
* 10.04.x LTS (Lucid Lynx)


The process is largely identical to [[#Debian|Debian]].
Check out [[Ubuntu|our article on Ubuntu]] for additional notes.


Here's [http://www.youtube.com/watch?v=U9tHLUg0o8A a screencast of someone installing 11.04 on a BitFolk VPS].
Here's [http://www.youtube.com/watch?v=U9tHLUg0o8A a screencast of someone installing 11.04 on a BitFolk VPS].


There seemed to be a large pause (as much as 4 minutes) with no visible progress in between setting hostname/domain and installing the base system, but the install did eventually proceed by itself.
===CentOS Stream===
:''Main article: [[/CentOS Stream|CentOS Stream]]''


===CentOS and Scientific Linux===
So far supported:
:''Main article: [[/CentOS and Scientific Linux|CentOS and Scientific Linux]]''


So far supported:
* CentOS Stream 9.x (from '''v1.48bitfolk75''')
* CentOS Stream 8.x (from '''v1.48bitfolk63''')
* CentOS Linux 7.x (from '''v1.48bitfolk37''')


* CentOS 5.x
{{warning|CentOS 8 has dropped support for PV and PVH mode Xen guests even though the upstream Linux kernel supports that by default. Therefore '''the CentOS Stream installer will use the [http://elrepo.org/tiki/kernel-lt kernel-lt kernel] from [http://elrepo.org/tiki/HomePage ELRepo]'''.}}
* CentOS 6.x (from '''v1.48bitfolk16''')
* Scientific Linux 6.x (from '''v1.48bitfolk16''')


====Things you might like to change after install====
====Things you might like to change after install====
* You may want to configure '''yum''' to take advantage of BitFolk's [http://bitfolk.com/customer_information.html#toc_2_Centos_5_mirror CentOS 5 mirror]
* You either won't have an NTP server installed or else it won't be configured to talk to BitFolk's [http://bitfolk.com/customer_information.html#toc_2_NTP NTP servers]
* '''/etc/resolv.conf''' will only have one of the two BitFolk [http://bitfolk.com/customer_information.html#toc_2_DNS DNS resolvers].
* If your VPS has multiple IPv4 addresses then only the first one will have been configured by the installer.
* If your VPS has multiple IPv4 addresses then only the first one will have been configured by the installer.
* The installer won't have set up IPv6 at all.
* The CentOS 7.x installer won't have set up IPv6 at all. This was fixed for the CentOS 8.x installer.
* A default firewall configuration has been loaded; this will likely need to be modified if you're going to run any public network services.
* A default firewall configuration has been loaded; this will likely need to be modified if you're going to run any public network services.
===Arch Linux===
A [[Installing Arch Linux|guide has been written up]] for installing Arch Linux via the [[Rescue|Rescue VM]].
===Fedora Linux===
A [[Installing Fedora|guide has been written up]] for installing Fedora Linux via the [[Rescue|Rescue VM]].
===Gentoo===
A [[Installing Gentoo|guide has been written up]] for installing Gentoo via the [[Rescue|Rescue VM]].
===NixOS===
A [[Installing NixOS|guide has been written up]] for installing NixOS via the [[Rescue|Rescue VM]], with a system closure built on a separate machine.
===Slackware===
A [[Installing Slackware|guide has been written up]] for installing Slackware via the [[Rescue|Rescue VM]].
==Other unsupported Linux distributions==
Since the upstream Linux kernel supports booting as a Xen guest it is usually possible to install any distribution through the [[Rescue VM]]. We have some additional notes on [[installing unsupported distributions]] which may help.

Latest revision as of 23:04, 31 October 2025

For most guest operating systems it is possible for customers to launch a self-service network installer from the Xen Shell.

Default image installs vs. network installer

Most BitFolk customers have their VPS initially provisioned by BitFolk support via an image file. This results in a minimal install fully-customised for the BitFolk environment, but with very little flexibility.

Some customers prefer to run through their chosen operating system's familiar network installer in order to carry out a custom install to their specification. This can also be useful to reinstall your VPS without requiring assistance from BitFolk support.

Not all operating systems that BitFolk supports are available as self-service network installs. It requires that the operating system has a Xen-compatible network installer, and that this has been tested by BitFolk.

Prerequisites

In order to initiate a network install you must:

  • Have access to your Xen Shell.
If you don't know the password then you'll need to do a reset or contact BitFolk Support.
  • Be running a new enough version of Xen Shell.
Xen Shell stays running if you disconnect from it, so it's possible that you're still running an old version. You need to be running version v1.48bitfolk8 or later. Different installers for different Linux distributions were added over time. See below to find out at what version of the Xen Shell an installer was added.
You can see the version of a running Xen Shell instance by using the help command. If yours is too old just exit from every screen until you're disconnected, and then reconnect.
  • Have a modern enough VPS configuration.
You may be warned that your VPS's disk layout is non-standard. In that case you'll need to use the reset command of the disks sub-menu to standardise it.
  • Be prepared to nuke your existing VPS and any data stored on it.
Generally the first thing the network installers do is format your VPS's block device(s), so don't try to do this unless you have backups or don't care about your data. It might be possible depending on the installer to preserve the contents of some block devices, but please don't rely on this.

Initiating a network install

Use the install command. It's as simple as: 

xen-shell v1.48bitfolk2 - type 'help' for help.
xen-shell> install debian_lenny
About to overwrite your VPS with the debian_lenny network installer - this will result in a loss of all data, without further confirmation!
Are you sure? Please type "Yes" to confirm, or anything else to abort.
INSTALL?> yes
Booting debian_lenny net installer for: debtest1
Using config file "/etc/xen/debtest1.conf".
Install Mirror: http://ftp.uk.debian.org/debian
Install Suite: lenny
Installer: http://ftp.uk.debian.org/debian/dists/lenny/main/installer-i386/current/images

WARNING: Installer kernel and ramdisk are not authenticated.

Fetching http://ftp.uk.debian.org/debian/dists/lenny/main/installer-i386/current/images/netboot/xen/vmlinuz
Fetching http://ftp.uk.debian.org/debian/dists/lenny/main/installer-i386/current/images/netboot/xen/initrd.gz

The network installer should then boot and you'll follow the usual procedure for installing your chosen operating system.

General issues to be aware of

Partitioning

For later ease of resizing it is recommended that you restrict yourself to one partition per disk. The typical BitFolk VPS has two disks, xvda and xvdb each of which has a single partition spanning the whole disk (xvda1 and xvdb1 respectively). xvda1 would normally be the root filesystem and xvdb1 would usually be used for swap. If you require more partitions then you can add them via the disks sub-menu of the Xen Shell prior to install. This will give you extra disks, e.g. xvdc, xvdd and so on. You can split your disk allocation up into as many disk devices as you like.

If you don't do this and instead put multiple partitions on a disk it will still work fine, but if you should ever come to want a disk resized it makes the process more difficult.

Consider using LVM if you plan to have a lot of different filesystems and/or plan to do frequent resizing. As long as you keep the partition with /boot on it outside of LVM it works fine.

OS-specific notes

Debian

So far supported:

  • 13.x (trixie) from v1.48bitfolk82
Note that as of this release the Debian kernel uses zstd compression which is not supported by BitFolk's PV mode bootloader and booting of any kernel will fail at the initial GRUB menu. You should switch to PVH mode, which BitFolk recommends anyway. No other changes should be necessary.
  • 12.x (bookworm)
Note that as of this release udev has learned about Xen virtual Ethernet devices and so will by default rename your eth0 to enX0. Our installer will correctly set up your /etc/network/interfaces file for this device name. This is not specific to BitFolk or Xen; it's a consequence of the usual "predictable names" scheme. For more information please see the Debian Wiki.
  • 11.x (bullseye)
  • 10.x (buster)

Also, experimentally:

  • testing (forky)

The installation process is pretty much identical to a normal Debian net install, with the following quirks.

Disk partitioning

The first partman dialog you'll be shown looks like this: 

  ┌────────────────────────┤ [!!] Partition disks ├─────────────────┐
  │                                                                         │ 
  │ The installer can guide you through partitioning a disk (using          │ 
  │ different standard schemes) or, if you prefer, you can do it            │ 
  │ manually. With guided partitioning you will still have a chance later   │ 
  │ to review and customise the results.                                    │ 
  │                                                                         │ 
  │ If you choose guided partitioning for an entire disk, you will next     │ 
  │ be asked which disk should be used.                                     │ 
  │                                                                         │ 
  │ Partitioning method:                                                    │ 
  │                                                                         │ 
  │          Guided - use entire disk                                       │ 
  │          Guided - use entire disk and set up LVM                        │ 
  │          Guided - use entire disk and set up encrypted LVM              │ 
  │          Manual                                                         │ 
  │                                                                         │ 
  │     <Go Back>                                                           │ 
  │                                                                         │ 
  └─────────────────────────────────────────────────────────────┘

You're advised to select Manual so that you can ensure that your root filesystem goes on xvda1 and your swap goes on xvdb1 as per the notes above. Using a filesystem label is also smart.

If using a separate /boot (commonly-needed for more complicated filesystem layouts, LVM, etc.) then please note that it has been observed that an i686 install of Debian jessie (8.x) with a 20MiB /boot failed due to lack of space while installing the kernel (actually while creating the initramfs), whereas the same install with a 25MiB /boot succeeded. A few megabytes could possibly be shaved off by telling it to build a targeted initramfs instead of a generic one (untested).

Once you've selected Finish partitioning and write changes to disk the installation will proceed as normal. If you don't select any additional software it should only take a few minutes.

Finishing the install

At the end you'll see: 

   ┌────────────┤ [!!] Finish the installation ├────────────────────┐
  ┌│                         Installation complete                         │ 
  ││ Installation is complete, so it is time to boot into your new system. │  
  ││ Make sure to remove the installation media (CD-ROM, floppies), so     │  
  ││ that you boot into the new system rather than restarting the          │  
  ││ installation.                                                         │  
  ││                                                                       │  
  └│     <Go Back>                                          <Continue>     │  
   │                                                                       │  
   └───────────────────────────────────────────────────────────┘

Normally at this point you'd select <Continue> and your machine would reboot into your new install. Under Xen though, a reboot does not fully destroy the virtual machine. If the installer did do a reboot here, all that would happen is that Xen would restart the installer again. For that reason the installer has been set to halt here. You'll be dropped back to the Xen Shell prompt, and issuing a boot command will boot up your new VPS: 

The system is going down NOW!ystem...                                       │ 
Sending SIGTERM to all processes                                            │ 
Sending SIGKILL to all processes─────────────────────────────────────┘ 
Requesting system halt                                                        
                      [ 4298.952440] md: stopping all md devices.
[ 4299.944797] xenbus_dev_shutdown: device/console/0: Initialising != Connected, skipping
[ 4300.295265] System halted.
xen-shell> boot
Booting instance: debtest1

    pyGRUB  version 0.6
 lqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqk
 x Debian GNU/Linux, kernel 2.6.26-2-xen-686                              x
 x Debian GNU/Linux, kernel 2.6.26-2-xen-686 (single-user mode)           x

Started domain debtest1
                       [    0.000000] Initializing cgroup subsys cpuset
[    0.000000] Initializing cgroup subsys cpu
[    0.000000] Linux version 2.6.26-2-xen-686 (Debian 2.6.26-26lenny1) (dannf@debian.org) (gcc version 4.1.3 20080704 (prerelease) (Debian 4.1.2-25)) #1 SMP Thu Nov 25 02:32:31 UTC 2010
.
.
.

Things you might like to change after install

By this point you've just completed a fresh install of Debian and it should be working fine, but you won't have some of the nice features of a typical BitFolk VPS image configured. Things you may wish to look into:

  • You either won't have an NTP server installed or else it won't be configured to talk to the NTP servers.
  • /etc/resolv.conf will only have one of the two BitFolk DNS resolvers.
  • Your /etc/fstab will be mounting things by device name, but it's recommended to change that to UUID or label. Future changes to the Linux kernel are more likely to rename virtual block devices than devices for regular SATA disks, so it's wise to make sure that things mount properly even if this should happen.
  • If your VPS has multiple IPv4 addresses then only the first one will have been configured by the installer.
  • The installer may not have set up IPv6 at all, or may have done so automatically. You may need to set this up how you prefer.

Breaking out of the installer

If you do something wrong then you can generally fix it by going back to the installer's main menu. You get there by selecting Go back when given that option in a dialog. From the main menu of the installer you can retrace your steps. You can also start a shell if you need to poke around.

You can of course always create a new Xen Shell window, shutdown or destroy your running installer VPS and just start over again.

Saving logs

If you're having problems then showing BitFolk Support the logs from your installer will be helpful. There is a "Save debug logs" option near the end of the main menu of the installer which will create a directory with the logs in it. Available options for saving the logs are:

  • Floppy
    Which quite clearly doesn't make sense on a VPS.
  • Web
    Which will start a web server on your VPS's IP address with access to the log files so you can download and save elsewhere.
  • Mounted file system
    Which will let you save the logs somewhere in the installer VM.

The easiest way to get the logs off is probably the Web choice, as you can just point your web browser at the VPS's IP and download the files.

Next easiest would probably be to enable SSH support in the installer and then use the Mounted file system option to save the logs somewhere (e.g. /mnt as it suggests would be fine), start a shell and scp them out. To enable SSH in the installer:

  1. Use the "Change debconf priority" option to change priority to low.
  2. Use the "Download installer components" to select openssh-client-udeb.

Now when you use the "Execute a shell" option you should have ssh and scp commands available.

Another possibility would be to use the Mounted file system option to save the logs somewhere inside the system being installed, which is somewhere under /target from the point of view of the installer, e.g. /target/var/tmp. You would then boot into the rescue VM to access the logs, copy them elsewhere, etc.

Ubuntu

Main article: Ubuntu

Currently supported:

  • 24.04.x LTS (Noble Numbat) from v1.48bitfolk76
  • 22.04.x LTS (Jammy Jellyfish) from v1.48bitfolk73
  • 20.04.x LTS (Focal Fossa) from v1.48bitfolk58
Note that from 19.10 Ubuntu have switched to LZ4-compressed kernels which when run in Xen PV mode require a workaround script be installed in order to work at BitFolk. BitFolk recommends running in PVH mode (which as of November 2020 is the default) where this works fine, but if you stick with PV mode then the installer adds the workaround for you.
  • 18.04.x LTS (Bionic Beaver) from v1.48bitfolk46
Note that from 18.04 Ubuntu have switched to using netplan to configure the network, and Ubuntu installers from 18.04 onwards will reflect this.
  • 16.04.x LTS (Xenial Xerus) from v1.48bitfolk36

Starting with Ubuntu 22.04 the install process is the official Ubuntu Cloud Image, customised at first boot for your BitFolk account with cloud-init.

Prior to Ubuntu 22.04 the process is largely identical to Debian as it uses the Debian installer.

Check out our article on Ubuntu for additional notes.

Here's a screencast of someone installing 11.04 on a BitFolk VPS.

CentOS Stream

Main article: CentOS Stream

So far supported:

  • CentOS Stream 9.x (from v1.48bitfolk75)
  • CentOS Stream 8.x (from v1.48bitfolk63)
  • CentOS Linux 7.x (from v1.48bitfolk37)
Warning Warning: CentOS 8 has dropped support for PV and PVH mode Xen guests even though the upstream Linux kernel supports that by default. Therefore the CentOS Stream installer will use the kernel-lt kernel from ELRepo.

Things you might like to change after install

  • If your VPS has multiple IPv4 addresses then only the first one will have been configured by the installer.
  • The CentOS 7.x installer won't have set up IPv6 at all. This was fixed for the CentOS 8.x installer.
  • A default firewall configuration has been loaded; this will likely need to be modified if you're going to run any public network services.

Arch Linux

A guide has been written up for installing Arch Linux via the Rescue VM.

Fedora Linux

A guide has been written up for installing Fedora Linux via the Rescue VM.

Gentoo

A guide has been written up for installing Gentoo via the Rescue VM.

NixOS

A guide has been written up for installing NixOS via the Rescue VM, with a system closure built on a separate machine.

Slackware

A guide has been written up for installing Slackware via the Rescue VM.

Other unsupported Linux distributions

Since the upstream Linux kernel supports booting as a Xen guest it is usually possible to install any distribution through the Rescue VM. We have some additional notes on installing unsupported distributions which may help.

Retrieved from "https://tools.bitfolk.com/w/index.php?title=Using_the_self-serve_net_installer&oldid=2018"