YunoHost/doc
1
0
Fork 0
mirror of https://github.com/YunoHost/doc.git synced 2024-09-03 20:06:26 +02:00
Code Issues Projects Releases Packages Wiki Activity

Instructions on how to install Debian for Yunohost

Browse source
This commit is contained in:
narF 2024-02-14 20:59:01 -05:00
parent 84941ce630
commit 4e02d91365
1 changed files with 54 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

54
pages/02.administer/10.install/25.installing_debian/installing_debian.md Normal file
View file

@ -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