diff --git a/pages/02.administer/10.install/25.installing_debian/installing_debian.md b/pages/02.administer/10.install/25.installing_debian/installing_debian.md new file mode 100644 index 00000000..7dbc7bc2 --- /dev/null +++ b/pages/02.administer/10.install/25.installing_debian/installing_debian.md @@ -0,0 +1,54 @@ +--- +title: Installing Debian for Yunohost +template: docs +taxonomy: + category: docs +routes: + default: '/installing_debian' +--- + +If you can't install Yunohost successfully, there's always the option to install Debian and then install Yunohost on top. + +## Which Debian version + +At the time of writing, only Debian 11 is supported by Yunohost. Don't use Debian 12. + +## Before you start + +The Debian installer isn't the easiest Linux installer, especially for beginners. It'll be easier to **format the hard drive** you plan to use for Debian+Yunohost **before you install Debian**, using your disk utility of choice. + +## Installing Debian + +### Booting the installer + +This guide won't go into details on how to boot the Debian installer. You can use Debian's own documentation for that. The short version is you'll need to flash a USB stick with the Debian 11 image, like you would flash the Yunohost image. + +### Installing + +In general, you can simply follow the instructions on screen and use the suggested defaults. + +Debian installer will ask for a **hostname** and a **domain name**. You can use “yunohost” and “yunohost.local”. It’s not really important since the Yunohost Installer will overwrite those anyway. + +Debian will ask for a **root password**. Make sure you pick a **really long and complex** one and save it to your password manager of choice (Bitwarden, Firefox, etc…) or write it somewhere safe. Remember that this is a server that will be available on the internet, making it vulnerable to possible attacks so you should be extra safe here! + +The installer will also ask for a **user account** and another password. **Important:** name it something that won’t be used by your Yunohost server later. For example, you can name it `debian`. Be sure to also use a long complex password. + +When the install asks about where to install and how to **create disk partitions**, select the option to use the whole disk, unless you know what you're doing. + +- Don’t separate the /home, /var or /tmp partitions. Use the option to “keep all files in one partition”. +- Don’t encrypt any partitions, [as recommended](https://yunohost.org/en/administer/install/hardware:regular#about-encryption)) + +The installer will ask about **mirrors**. Select a country and server close to your location, or use the default options. + +The installer will ask about which **desktop environment** you want. You should not install a desktop environment on a server: + +- Unselect all desktop environment +- Keep “standard system utilities” checked + +## After installing Debian + +1. Remove the installation media (unplug the USB stick) +2. Reboot +3. Login as `root` with the long complex password you created earlier. +4. Proceed to install Yunohost on Debian using these instructions: https://yunohost.org/en/install/hardware:vps_debian +