doc/pages/02.administer/10.install/25.installing_debian/installing_debian.md
OniriCorpe 7a01793062
Improve markdown formatting of pages, a lot of them are improperly formatted (#2429)
* Revert "Revert "markdown format""

* fix formating

* fix readme

* add .markdownlint.json

* add markdownlint-rules-grav-pages

* add markdownlint-rules-grav-pages files

* add license for Markdown Lint Rules for Grav Pages

* fix [figure] mess

* fix [figure] mess 2

* fix [figure] mess 3

* maj .gitignore

* various fixes

* fix markdownlint-rules-grav-pages

* second formater pass

* various manual fixes

* add .markdownlintignore

* markdownlintignore: auto-generated pages

* disable proper-names for html_elements

* another bunch of various markdown fixes

* Update pages/02.administer/10.install/20.dns_config/dns_config.es.md

Co-authored-by: tituspijean <titus+yunohost@pijean.ovh>

---------

Co-authored-by: Alexandre Aubin <4533074+alexAubin@users.noreply.github.com>
Co-authored-by: tituspijean <titus+yunohost@pijean.ovh>
2024-03-23 08:59:52 +01:00

2.9 KiB
Raw Blame History

title template taxonomy routes
Installing Debian for Yunohost docs
category
docs
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. Its 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 wont 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.

  • Dont separate the /home, /var or /tmp partitions. Use the option to “keep all files in one partition”.
  • Dont encrypt any partitions, as recommended

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.