mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
55 lines
2.9 KiB
Markdown
55 lines
2.9 KiB
Markdown
---
|
||
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. Install curl by typing `apt install curl`
|
||
5. Proceed to install Yunohost on Debian using these instructions: <https://yunohost.org/en/install/hardware:vps_debian>
|
||
- The installer will ask for permission to overwrite some configuration files. Select Yes.
|