From 7de5a3562023b53163dee3f6fd1b51cd088d65eb Mon Sep 17 00:00:00 2001 From: Matt Troutman Date: Thu, 2 Nov 2023 10:49:54 -0500 Subject: [PATCH 1/7] Update images.md (#2362) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fixed a typo 🙂 --- pages/02.administer/10.install/05.images/images.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/02.administer/10.install/05.images/images.md b/pages/02.administer/10.install/05.images/images.md index d02f4e7b..7e9efb0d 100644 --- a/pages/02.administer/10.install/05.images/images.md +++ b/pages/02.administer/10.install/05.images/images.md @@ -13,7 +13,7 @@ This page requires Javascript enabled to display properly :s.
-!!! Even if the image does not corresponds to the latest version of YunoHost, you can still use it and do a regular system upgrade after setting up! +!!! Even if the image does not correspond to the latest version of YunoHost, you can still use it and do a regular system upgrade after setting up! !!! If you wish to check the validity of our signed images, you can [download our public key](https://forge.yunohost.org/yunohost.asc). From d94c5535c7a9644713de0037a7a07bb1cf72b8f2 Mon Sep 17 00:00:00 2001 From: Leandro Noferini Date: Thu, 2 Nov 2023 16:50:33 +0100 Subject: [PATCH 2/7] Added italian translation for the FAQ (#2361) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Italian translation for manualdns Italian translation made by Ilario Quinson * Italian translation for autodns Italian translation made by Ilario Quinson * Italian translation Made by Ilario Quinson * Italian translation Made by Ilario Quinson * Italian translation * Traduzione di security.md * Add files via upload * Tradotto domains.md partendo dalla versione francese perché questa e quella in inglese sono completamente disomogenee * Aggiunta apps.it.md * Italian translation * Traduzione delle FAQ in italiano eseguita da Ilario Quinson e revisionata da Leandro Noferini --- pages/05.community/20.faq/faq.it.md | 126 ++++++++++++++++++++++++++++ 1 file changed, 126 insertions(+) create mode 100644 pages/05.community/20.faq/faq.it.md diff --git a/pages/05.community/20.faq/faq.it.md b/pages/05.community/20.faq/faq.it.md new file mode 100644 index 00000000..93e8a55a --- /dev/null +++ b/pages/05.community/20.faq/faq.it.md @@ -0,0 +1,126 @@ +--- +title: Domande frequenti +template: docs +taxonomy: + category: docs +routes: + default: '/faq' +--- + +#### Con quale licenza è rilasciato Yunohost? + +I pacchetti che si trovano in YunoHost sono rilasciati con licenza GNU AGPL v.3. + +YunoHost è basato sulla distribuzione Debian, quindi rispetta le licenze degli elementi sui quali Debian è costruito. + +I programmi e i pacchetti hanno la loro propria licenza. + + +#### Quale obbiettivo si prefigge YunoHost? + +Siamo convinti che la decentralizzazione di Internet, e il riappropriarsi della responsabilità e del controllo dei nostri dati e servizi, sia una questione essenziale per garantire una società libera e democratica. + +Il progetto YunoHost cerca di democratizzare il self hosting. + +Mettiamo a disposizione un software che facilita la gestione e l'amministrazione, in proprio, di un server, riducendo le competenze necessarie e il tempo richiesto. + + +#### In pratica cosa *fa* YunoHost? + +YunoHost è contemporaneamente una distribuzione, cioè una versione di GNU/Linux-Debian dedicata ad uno scopo preciso e arricchita da un insieme di applicazioni che YunoHost contempla nel suo catalogo, sia un "semplice" programma che configura Debian in maniera automatica e gestisce per voi le configurazioni più difficili. + +Ad esempio, per installare una istanza WordPress manualmente si devono eseguire una serie complessa di comandi per creare gli utenti, installare un server web, un server SQL, scaricare l'archivio di WordPress, decomprimerlo, configurare il sever web e il server SQL ed infine configurare WordPress. YunoHost effettua tutte queste operazioni al vostro posto, affinché possiate concentrarvi su cose più importanti. + +Maggiori informazioni le potete trovare [qui](/whatsyunohost) ! + +#### Posso ospitare un sito internet in YunoHost? + +Certamente! [Qui](https://github.com/YunoHost-Apps/my_webapp_ynh). trovate tutto quello che vi serve. Questa applicazione fornisce un "contenitore vuoto": alla fine dell'installazione sarà sufficiente inviare i vostri file (via SSH/SCP o SFTP) alla destinazione corretta. Se necessario potrete usare codice PHP o un database SQL. + +#### Posso ospitare più di un sito internet con nomi di dominio diversi? + +Si è possibile ospitare più siti con domini diversi in quanto YunoHost accetta più nomi di dominio e alcuni programmi di gestione di siti web, come *Wordpress* o *My Webapp*, gestiscono più istanze, potendo quindi installarli più volte. + + +#### Perché non posso accedere alle mie applicazioni con l'indirizzo IP del server? + +Per motivi tecnici il [SSO](https://github.com/YunoHost/SSOwat/) (Single Sign On) non permette agli utilizzatori di connettersi alla propria dashboard quando si accede al server con il suo indirizzo IP. Se non potete configurare il DNS, una soluzione temporanea è quella di modificare il [file 'hosts' (ultimo §)](/dns_local_network) del proprio computer. + + +#### Su quale modello economico si basa YunoHost ? + +YunoHost è sviluppato da una comunità di volontari durante il loro tempo libero. Il progetto riceve regolarmente donazioni che finanziano principalmente le spese per i server e le spese di marketing (gli adesivi ;P). Il progetto ha ricevuto (o riceve attualmente) sovvenzioni da parte di organizzazioni quali [NLnet](https://nlnet.nl/) o [CodeLutin](https://www.codelutin.com/) al fine di finaziare lo sviluppo di parti ben definite. + +Le donazioni al progetto stanno aumentando e quindi sono allo studio delle iniziative per ridistribuire il ricavato ai principali sviluppatori, al fine di consolidare nel tempo il progetto. Inoltre alcuni sviluppatori svolgono parte della loro attività professionale avvalendosi di YunoHost. + +#### Posso fare una donazione al progetto ? + +Si è possibile! YunoHost paga server e nomi di dominio, e ci piacerebbe permettere ai nostri collaboratori/trici, di continuare a sviluppare YunoHost piuttosto di doversi cercare un altro lavoro. + +Potete donare tramite il [nostro portale per le donazioni](https://donate.yunohost.org) + +Se potete, accettiamo anche contributi di diversa natura (una parte della nostra infrastruttura proviene da associazioni che ci forniscono alcuni server). + +#### Come posso contribuire al progetto ? + +Esistono [diversi modi per contribuire](/contribute) :). + +Fateci conoscere le vostre idee! + +Un malinteso comune per i nuovi arrivati nei progetti di software libero è quello di credere di "non essere abbastanza competenti". Nella realtà nessuno è "sufficientemente competente" :). Quello che veramente conta è: [piacere per quello che si fa](https://www.youtube.com/watch?v=zIbR5TAz2xQ&t=113s), essere empatici con le persone del progetto, essere pazienti e testardi con i computer, e avere tempo libero. Fare il possibile è già abbastanza! + + +#### Quale è lo progetto politico di YunoHost ? + +È spiegato in [questo documento](/project_organization) :). + + +#### Potete migrare YunoHost verso la mia [distro preferita] ? + +Se vi appassiona la guerriglia tra distribuzioni, o pensate che 'Debian fa schifo', YunoHost non fa per voi. + +YunoHost è rivolto ad un pubblico di semplici appassionati, che desiderano semplicemente che tutto funzioni senza dover passare settimane a configurare un servizio. Debian ha dei difetti, ma è una tra (se non "la") le distribuzioni più conosciute e utilizzate per la gestione dei server. È stabile. La maggior parte dei servizi che si possono hostare sono in qualche modo compatibili con Debian. Debian è facilmente personalizzabile da chiunque abbia già utilizzato la linea di comando anche solo sul proprio pc. Nessuna altra distribuzione ha caratteristiche così uniche che renderebbero indispensabile la migrazione di YunoHost verso di essa. + +Se questo non vi convince, esistono altri progetti basati su altre distribuzioni e altre filosofie. + + +#### Ho studiato come funziona il packaging delle app. Perché reinventate [il mio formato preferito dei pacchetti]? + +Qualcuno ha cercato di paragonare il sistema di packaging di YunoHost con altri (come ad esempio il `.deb` di Debian) nonostante abbiano scopi diversi. I sistemi di packaging tradizionali sono pensati per installare gli elementi di basso livello come i files, comandi, programmi o servizi sul sistema. Spesso è poi delegato a voi il compito di configurarli opportunamente, semplicemente perché non esiste un ambiente standard. Normalmente le applicazioni web richiedono un importante lavoro di configurazione in quanto hanno bisogno di interfacciarsi con un server web e un database (e l'interfaccia di connessione unica / SSO). + +YunoHost esegue delle astrazioni di alto livello (applicazioni, domini, utenti...) e configura un ambiente standard (NGINX, Metronome, SSOwat...) e, grazie a questo, può gestire la configurazione invece che delegarla all'amministratore. + +#### Quando implementerete [il programma che mi piacerebbe]? Perché [la mia app preferita] non è stata compilata? Trovo incredibile che non abbiate ancora implementato [la mia app preferita]! + +Noi non fissiamo un calendario. + +Siamo una manciata di volontari che impiegano il loro tempo libero per sviluppare e mantenere YunoHost. Non abbiamo un management, non siamo un'azienda, semplicemente facciamo quello che possiamo quando possiamo e per solo amore verso questo software. + +Se desiderate che la vostra app preferita sia implementata e documentata [aiutateci](/contribute)! Non vediamo l'ora di aiutarvi a mettervi al lavoro. + +### Qual'è la policy a riguardo delle applicazioni incluse nel catalogo ufficiale? + +La regola principale è includere nel catalogo ufficiale solo programmi distribuiti con una licenza di software libero. + +Tuttavia nello sviluppo di YunoHost sono apparsi alcuni casi dubbi a causa di programmi che potrebbero essere importanti per gli scopi e che coincidono con il suo spirito pur non essendo precisamente software libero. Sono situazioni come: +- programmi che promuovono l'uso di servizi centralizzati pensato proprio per evitarne l'uso diretto; +- programmi che hanno dipendenze o altro non liberi; +- "nuove" licenze post-open-source / etiche-ma-non-libere come ad esempio [ACSL](https://anticapitalist.software/), the [HL3](https://firstdonoharm.dev/) o [CoopCycle License](https://github.com/coopcycle/coopcycle-web/blob/master/LICENSE); +- modelli "open-core", clausole di protezione di marchi o su licenze "business-related" (come ad esempio BSL) pensate per mantenere i progetti pur rimanendo eticamente accettabili. + +Pur rimanendo convinti che i principi del software libero siano un passi essenziali per quelli che sono [gli obbiettivi di YunoHost](#what-s-yunohost-goal) pensiamo anche che questi siano mezzi e non fini. Rifiutiamo la visione purista secondo la quale il software è libero o proprietario e la premessa erronea che la tecnologia sia fondamentalmente neutrale. Crediamo che i programmi e la tecnologia possano e debbano esistere oltre la definizione di software libero pensata 40 anni fa (vedi anche: [Freedom isn't Free](https://logicmag.io/failure/freedom-isnt-free/) e [Post-Open Source](https://www.boringcactus.com/2020/08/13/post-open-source.html)). + +Di conseguenza il progetto permette l'inclusione nel catalogo ufficiale ***caso per caso*** di applicazioni che non si definiscono "software libero" ma considerati etici e degni di interesse per [gli obbiettivi di YunoHost](#what-s-yunohost-goal). Queste applicazioni sono segnalate nel catalogo e un messaggio apposito viene mostrato prima dell'installazione. + +Se trovate un'applicazione mancante di tale segnalazione potete parire una discussione o aprire una pull request sul [catalogo della applicazioni](https://github.com/YunoHost/apps/). + +Se usate YunoHost per la vostra iniziativa commerciale è vostra responsabilità controllare la licenza dei programmi che volete installare sul vostro server. + +### Perché non includete la [caratteristica X]? + +YunoHost è pensata per utenti non particolarmente capaci tecnicamente e cerca di rimanere semplice nell'interfaccia. Allo stesso tempo, il progetto è tempi ed energie limitate per la manutenzione e lo sviluppo. Di conseguenza dobbiamo abbassare la priorità delle richieste di caratteristiche o anche di rifiutarle completamente basandosi sui seguenti criteri: +- è utile solo per utenti avanzati, fuori dallo scopo del progetto; +- introduce troppe complicazioni nell'interfaccia; +- copre solo problemi poco realistici; +- soddisfa solo necessità da puristi; +- e soprattutto è troppo pesante in termini di sviluppo e manutenzione, tempo ed energia rispetto al guadagno del progetto. From c8bd509f4dab2ee0a85dcf60cea501873815db2d Mon Sep 17 00:00:00 2001 From: wylel <617189+oXyiGYJ@users.noreply.github.com> Date: Thu, 2 Nov 2023 10:51:03 -0500 Subject: [PATCH 3/7] Create backup_methods.md (#2359) Added a backup_methods.md page to prevent a 403 error when clicking on Backup_methods in the navigation. --- .../10.backup_methods/backup_methods.md | 31 +++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 pages/02.administer/20.backups/10.backup_methods/backup_methods.md diff --git a/pages/02.administer/20.backups/10.backup_methods/backup_methods.md b/pages/02.administer/20.backups/10.backup_methods/backup_methods.md new file mode 100644 index 00000000..37f283b4 --- /dev/null +++ b/pages/02.administer/20.backups/10.backup_methods/backup_methods.md @@ -0,0 +1,31 @@ +--- +title: Backup Methods +template: docs +taxonomy: + category: docs +routes: + default: '/backup/backup_methods' +page-toc: + active: true + depth: 3 +--- + +## [BorgBackup](/borgbackup) +This application offers: +* backup of data on an external disk or on a remote Borg repository +* deduplication and compression of files, which allows to keep many previous copies +* data encryption, which allows you to store data with a third party +* to define the frequency and type of data to be backed up +* a mail alert system in case of backup failure. + +## [Restic](/restic) +This application offers: +* backup of data to remote storage (support for different types of storage) +* deduplication and compression of files, which makes it possible to keep many previous copies +* data encryption, which allows to store data at a third party + +## [Archivist](/archivist) +!! This application is currently broken! +This application is based on rsync and GPG, it offers: +* backup of data on a remote storage (support for different types of storage) +* data encryption, which allows to store data at a third party From 29136e143b1c60b0b9fdb8556ec99cb55d32d579 Mon Sep 17 00:00:00 2001 From: wylel <617189+oXyiGYJ@users.noreply.github.com> Date: Thu, 2 Nov 2023 10:51:22 -0500 Subject: [PATCH 4/7] Update archivist.md (#2358) Added a disclaimer warning that this application is currently broken. --- .../20.backups/10.backup_methods/03.archivist/archivist.md | 1 + 1 file changed, 1 insertion(+) diff --git a/pages/02.administer/20.backups/10.backup_methods/03.archivist/archivist.md b/pages/02.administer/20.backups/10.backup_methods/03.archivist/archivist.md index 808d5528..4debd205 100644 --- a/pages/02.administer/20.backups/10.backup_methods/03.archivist/archivist.md +++ b/pages/02.administer/20.backups/10.backup_methods/03.archivist/archivist.md @@ -10,6 +10,7 @@ page-toc: depth: 3 --- +!! This application is currently broken! To help fix this application please checkout [https://github.com/YunoHost-Apps/archivist_ynh](https://github.com/YunoHost-Apps/archivist_ynh) ## Functionality This application is based on rsync and GPG, it offers: From 478d15f8c45ed9acbee5f9ff13e144ea07c7332d Mon Sep 17 00:00:00 2001 From: Philippe Idlas <4363467+pidlas@users.noreply.github.com> Date: Sun, 5 Nov 2023 09:27:59 +0100 Subject: [PATCH 5/7] Update external_storage.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit C'est une commande bash plus courte que celle proposée initialement. --- .../45.tutorials/25.external_storage/external_storage.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/pages/02.administer/45.tutorials/25.external_storage/external_storage.md b/pages/02.administer/45.tutorials/25.external_storage/external_storage.md index 0e8a09e5..9a1b4024 100644 --- a/pages/02.administer/45.tutorials/25.external_storage/external_storage.md +++ b/pages/02.administer/45.tutorials/25.external_storage/external_storage.md @@ -214,9 +214,7 @@ If your tests are successful, you should keep the mount points, otherwise you sh To begin with, let's find the UUID (universal identifier) of our disk with : ```bash -blkid | grep "/dev/YOUR_DISK1:" -# Returns something like : -# /dev/sda1:UUID="cea0b7ae-2fbc-4f01-8884-3cb5884c8bb7" TYPE="ext4" PARTUUID="34e4b02c-02" +lsblk -f ``` Let's add a line to the `/etc/fstab` file that handles the mounting of disks at boot time. So we open the file with `nano` : From b90e1fec1b88902e08e01e5ee2db8d4970858bc6 Mon Sep 17 00:00:00 2001 From: thecijal <41804849+thecijal@users.noreply.github.com> Date: Sun, 19 Nov 2023 16:07:52 +0100 Subject: [PATCH 6/7] German translation of "Install Yunohost" (#2347) * Started german translation of "Install Yunohost" - translated "Hardware selection" and "Pre-requisites" * translated installation in WSL * continued translating: - YunoHost VPS Provider - Image Download: rpi012, virtualbox or regular, internetcube or arm_sup * finished translation of Download & Flash section * translated "power up / boot up" * translated section: "Launch the graphical install" * translated two small sections: - "Connect to the board and hotfix the image" (rpi012) - "Connect to the board" (arm_unsup) * translated some sections: - run install script - initial configuration - and post installation * translated "run initial diagnoses" section * finally! finished translation of the installation description --- pages/02.administer/10.install/install.de.md | 796 +++++++++++++++++++ 1 file changed, 796 insertions(+) create mode 100644 pages/02.administer/10.install/install.de.md diff --git a/pages/02.administer/10.install/install.de.md b/pages/02.administer/10.install/install.de.md new file mode 100644 index 00000000..f76e74ef --- /dev/null +++ b/pages/02.administer/10.install/install.de.md @@ -0,0 +1,796 @@ +--- +title: YunoHost Installieren +template: docs +taxonomy: + category: docs +never_cache_twig: true +twig_first: true +process: + markdown: true + twig: true +page-toc: + active: true + depth: 2 +routes: + default: '/install' + aliases: + - '/install_iso' + - '/install_on_vps' + - '/install_manually' + - '/install_on_raspberry' + - '/install_on_arm_board' + - '/install_on_debian' + - '/install_on_virtualbox' + - '/plug_and_boot' + - '/burn_or_copy_iso' + - '/boot_and_graphical_install' + - '/postinstall' + - '/hardware' +--- +{% set image_type = 'YunoHost' %} +{% set arm, at_home, regular, rpi34, rpi012, show_legacy_arm_menu, arm_sup, arm_unsup, vps, vps_debian, vps_ynh, virtualbox, wsl, internetcube = false, false, false, false, false, false, false, false, false, false, false, false, false, false %} +{% set hardware = uri.param('hardware') %} + +{% if hardware == 'regular' %} + {% set regular = true %} +{% elseif hardware == 'internetcube' %} + {% set arm, arm_sup, internetcube = true, true, true %} + {% set image_type = 'Internet Cube' %} + {% set show_legacy_arm_menu = true %} +{% elseif hardware == 'rpi34' %} + {% set arm, rpi34 = true, true %} +{% elseif hardware == 'rpi012' %} + {% set arm, arm_unsup, rpi012 = true, true, true %} + {% set image_type = 'Raspberry Pi OS Lite (32-bit, Bullseye)' %} +{% elseif hardware == 'arm_sup' %} + {% set arm, arm_sup = true, true %} + {% set show_legacy_arm_menu = true %} +{% elseif hardware == 'arm' %} + {% set arm, arm_unsup = true, true %} + {% set image_type = 'Armbian' %} +{% elseif hardware == 'arm_unsup' %} + {% set arm, arm_unsup = true, true %} + {% set show_legacy_arm_menu = true %} + {% set image_type = 'Armbian' %} +{% elseif hardware == 'vps_debian' %} + {% set vps, vps_debian = true, true %} +{% elseif hardware == 'vps_ynh' %} + {% set vps, vps_ynh = true, true %} +{% elseif hardware == 'virtualbox' %} + {% set at_home, virtualbox = true, true %} +{% elseif hardware == 'wsl' %} + {% set wsl = true %} +{% endif %} + +{% if arm or regular %} + {% set at_home = true %} +{% endif %} + +Wähle die Hardware, auf der du YunoHost installieren willst : +[div class="flex-container"] + +[div class="flex-child hardware{%if virtualbox %} active{% endif %}"] +[[figure caption="VirtualBox"]![](image://virtualbox.png?height=75)[/figure]](/install/hardware:virtualbox) +[/div] + +[div class="flex-child hardware{%if rpi012 or rpi34 %} active{% endif %}"] +[[figure caption="Raspberry Pi"]![](image://raspberrypi.png?height=75)[/figure]](/install/hardware:rpi34) +[/div] + +[div class="flex-child hardware{%if arm_sup or (arm_unsup and not rpi012) or internetcube %} active{% endif %}"] +[[figure caption="ARM Board"]![](image://olinuxino.png?height=75)[/figure]](/install/hardware:arm) +[/div] + +[div class="flex-child hardware{%if regular %} active{% endif %}"] +[[figure caption="Normaler Computer"]![](image://computer.png?height=75)[/figure]](/install/hardware:regular) +[/div] + +[div class="flex-child hardware{%if wsl %} active{% endif %}"] +[[figure caption="WSL"]![](image://wsl.png?height=75)[/figure]](/install/hardware:wsl) +[/div] + +[div class="flex-child hardware{%if vps_debian or vps_ynh %} active{% endif %}"] +[[figure caption="Remote Server"]![](image://vps.png?height=75)[/figure]](/install/hardware:vps_debian) +[/div] + +[/div] +[div class="flex-container pt-2"] + +{% if rpi012 or rpi34 %} +[div class="flex-child hardware{%if rpi34 %} active{% endif %}"] +[[figure caption="Raspberry Pi 3 oder 4"]![](image://raspberrypi.png?height=50)[/figure]](/install/hardware:rpi34) +[/div] + +[div class="flex-child hardware{%if rpi012 %} active{% endif %}"] +[[figure caption="Raspberry Pi 0, 1 oder 2"]![](image://rpi1.png?height=50)[/figure]](/install/hardware:rpi012) +[/div] + +{% elseif show_legacy_arm_menu %} + +[div class="flex-child hardware{%if internetcube %} active{% endif %}"] +[[figure caption="Internet cube mit VPN"]![](image://internetcube.png?height=50)[/figure]](/install/hardware:internetcube) +[/div] + +[div class="flex-child hardware{%if arm_sup and not internetcube %} active{% endif %}"] +[[figure caption="Olinuxino lime1&2 oder Orange Pi PC+"]![](image://olinuxino.png?height=50)[/figure]](/install/hardware:arm_sup) +[/div] + +[div class="flex-child hardware{%if arm_unsup %} active{% endif %}"] +[[figure caption="Andere Boards"]![](image://odroidhc4.png?height=50)[/figure]](/install/hardware:arm_unsup) +[/div] +{% elseif vps_debian or vps_ynh %} + +[div class="flex-child hardware{%if vps_debian %} active{% endif %}"] +[[figure caption="VPS oder dedizierter Server mit Debian 11"]![](image://debian-logo.png?height=50)[/figure]](/install/hardware:vps_debian) +[/div] + +[div class="flex-child hardware{%if vps_ynh %} active{% endif %}"] +[[figure caption="VPS oder dedizierter Server mit YunoHost vorinstalliert"]![](image://logo.png?height=50)[/figure]](/install/hardware:vps_ynh) +[/div] + +{% endif %} + +[/div] + + +{% if hardware != '' %} + +{% if wsl %} +!! Dieses Setup ist vorwiegend für lokales Testing durch fortgeschrittene Benutzer gedacht. Aufgrund Limitierungen auf WSL Seite (insbesondere veränderliche IP Adresse), selfhosting kann damit knifflig sein und wird hier nicht weiter beschrieben. +{% endif %} + + +## [fa=list-alt /] Pre-requisites + +{% if regular %} +* Eine x86-kompatible für YunoHost bestimmte (dedizierte) Hardware: Laptop, Nettop, Netbook, Desktop mit 512MB RAM und 16GB Speicherkapazität (Minimum) +{% elseif rpi34 %} +* Ein Raspberry Pi 3 oder 4 +{% elseif rpi012 %} +* Ein Raspberry Pi 0, 1 oder 2 mit mindestens 512MB RAM +{% elseif internetcube %} +* Ein Orange Pi PC+ oder ein Olinuxino Lime 1 oder 2 +* Ein VPN mit einer festen öffentlichen IP Adresse und einer `.cube` Datei +{% elseif arm_sup %} +* Ein Orange Pi PC+ oder ein Olinuxino Lime 1 oder 2 +{% elseif arm_unsup %} +* Ein ARM Board mit mindestens 512MB RAM +{% elseif vps_debian %} +* Ein dedizierter oder Virtual Private Server mit Debian 11 (Bullseye) (mit **kernel >= 3.12**) vorinstalliert, 512MB RAM und 16GB Speicherkapazität (Minimum) +{% elseif vps_ynh %} +* Ein dedizierter oder Virtual Private Server mit YunoHost vorinstalliert, 512MB RAM und 16GB Speicherkapazität (Minimum) +{% elseif virtualbox %} +* Ein x86 Computer mit [VirtualBox installiert](https://www.virtualbox.org/wiki/Downloads) und ausreichend Arbeitsspeicherkapazität (RAM), um eine kleine virtuelle Maschine mit 1024MB RAM und 8GB Speicherkapazität (Minimum) betreiben zu können +{% endif %} +{% if arm %} +* Eine Spannungsversorung (entweder ein Netzteil oder ein MicroUSB Kabel) für dein Board; +* Eine microSD Karte: 16GB Speicherkapazität (Minimum), [class "A1"](https://en.wikipedia.org/wiki/SD_card#Class) nachdrücklich empfohlen (so wie [diese SanDisk A1 Karte](https://www.amazon.fr/SanDisk-microSDHC-Adaptateur-homologu%C3%A9e-Nouvelle/dp/B073JWXGNT/)); +{% endif %} +{% if regular %} +* Ein USB Stick mit mindestens 1GB Speicherkapazität ODER einem Standard CD-Rohling +{% endif %} +{% if wsl %} +* Windows 10 und neuer +* Administrator Rechte +* Windows Subsystem for Linux, aus dem Optional Features Menü von Windows installiert +* *Empfohlen:* Windows Command Prompt App, aus dem Microsoft Store installiert. Viel besser als der Standard Terminal, weil sie Shortcuts für WSL distros bietet. +{% endif %} +{% if at_home %} +* Ein [vernünftiger ISP](/isp), vorzugsweise mit einer guten und unbegrenzten Upstream Bandbreite +{% if not virtualbox %} +* Ein Ethernet Kabel (RJ-45), um deinen Server mit deinem Router zu verbinden. {% if rpi012 %} (Oder, für Rasperry Pi Zero : und USB OTG oder ein Wifi Dongle) {% endif %} +{% endif %} +* Ein Computer, um diese Anleitung zu lesen, das Image zu flashen und auf deinen Server zuzugreifen. +{% else %} +* Ein Computer oder ein Smartphone, um diese Anleitung zu lesen und auf deinen Server zuzugreifen. +{% endif %} + +{% if virtualbox %} +! Anmerkung : YunoHost in einer VirtualBox zu installieren ist normalerweise nur zu Test- oder Entwicklungszwecken gedacht . Es ist nicht dafür geeignet einen wirklichen Server langfristig zu betreiben, weil die Machine auf der es installiert ist wahrscheinlich nicht 24/7 laufen wird und weil VirtualBox eine zusätzliche Komplexitätsschicht beim Freigeben der Maschine zum Internet mitbringt. +{% endif %} + +{% if wsl %} +## Vorstellung +WSL ist ein cooles Windows 10 Feature, das Linux pseudo-Distributionen durch die Kommandozeile verfügbar macht. Lass es uns pseudo nennen, weil auch obwohl sie nicht wirklich wie virtuelle Maschinen sind, sind sie auf Virtualisierungskapazitäten angewiesen, die deren Integration mit Windows fast nahtlos machen. +So kann z.B. Docker für Windows jetzt auf WSL bauen, anstatt auf Hyper-V. + +! Beachte, dass dieses Setup selbst *kein* Container jeglicher Art ist. Falls etwas bricht, gibt es keine Rollback Möglichkeit. +! Vielleicht musst du die Debian Distro vollkommen löschen und ganz wiederherstellen. + +## Installation in Debian 11 + +Lass uns YunoHost in einem PowerShell Terminal in seine eigene Distro installieren und nicht die default Distro verändern: + +```bash +# Geh in dein home Verzeichnis und bereite die Arbeitsverzeichnisse vor +cd ~ +mkdir -p WSL\YunoHost +# Lade das Debian appx Paket herunter und entpacke es (unzip) +curl.exe -L -o debian.zip https://aka.ms/wsl-debian-gnulinux +Expand-Archive .\debian.zip -DestinationPath .\debian +# Importiere Debian als Grundlage in eine neue Distro +wsl --import YunoHost ~\WSL\YunoHost ~\debian\install.tar.gz --version 2 +# Aufräumen +rmdir .\debian -R +``` + +Nun kannst du darauf zugreifen: Führe `wsl.exe -d YunoHost` aus. + +Da es Debian 9 Stretch ist, lass uns ein Upgrade auf Debian 11 Bullseye machen: + +```bash +# In WSL +sudo sed -i 's/stretch/bullseye/g' /etc/apt/sources.list` +sudo apt update +sudo apt upgrade +sudo apt dist-upgrade +``` +## Verhindern, dass WSL an Konfigurationsdateien herumfeilt + +Bearbeite `/etc/wsl.conf` und füge den folgenden Code darin ein: + +``` +[network] +generateHosts = false +generateResolvConf = false +``` + +## Erzwinge die Verwendung von iptables-legacy + +Irgendwie mag die YunoHost Post-Installation `nf_tables` nicht, die neue Software ersetzt `iptables`. +Wir können trotzdem immer noch explizit die guten alten `iptables` benutzen: + +```bash +# In WSL +sudo update-alternatives --set iptables /usr/sbin/iptables-legacy +sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy +``` + +## Systemd installieren + +Unter WSL fehlt Debian `systemd`, eine Service-Konfigurations-Software. +Diese ist ein Schlüsselelement für YunoHost, und für jede anständige Debian Distro (also ernsthaft Microsoft, was zum Henker). Lass es uns installieren: + +1. Installation der dotNET Runtime: +```bash +# In WSL +wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb +sudo dpkg -i packages-microsoft-prod.deb +sudo apt update +sudo apt install -y apt-transport-https +sudo apt update +sudo apt install -y dotnet-sdk-3.1 +``` + +2. Installation von [Genie](https://github.com/arkane-systems/genie): +```bash +# In WSL +# Das repository hinzufügen +echo "deb [trusted=yes] https://wsl-translinux.arkane-systems.net/apt/ /" > /etc/apt/sources.list.d/wsl-translinux.list +# Genie installieren +sudo apt update +sudo apt install -y systemd-genie +``` + +## YunoHost Installation + +```bash +# In WSL +# zum root user wechseln, wenn you das nicht schon bist +sudo su +# Die Genie Flasche initialisiern, um systemd am Laufen zu haben +genie -s +# Dein hostname sollte mit "-wsl" enden +# Installiere YunoHost +curl https://install.yunohost.org | bash -s -- -a +``` + +### Öffne die Kommandozeile + +Rufe `genie -s` immer während des Startes deiner Distro auf. + +`wsl -d YunoHost -e genie -s` + +## Backup und Wiederherstellung der Distro +### Mache dein erstes Distro Backup +Wie zuvor gesagt, gibt es keine Rollback Möglichkeit. Lass uns deshal deine frische Distro exportieren. In PowerShell: + +``` +cd ~ +wsl --export YunoHost .\WSL\YunoHost.tar.gz +``` + +### Im Falle eines Crash, lösche und stelle die gesamte Distro wieder her + +``` +cd ~ +wsl --unregister YunoHost +wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2 +``` +{% endif %} + + +{% if vps_ynh %} +## YunoHost VPS Provider + +Hier sind ein paar VPS Provider, die YunoHost nativ unterstützen : + +[div class="flex-container"] + +[div class="flex-child"] +[[figure caption="Alsace Réseau Neutre - FR"]![](image://vps_ynh_arn.png?height=50)[/figure]](https://vps.arn-fai.net) +[/div] +[div class="flex-child"] +[[figure caption="FAImaison - FR"]![](image://vps_ynh_faimaison.svg?height=50)[/figure]](https://www.faimaison.net/services/vm.html) +[/div] +[div class="flex-child"] +[[figure caption="Association ECOWAN - FR"]![](image://vps_ynh_ecowan.png?height=50)[/figure]](https://www.ecowan.fr/vps-linux) +[/div] +[/div] +{% endif %} + + +{% if at_home %} +## [fa=download /] Lade das {{image_type}} Image herunter + +{% if rpi012 %} +! Leider wird der Support für Rasperry Pi 0, 1 und 2 so langsam eingestellt : Das Bauen neuer Images ist komplex und RPi 0, 1 und 2 sind ARM-32bit Systeme, die über die Zeit mehr und mehr veralten (deprecated) werden. Da unsere vorinstallierten Images ziemlich alt sind, empfehlen wir stattdessen das [offizielle Rasperry Pi OS Lite (**32-bit**, **Bullseye**)](https://downloads.raspberrypi.org/raspios_lite_armhf/images/?C=M;O=D) zu downloaden und YunoHost [unter Verwendung ähnlicher Instruktionen wie für andere ARM Boards](/install/hardware:arm) oben drauf zu installieren. +{% endif %} + +{% if virtualbox or regular %} +!!! Achte darauf, dass du das 32-bit Image herunterlädst, wenn dein Host ein 32 Bit System ist. +{% elseif arm_unsup and not rpi012 %} +[fa=external-link] Lade das Image für dein Board auf der Armbian Website herunter. + +!!! Anmerkung: Du solltest das Image Armbian Bullseye downloaden. +{% endif %} + +!!! Wenn du die Validität deiner signierten Images prüfen will, kannst du [unseren public key downloaden](https://forge.yunohost.org/yunohost.asc). + +{% if internetcube or arm_sup %} +! Aktuelle Images stammen von Debian Buster (YunoHost v4.x) und erfordern, dass du einen manuellen apt update Befehl per SSH oder CLI durchführst, um weiter zu aktualisieren. +! Antworte mit Ja auf die Warnung über den Wechsel von stable zu oldstable. +{% endif %} + +
+
+
+
+ + + + + + + + +{% if not virtualbox %} + +{% if arm %} +## ![microSD Karte mit Adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash das {{image_type}} Image +{% else %} +## ![USB Stick](image://usb_key.png?resize=100,100&class=inline) Flash das YunoHost Image +{% endif %} + +Jetzt wo du das Image von {{image_type}} heruntergeladen hast, solltest du es auf {% if arm %}einer microSD Karte{% else %}einem USB stick oder einer CD/DVD flashen.{% endif %} + +[ui-tabs position="top-left" active="0" theme="lite"] +[ui-tab title="(Empfohlen) Mit Etcher"] + +Lade Etcher für dein Betriebssystem herunter und installiere es. + +Steck {% if arm %}die SD Karte{% else %}den USB Stick{% endif %} an, wähle dein Image und klicke "Flash". + +![Etcher](image://etcher.gif?resize=700&class=inline) + +[/ui-tab] +[ui-tab title="Mit USBimager"] + +Lade [USBimager](https://bztsrc.gitlab.io/usbimager/) für dein Betriebssystem herunter und installiere es. + +Steck {% if arm %}die SD Karte{% else %}den USB Stick{% endif %} an, wähle dein Image und klicke "Write". + +![USBimager](image://usbimager.png?resize=700&class=inline) + +[/ui-tab] +[ui-tab title="Mit dd Befehl"] + +Wenn du mit GNU/Linux / macOS arbeitest und dich mit der Kommandozeile auskennst, kannst du deinen USB Stick oder deine SD Karte auch mit `dd` flashen. Du kannst mit `fdisk -l` oder `lsblk` feststellen welches Device deinem USB stick oder deiner SD Karte entspricht. Ein typischer SD Karten Name ist sowas wie `/dev/mmcblk0`. SEI VORSICHTIG und stelle sicher, dass du den richtigen Namen hast. + +Führe dann Folgendes aus : + +```bash +# Ersetze /dev/mmcblk0 durch das richtige Device, wenn der Name deines Device anders ist... +dd if=/path/to/yunohost.img of=/dev/mmcblk0 +``` +[/ui-tab] +{% if regular %} +[ui-tab title="Eine CD/DVD brennen"] +Für ältere Geräte könntest du eine CD/DVD brennen wollen. Die zu verwendende Software hängt von deinem Betriebssystem ab. + +* Auf Windows, benutze [ImgBurn](http://www.imgburn.com/), um die Image Datei auf die Disc zu schreiben. + +* Auf macOS, benutze [Disk Utility](http://support.apple.com/kb/ph7025) + +* Auf GNU/Linux hat man eine große Auswahl, wie [Brasero](https://wiki.gnome.org/Apps/Brasero) oder [K3b](http://www.k3b.org/) +[/ui-tab] +{% endif %} +[/ui-tabs] + +{% else %} + +## Erzeuge eine neue virtuelle Maschine + +![](image://virtualbox_1.png?class=inline) + +! Es ist in Ordnung, wenn du nur 32-bit Versionen haben kannst. Sei einfach sicher, dass du zuvor das 32-bit Image heruntergeladen hast. + +## Netzwerk Einstellungen justieren + +! Dieser Schritt ist wichtig, um die virtuelle Maschine ordnungsgemäß im Netzwerk zugänglich zu machen. + +Gehe zu **Settings** > **Network**: + +* Wähle `Bridged adapter` +* Wähle den Namen deines Interface: + **wlan0**, wenn du kabellos verbunden bist, oder andernfalls **eth0**. + +![](image://virtualbox_2.png?class=inline) + +{% endif %} + + + + + + + + + +{% if arm %} +## [fa=plug /] Das Board einschalten + +* Schließe das Ethernet Kabel an (ein Ende an deinem Router, das andere an deinem Board). + * Fortgeschrittene Nutzer, die das Board konfigurieren möchten, um sich stattdessen per WiFi zu verbinden, können bspw. [hier](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md) nachlesen. +* Stecke die SD Karte in dein Board. +* (Optional) Du kannst Bildschirm+Tastatur direkt an deinem Board anschließen, wenn du Fehler am Boot Prozess beheben willst oder wenn du dich wohler fühlst zu "sehen was passiert" oder du direkten Zugriff auf das Board haben willst. +* Schalte das Board ein. +* Warte ein paar Minuten während sich das Board beim ersten Boot automatisch selbst konfiguriert. +* Stelle sicher, dass dein Computer (Desktop/Laptop) mit dem selben lokalen Netzwerk verbunden ist (z.B. mit der selben Internet Box) wie dein Server. + +{% elseif virtualbox %} +## [fa=plug /] Die virtuelle Maschine hochfahren + +Starte die virtuelle Maschine nach der Auswahl des YunoHost Image. + +![](image://virtualbox_2.1.png?class=inline) + +! Wenn du an den Fehler "VT-x ist nicht erreichbar" gerätst, musst du wahrscheinlich Virtualisierung im BIOS deines Computers einschalten. + + +{% else %} +## [fa=plug /] Die Maschine von deinem USB Stick booten + +* Schließe das Ethernet Kabel an (ein Ende an deinem Router, das andere an deinem Board). +* Fahre deinen Server mit dem USB Stick oder einer eingesteckten CD-ROM hoch und wähle es durch Drücken einer der folgenden (Hardware spezifischen) Tasten als **bootable device** aus: +``, ``, ``, ``, `` oder ``. + * Anmerkung: Wenn auf dem Server zuvor eine aktuelle Windows Version (8+) installiert war, musst du Windows zuerst "actually reboot" sagen. Das kann irgendwo in "Advanced startup options" gemacht werden. +{% endif %} + +{% if regular or virtualbox %} +## [fa=rocket /] Die grafische Installation starten + +Du solltest einen Bildschirm wie diesen sehen: + +[figure class="nomargin" caption="Vorschau des ISO Menüs"] +![](image://virtualbox_3.png?class=inline) +[/figure] +[ui-tabs position="top-left" active="0" theme="lite"] + +[ui-tab title="Klassische Installation auf einer ganzen Festplatte"] + +!! Anmerkung: Sobald du das Tastaturlayout bestätigt hast, wird die Installation gestartet und die Daten auf deiner Festplatte werden vollständig gelöscht! + + 1. Wähle `Graphical install` aus + 2. Wähle deine Sprache, deinen Standort, dein Tastaturlayout und schließlich deine Zeitzone aus. + 3. Das Installationsprogramm lädt dann alle erforderlichen Pakete herunter und installiert sie. + +[/ui-tab] +[ui-tab title="Installation im Expertenmodus"] + +Das YunoHost-Projekt hat die klassische Installation so weit wie möglich vereinfacht, damit sich möglichst viele Menschen nicht in zu technischen oder fallbezogenen Fragen verlieren. + +Mit der Installation im Expertenmodus hast du mehr Möglichkeiten, insbesondere was die genaue Partitionierung deiner Speichermedien betrifft. Du kannst dich auch für den klassischen Modus entscheiden und [deine Festplatten anschließend hinzufügen](/external_storage). + +### Zusammenfassung der Schritte im Expertenmodus: + 1. Wähle `Expert graphical install` aus. + 2. Wähle deine Sprache, deinen Standort, dein Tastaturlayout und möglicherweise deine Zeitzone aus. + 3. Partitioniere deine Festplatten. Hier kanst du ein RAID einrichten oder den Server ganz oder teilweise verschlüsseln. + 4. Gib einen möglichen HTTP-Proxy an, der für die Installation der Pakete verwendet werden soll. + 5. Gib an, auf welchen Volumes Grub installiert werden soll. + +### Bezüglich der Partitionierung + +Im Allgemeinen raten wir davon ab, „/var“, „/opt“, „/usr“, „/bin“, „/etc“, „/lib“, „/tmp“ und „/root“ auf separaten Partitionen zu partitionieren. Dadurch musst du dir keine Sorgen über volle Partitionen machen, die deinen Computer zum Absturz bringen, zum Scheitern von App-Installationen führen oder sogar deine Datenbanken beschädigen könnten. + +Aus Performance Gründen wird empfohlen, den schnellsten Speicher (SSD) als root `/` zu mounten. + +Wenn du über eine oder mehrere Festplatten zum Speichern von Daten verfügst, kannst du diese je nach Nutzung in einem dieser Ordner bereitstellen: + +| Path | Contents | +|--------|---| +| `/home` | Benutzerordner, auf die über SFTP zugegriffen werden kann | +| `/home/yunohost.backup/archives` | YunoHost-Backups, die idealerweise an anderer Stelle als auf den Datenträgern platziert werden, auf denen die Daten verwaltet werden | +| `/home/yunohost.app` | Umfangreiche Datenmengen aus YunoHost Apps (nextcloud, matrix...) | +| `/home/yunohost.multimedia` | Große Datenmenge, die von mehreren Anwendungen gemeinsam genutzt wird | +| `/var/mail` | User mail + +Wenn du Flexibilität haben möchtest und die Größe von Partitionen nicht (verändern) möchtest, kannst du dich auch dafür entscheiden, auf `/mnt/hdd` zu mounten und dieser [Anleitung zum Mounten aller dieser Ordner mit `mount --bind`](/external_storage) zu folgen. + +### Über Verschlüsselung +Beachte: Wenn du deine Festplatten ganz oder teilweise verschlüsselst, musst du bei jedem Neustart deines Servers die Passphrase eingeben. Das kann ein Problem darstellen, wenn du nicht vor Ort bist. Es gibt jedoch (ziemlich schwierig zu implementierende) Lösungen, die es dir ermöglichen, die Passphrase über SSH oder über eine Webseite einzugeben (suche nach "Dropbear Encrypted Disk"). + +### Über RAID +Denk daran, dass: + * die Festplatten in deinen RAIDs von unterschiedlichen Marken, Abnutzungserscheinungen oder Chargen sein müssen (insbesondere, wenn es sich um SSDs handelt). + * ein RAID 1 (auch ohne Ersatz) aus Wahrscheinlichkeitssicht zuverlässiger als ein RAID 5 ist. + * und Hardware-Raids von der Raid-Karte abhängen. Wenn die Karte ausfällt, benötigst du einen Ersatz, um das Array zu lesen und neu aufzubauen. + +[/ui-tab] +[/ui-tabs] +{% endif %} + + +{% if rpi012 %} +## [fa=bug /] Mit dem Board verbinden und das Image per Hotfix reparieren +Raspberry Pi 1 und 0 werden aufgrund von [Kompilierungsproblemen für diese Architektur](https://github.com/YunoHost/issues/issues/1423) nicht vollständig unterstützt. + +Es ist jedoch möglich, das Image selbst zu reparieren, bevor du die Erstkonfiguration ausführst. + +Um das zu erreichen, musst du dich auf deinem Raspberry Pi als Root-Benutzer [über SSH](/ssh) mit dem temporären Passwort „yunohost“ verbinden: +``` +ssh root@yunohost.local +``` +(oder „yunohost-2.local“ usw., wenn sich mehrere YunoHost-Server in deinem Netzwerk befinden) + +Führe dann die folgenden Befehle aus, um das Metronomproblem zu umgehen: +``` +mv /usr/bin/metronome{,.bkp} +mv /usr/bin/metronomectl{,.bkp} +ln -s /usr/bin/true /usr/bin/metronome +ln -s /usr/bin/true /usr/bin/metronomectl +``` + +Und diesen hier, um das UpnPC-Problem zu umgehen: +``` +sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py +``` + +! Der letzte Befehl muss nach jedem Yunohost-Upgrade ausgeführt werden :/ + +{% elseif arm_unsup %} +## [fa=terminal /] Verbindung zum Board + +Als nächstes musst du [die lokale IP-Adresse deines Servers finden](/finding_the_local_ip), um dich als Root-Benutzer [über SSH](/ssh) mit dem temporären Passwort `1234` zu verbinden. + +``` +ssh root@192.168.x.xxx +``` + +{% endif %} + +{% endif %} + + +{% if vps_debian or arm_unsup %} +## [fa=rocket /] Das Installationsskript ausführen + +- Öffne eine Kommandozeile auf deinem Server (entweder direkt oder [über SSH](/ssh)) +- Stelle sicher, dass du Root bist (oder gib „sudo -i“ ein, um Root zu werden) +- Führe den folgenden Befehl aus: + +```bash +curl https://install.yunohost.org | bash +``` + +!!! Falls `curl` nicht auf deinem System installiert ist, kann es sein, dass du es mit `apt install curl` installieren musst. +!!! Falls der Befehl nichts bewirkt, kann es sein, dass du möglicherweise `apt install ca-certificates` ausführen musst. + +!!! **Hinweis für fortgeschrittene Benutzer, die sich mit dem `curl|bash`-Ansatz befassen approach:** Ziehe das Lesen von ["Ist curl|bash unsicher?"](https://sandstorm.io/news/2015-09-24-is-curl-bash-insecure-pgp-verified-install) auf Sandstoms Blog und möglicherweise [diese Diskussion auf Hacker News](https://news.ycombinator.com/item?id=12766350&noprocess) in Erwägung. + +{% endif %} + +## [fa=cog /] Mit der Erstkonfiguration fortfahren + +!!! Wenn du dabei bist, einen Server mithilfe eines YunoHost-Backups wiederherzustellen, solltest du diesen Schritt überspringen und [anstelle des Postinstallationsschritts das Backup wiederherstellen](/backup#restoring-during-the-postinstall). + +[ui-tabs position="top-left" active="0" theme="lite"] +[ui-tab title="Über die Weboberfläche"] +{%if at_home %} +Gib in einem Internet Browser **{% if internetcube %}`https://internetcube.local`{% else %}`https://yunohost.local` (oder `yunohost-2.local` usw., wenn mehrere YunoHost Server in deinem Netzwerk sind){% endif %}** ein. + +!!! Wenn das nicht funktioniert, kannst du [nach der lokalen IP-Adresse deines Servers suchen](/finding_the_local_ip). Die Adresse sieht normalerweise wie `192.168.x.y` aus und du solltest daher `https://192.168.x.y` in die Adressleiste deines Browsers eingeben. +{% else %} +Du kannst die Erstkonfiguration mit der Weboberfläche durchführen, indem du in die Adresszeile deines Webbrowsers **die öffentliche IP-Adresse deines Servers** eingibst. Normalerweise sollte dir dein VPS-Anbieter die IP des Servers mitgeteilt haben. +{% endif %} + +! Beim ersten Besuch wirst du höchstwahrscheinlich auf eine Sicherheitswarnung bezüglich des vom Server verwendeten Zertifikats stoßen. Im Moment verwendet dein Server ein selbstsigniertes Zertifikat. {% if not wsl %}Später kannst du ein von Webbrowsern automatisch erkanntes Zertifikat hinzufügen, wie in der [Zertifikatdokumentation](/certificate) beschrieben ist. {% endif %} Zunächst solltest du eine Sicherheitsausnahme hinzufügen, um das aktuelle Zertifikat zu akzeptieren. (Aber BITTE gewöhne dir nicht an, diese Art von Sicherheitswarnung blind zu akzeptieren!) + +{% if not internetcube %} +Dann solltest du auf dieser Seite landen: + +[figure class="nomargin" caption="Vorschau der Web-Erstkonfigurationsseite"] +![Initial configuration page](image://postinstall_web.png?resize=100%&class=inline) +[/figure] + +{% endif %} +[/ui-tab] +[ui-tab title="Mit der Kommandozeile"] + +Du kannst die Post-Installation auch mit dem Befehl `yunohost tools postinstall` direkt auf dem Server oder [über SSH](/ssh) durchführen. + +[figure class="nomargin" caption="Vorschau der Kommandozeile nach der Post-Installation"] +![Initial configuration with CLI](image://postinstall_cli.png?resize=100%&class=inline) +[/figure] + +[/ui-tab] +[/ui-tabs] + +{% if not internetcube %} + +##### [fa=globe /] Haupt-Domain + +Dies ist die Domäne, über die die Benutzer deines Servers auf das **Authentifizierungsportal** zugreifen. Du kannst später weitere Domains hinzufügen und bei Bedarf ändern, welche Domain die Haupt-Domain ist. + +{% if not wsl %} + +* Wenn du neu im Self-Hosting bist und noch keinen Domain-Namen hast, empfehlen wir die Verwendung eines **.nohost.me** / **.noho.st** / **.ynh.fr** (z.B. `homersimpson.nohost.me`). Sofern die Domain noch nicht vergeben ist, wird sie automatisch konfiguriert und du benötigst keinen weiteren Konfigurationsschritt. Bitte beachte, dass der Nachteil darin besteht, dass du nicht die vollständige Kontrolle über die DNS-Konfiguration hast. + +* Wenn du bereits einen Domain-Namen besitzt, möchtest du ihn wahrscheinlich hier verwenden. Später musst du DNS-Einträge konfigurieren, so wie [hier](/dns_config) beschrieben. + +!!! Ja, du *musst* eine Domain-Namen konfigurieren. Wenn du keinen Domain-Namen hast und auch keine **.nohost.me** / **.noho.st** / **.ynh.fr** möchtest, kannst du eine Dummy-Domain einrichten wie `yolo.test` und passt deine **lokale** `/etc/hosts` Datei so an, dass diese Dummy-Domain [auf die entsprechende IP verweist, wie hier erklärt](/dns_local_network). + +{% else %} + +Du musst eine Fake-Domain wählen, da diese von außen nicht zugänglich ist. +Zum Beispiel `ynh.wsl`. Der schwierige Teil besteht darin, diese Domain bei deinem Host zu bekannt zu machen. + +Ändere deine `C:\Windows\System32\drivers\etc\hosts` Datei. Du solltest eine Zeile haben, die mit `::1` beginnt. Aktualisiere sie oder füge sie bei Bedarf hinzu, um Folgendes zu erhalten: + +``` +::1 ynh.wsl localhost +``` + +Wenn du Subdomains erstellen möchtest, denk daran, diese auch in der Datei `hosts` hinzuzufügen: + +``` +::1 ynh.wsl subdomain.ynh.wsl localhost +``` + +{% endif %} + +##### [fa=key /] Der erste Benutzer + +[Seit YunoHost 11.1](https://forum.yunohost.org/t/yunohost-11-1-release-sortie-de-yunohost-11-1/23378) wird in dieser Phase der erste Benutzer erstellt. Du solltest einen Benutzernamen und ein einigermaßen komplexes Passwort wählen. (Wir können nicht genug betonen, dass das Passwort **robust** sein sollte!) Dieser Benutzer wird der Administratoren-Gruppe hinzugefügt und kann daher auf das Benutzerportal und die Webadministrationsoberfläche zugreifen und eine Verbindung [über **SSH**](/ssh) oder [**SFTP**](/filezilla) herstellen. Administratoren erhalten außerdem E-Mails an `root@yourdomain.tld` und `admin@yourdomain.tld`: Diese E-Mails können zum Versenden technischer Informationen oder Warnungen verwendet werden. Du kannst später weitere Benutzer hinzufügen, die du auch zur Administratoren-Gruppe hinzufügen kannst. + +Dieser Benutzer ersetzt den alten `admin` Benutzer, auf den sich einige alte Dokumentationsseiten möglicherweise noch beziehen. In diesem Fall: Ersetzen Sie einfach `admin` durch Ihren Benutzernamen. + + +## [fa=stethoscope /] Die Erstdiagnose durchführen + +Sobald die Post-Installation abgeschlossen ist, solltest du dich tatsächlich mit den Credentials des ersten Benutzers, den du gerade erstellt hast, bei der Webadministrationsoberfläche anmelden können. + +{% if wsl %} +! Erinngerung: YunoHost wird in der WSL von außen wahrscheinlich nicht erreichbar sein und ihr können keine echten Domains und Zertifikate zugewiesen werden. +{% endif %} +{% if virtualbox %} +! Erinnerung: YunoHost wird in VirtualBox ohne weitere Netzwerkkonfiguration in den Virtualbox-Einstellungen wahrscheinlich nicht von außen erreichbar sein. Die Diagnose wird sich darüber wahrscheinlich beschweren. +{% endif %} + +Das Diagnosesystem soll eine einfache Möglichkeit bieten, zu überprüfen, ob alle kritischen Aspekte deines Servers ordnungsgemäß konfiguriert sind – und dich bei der Behebung von Problemen unterstützen. Die Diagnose wird zweimal täglich ausgeführt und sendet eine Warnung, wenn Probleme erkannt werden. + +!!! Anmerkung : **Lauf nicht davon** ! Wenn du die Diagnose zum ersten Mal ausführst, ist es durchaus zu erwarten, dass eine Reihe gelber/roter Warnungen angezeigt werden, da du normalerweise [DNS-Einträge konfigurieren](/dns_config) musst (wenn du keine `.nohost.me`/`noho.st`/`ynh.fr` Domain verwendest). Lege ein Swapfile an, wenn nicht genügend RAM vorhanden ist {% if at_home %} und/oder richte [Portweiterleitung](/isp_box_config) ein.{% endif %} + +!!! Ist eine Warnung für dich nicht relevant (z.B. weil du nicht vor hast, eine bestimmte Funktion zu verwenden), ist es völlig in Ordnung, das Problem als 'ignoriert' zu markieren, indem du im Webadmin > Diagnose auf den "Ignorieren" Button (für diese bestimmte Funktion) klickst. + + +[ui-tabs position="top-left" active="0" theme="lite"] +[ui-tab title="(Empfohlen) Über die Weboberfläche"] +Um eine Diagnose auszuführen, gehe im Web Admin auf den Abschnitt "Diagnose". Klicke auf "Erstdiagnose ausführen". Du solltest nun einen Bildschirm wie diesen erhalten: + +[figure class="nomargin" caption="Vorschau des Diagnosepanels"] +![](image://diagnostic.png?resize=100%&class=inline) +[/figure] + +[/ui-tab] +[ui-tab title="In der Kommandozeile"] +``` +yunohost diagnosis run +yunohost diagnosis show --issues --human-readable +``` +[/ui-tab] +[/ui-tabs] + +## [fa=lock /] Ein Let's Encrypt Zertifikat holen + +Sobald du die DNS-Einträge und die Portweiterleitung (falls erforderlich) konfiguriert hast, solltest du ein Let's Encrypt-Zertifikat einrichten können. Dadurch entfällt für neue Besucher die gruselige Sicherheitswarnung von vorhin. + +Ausführlichere Anweisungen oder weitere Informationen zu SSL/TLS-Zertifikaten findest du [hier auf der entsprechenden Seite](/certificate). + +[ui-tabs position="top-left" active="0" theme="lite"] +[ui-tab title="Über die Weboberfläche"] + +Gehe zu Domains > Klicke auf deine Domain > SSL Zertifikat + +[figure class="nomargin" caption="Vorschau des Diagnosepanels"] +![](image://certificate-before-LE.png?resize=100%&class=inline) +[/figure] + +[/ui-tab] +[ui-tab title="In der Kommandozeile"] +``` +yunohost domain cert install +``` +[/ui-tab] +[/ui-tabs] + +## ![](image://tada.png?resize=32&classes=inline) Gratulation! + +Jetzt hast du ein sehr gut konfigurierten Server. Wenn du neu bei YunoHost bist, empfehlen wir dir, einen Blick auf [die geführte Tour](/overview) zu werfen. Du solltest auch in der Lage sein, [deine Lieblingsanwendungen zu installieren](/apps). Vergiss nicht, [Backups zu planen](/backup)! + +{% endif %} +{% endif %} From d3d5d083364974763199757046ff5279c0d4686c Mon Sep 17 00:00:00 2001 From: jdmyqr <145451925+jdmyqr@users.noreply.github.com> Date: Sun, 19 Nov 2023 10:00:42 -0600 Subject: [PATCH 7/7] Update change_admin_password.md yunohost tools adminpw doesn't work. yunohost itself states to use rootpw instead. corrected documentation. off to a great start, i am! --- .../10.admin_password/change_admin_password.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/02.administer/50.troubleshooting/10.admin_password/change_admin_password.md b/pages/02.administer/50.troubleshooting/10.admin_password/change_admin_password.md index 1abba53a..d01d6eb6 100644 --- a/pages/02.administer/50.troubleshooting/10.admin_password/change_admin_password.md +++ b/pages/02.administer/50.troubleshooting/10.admin_password/change_admin_password.md @@ -24,5 +24,5 @@ Then go to Tools > Change administration password. ```bash -yunohost tools adminpw +yunohost tools rootpw ```