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

markdown format

Browse source
This commit is contained in:
OniriCorpe 2024-03-01 23:00:03 +01:00
parent 5b19538228
commit 6ac37654c4
276 changed files with 2665 additions and 2218 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
orphaned/default.es.md
View file

@ -2,10 +2,10 @@
Esta página todavía no existe, puedes editarla tecleando ```<Escap>``` en tu teclado, o clicando en el botón "Editar" abajo a la derecha de tu pantalla. Puedes echar un vistazo a los cambios que has efectuado empujando de nuevo la tecla ```<Escap>``` o clicando en el botón "Vistazo".
** Nota : ** Necesitarás una dirección email para validar tu propuesta.
**Nota :** Necesitarás una dirección email para validar tu propuesta.
### Sintaxis
Esta página utiliza la sintaxis Markdown, refiérete a la documentación para más informaciones :
http://daringfireball.net/projects/markdown/syntax
<http://daringfireball.net/projects/markdown/syntax>

6
orphaned/default.fr.md
View file

@ -2,10 +2,10 @@
Cette page n’existe pas encore, vous pouvez l’éditer en appuyant sur la touche ```<Échap>``` de votre clavier, ou en cliquant sur le bouton "Éditer" en bas à droite de votre écran. Vous pourrez avoir un aperçu de vos changements en appuyant à nouveau sur la touche ```<Échap>``` ou en cliquant sur le bouton "Aperçu".
** Note : ** Vous aurez besoin d'une adresse email pour valider votre proposition.
**Note :** Vous aurez besoin d'une adresse email pour valider votre proposition.
### Syntaxe
Cette page utilise la syntaxe Markdown, veuillez vous référer à la documentation pour plus d’informations :
http://daringfireball.net/projects/markdown/syntax
<http://daringfireball.net/projects/markdown/syntax>

4
orphaned/default.it.md
View file

@ -2,10 +2,10 @@
Questa pagina non è ancora stata creata, puoi modificarla premendo ```<ESC>``` sulla tua tastiera o cliccando il pulsante "Modifica" in basso a destra del tuo schermo. Potrai vedere l'anteprima delle tue modifiche premendo ancora ```<ESC>``` o cliccando il pulsante "Anteprima".
** Nota: ** Devi fornire un indirizzo email per confermare le tue modifiche.
**Nota:** Devi fornire un indirizzo email per confermare le tue modifiche.
### Sintassi
Questa pagina usa la sintassi markdown, per favore fai riferimento alla documentazione per ulteriori informazioni:
http://daringfireball.net/projects/markdown/syntax
<http://daringfireball.net/projects/markdown/syntax>

4
orphaned/default.md
View file

@ -2,10 +2,10 @@
This page is not created yet, you can edit it by pressing ```<ESC>``` on your keyboard or by clicking the "edit" button on the bottom-right side of your screen. You will be able to preview your changes by pressing ```<ESC>``` again or by clicking the "preview" button.
** Note: ** You will need to provide an email address to validate your submission.
**Note:** You will need to provide an email address to validate your submission.
### Syntax
This page use the markdown syntax, please refer to the documentation for further informations:
http://daringfireball.net/projects/markdown/syntax
<http://daringfireball.net/projects/markdown/syntax>

1
orphaned/dns.es.md
View file

@ -20,7 +20,6 @@ También existen **tipos** de registros DNS, lo que significa que un dominio pue
**Por ejemplo** : `www.yunohost.org` apunta hacia `yunohost.org`
### ¿ Cómo (bien) hacer la configuración ?
Tienes varias opciones. Nota que puedes cumular estas soluciones si posees varios dominios : por ejemplo, puedes tener `mi-servidor.nohost.me` utilizando la solución **1.**, et `mi-servidor.org` utilizando la solución **2.**, redirigiéndolos hacia el mismo servidor YunoHost.

3
orphaned/dns.fr.md
View file

@ -8,7 +8,7 @@ La configuration des DNS est une étape cruciale pour que votre serveur soit acc
**N’hésitez pas à regarder la très bonne conférence de Stéphane Bortzmeyer :**
https://www.iletaitunefoisinternet.fr/post/1-dns-bortzmeyer/
<https://www.iletaitunefoisinternet.fr/post/1-dns-bortzmeyer/>
DNS signifie « Domain Name Server » en anglais, et est souvent employé pour désigner la configuration de vos noms de domaine. Vos noms de domaines doivent en effet pointer vers quelque chose (en général une adresse IP).
@ -23,7 +23,6 @@ Il existe également des **types** d’enregistrement DNS, ce qui veut dire qu
**Par exemple** : `www.yunohost.org` renvoie vers `yunohost.org`
### Comment (bien) faire la configuration ?
Plusieurs choix s’offrent à vous. Notez que vous pouvez cumuler ces solutions si vous possédez plusieurs domaines : par exemple vous pouvez avoir `mon-serveur.nohost.me` en utilisant la solution **1.**, et `mon-serveur.org` en utilisant la solution **2.**, redirigeant vers le même serveur YunoHost.

2
orphaned/dns.md
View file

@ -34,5 +34,3 @@ You can also check out these pages for specific [registrar](/registrar) document
3. (Advanced, not 100% supported...) Your YunoHost instance has its own DNS service, which means it will automatically configure its own DNS records, and that you can leave the setup to the instance itself. To do this, you must explain to your **registrar** that your YunoHost instance is the authoritative DNS server for your domain name.
**Warning**: If you choose this option, all configuration options will be done automatically, you will retain a good deal of flexibility, but if your server gets knocked offline you will run into many problems. **Choose this only if you understand the implications.**

2
orphaned/index.ar.md
View file

@ -107,7 +107,6 @@
<div dir="auto" class="text-center">
<h1>تذكروا ! نحن بشر !<br /><small> إن كان عندكم تساؤل أو واجهتكم مشكلة أو ربما يهمُّكُم المشروع فقط، انضموا إلينا عبر غرفة المحادثة الخاصة بنا لتبليغنا التحية بالنقر على الزر أدناه &nbsp;<span class="glyphicon glyphicon-share-alt"></span> </small></h1>
<p class="liberapay">
<a href="https://liberapay.com/YunoHost" target="_blank"><img src="/images/liberapay_logo.svg" alt="Donation button" title="Liberapay" /></a>
</p>
@ -136,7 +135,6 @@
</div>
</div>
</div><!-- boring-part -->
<script type="text/javascript">

2
orphaned/index.de.md
View file

@ -135,7 +135,6 @@ Self-Hosting für alle ermöglicht.</small></h1>
</div>
</div>
</div><!-- boring-part -->
<script type="text/javascript">
@ -171,4 +170,3 @@ Self-Hosting für alle ermöglicht.</small></h1>
});
</script>

1
orphaned/index.es.md
View file

@ -134,7 +134,6 @@
</div>
</div>
</div><!-- boring-part -->
<script type="text/javascript">

2
orphaned/index.fr.md
View file

@ -118,7 +118,6 @@
</div>
</div>
</div><!-- boring-part -->
<script type="text/javascript">
@ -154,4 +153,3 @@
});
</script>

2
orphaned/index.it.md
View file

@ -135,7 +135,6 @@
</div>
</div>
</div><!-- boring-part -->
<script type="text/javascript">
@ -171,4 +170,3 @@
});
</script>

1
orphaned/index.md
View file

@ -44,7 +44,6 @@
<h2 style="margin-top: 0"><small><a href="https://forum.yunohost.org/c/announcement">Latest news</a></small></h2>
</div>
<div class="row cf">
<div class="col-md-7 text-right">
<h1>Setup <small>your server with ease, you already have everything at home</small></h1>

2
orphaned/index.oc.md
View file

@ -133,7 +133,6 @@
</div>
</div>
</div><!-- boring-part -->
<script type="text/javascript">
@ -169,4 +168,3 @@
});
</script>

2
orphaned/news.md
View file

@ -33,7 +33,7 @@ $(document).ready(function() {
$(data).find("item").each(function(_, item) {
var description = $(item).find("description");
// yes this is a NIGHTMARE
var blockquote_content = $("<div>" + description[0].textContent + "</div>").find("blockquote")[0].innerHTML
var blockquote_content = $("<div>" + description[0].textContent + "</div>").find["blockquote"](0).innerHTML
// blockquote_content = blockquote_content.replace("<h1", "<h4");
html = $('#news-template').html()

1
orphaned/registrar.fr.md
View file

@ -1,6 +1,7 @@
# Bureaux d’enregistrement
Voici une liste des bureaux d’enregistrement pour acheter un nom de domaine :
* [OVH](http://ovh.com/)
* [Gandi](http://gandi.net/)
* [Namecheap](https://www.namecheap.com/)

1
orphaned/registrar.md
View file

@ -1,6 +1,7 @@
# Registar
Here is a list of Registrars to book domain names:
* [OVH](http://ovh.com/)
* [Gandi](http://gandi.net/)
* [Namecheap](https://www.namecheap.com/)

2
pages/00.home/docs.de.md
View file

@ -16,7 +16,6 @@ Weitere Informationen zum Selbsthosting, zur Installation deines eigenen YunoHos
Du kannst in den [Anwendungskatalog](/apps) schauen, um die Apps anzusehen, die auf deinem Server installiert werden können (Natürlich geht das auch direkt über deine Administrationsoberfläche!).
Wenn du Hilfe benötigst, ist die [Community](/community) für dich da: [Chatte](/chat_rooms) mit uns oder schau in das [Forum](/community/forum)!
[center]
@ -28,7 +27,6 @@ Wenn du Hilfe benötigst, ist die [Community](/community) für dich da: [Chatte]
[/center]
[center]
<a href="/" class="btn btn-lg inline"><i class="fa fa-fw fa-arrow-left"></i> Zurück zur Homepage</a>
[/center]

1
pages/00.home/docs.es.md
View file

@ -27,7 +27,6 @@ La [Comunidad](/community) esta disponible para ayudarte : entra en el [chat](/c
[/center]
[center]
<a href="/" class="btn btn-lg inline"><i class="fa fa-fw fa-arrow-left"></i> Volver a la página principal</a>
[/center]

1
pages/00.home/docs.fr.md
View file

@ -31,5 +31,4 @@ La [communauté](/community) est là si vous avez besoin d'aide : venez discuter
<a href="/" class="btn btn-lg inline"><i class="fa fa-fw fa-arrow-left"></i> Retourner à la page d'accueil du site</a>
[/center]
!!!! Pour naviguer dans cette documentation, vous pouvez utiliser les flèches gauches et droites. Utilisez le [fa=bars /] panneau latéral pour aller directement dans les sections qui vous intéresse ou en utilisant la [fa=search /] barre de recherche. Enjoy!

1
pages/00.home/docs.it.md
View file

@ -30,4 +30,3 @@ La [comunità](/community) è disponibile se avete bisogno di aiuto: potete veni
[/center]
!!!! Per navigare in questa documentazione potete utilizzare i tasti freccia destra e sinistra. Navigate direttamente nella sezione che vi interessa con il [fa=bars /] pannello laterale o utilizzate il [fa=search /] box di ricerca. Enjoy!

1
pages/00.home/docs.md
View file

@ -27,7 +27,6 @@ The [Community](/community) is here for you if you need some help : come [chat](
[/center]
[center]
<a href="/" class="btn btn-lg inline"><i class="fa fa-fw fa-arrow-left"></i> Go back to the homepage</a>
[/center]

1
pages/00.home/docs.ru.md
View file

@ -27,7 +27,6 @@ visible: false
[/center]
[center]
<a href="/" class="btn btn-lg inline"><i class="fa fa-fw fa-arrow-left"></i> Вернуться на главную</a>
[/center]

2
pages/01.overview/05.self_hosting/self_hosting.de.md
View file

@ -18,7 +18,7 @@ Beim Self-Hosting geht es nicht darum, "Ihr Internet" sicherer zu machen, und es
- **Sie glauben an ein freies, offenes und dezentrales Internet.** In einem zentralisierten Internet können private Unternehmen und Behörden Personen ausspähen, analysieren und beeinflussen, indem sie diktieren, wie Sie sich miteinander verbinden, und indem sie Inhalte filtern. YunoHost wird von einer Community entwickelt, die an ein offenes und dezentrales Internet glaubt, und wir hoffen, dass Sie dies auch tun!
- **Sie möchten die Kontrolle über Ihre Daten und Dienste haben.** Ihre Bilder, Chatnachrichten, der Browserverlauf und der Text, den Sie für die Schule schreiben, haben auf dem Server eines anderen Benutzers (a.k.a. The Cloud) nichts zu suchen. Sie sind Teil Ihres Privatlebens, aber auch Teil des Lebens Ihrer Familie, Ihres Partners und so weiter. Diese Daten sollten von * Ihnen * verwaltet werden, nicht von einem zufälligen Unternehmen in den USA, dass Ihre Daten analysieren und die Ergebnisse verkaufen möchte.
- **Sie möchten die Kontrolle über Ihre Daten und Dienste haben.** Ihre Bilder, Chatnachrichten, der Browserverlauf und der Text, den Sie für die Schule schreiben, haben auf dem Server eines anderen Benutzers (a.k.a. The Cloud) nichts zu suchen. Sie sind Teil Ihres Privatlebens, aber auch Teil des Lebens Ihrer Familie, Ihres Partners und so weiter. Diese Daten sollten von *Ihnen* verwaltet werden, nicht von einem zufälligen Unternehmen in den USA, dass Ihre Daten analysieren und die Ergebnisse verkaufen möchte.
- **Sie möchten lernen, wie Computer und das Internet funktionieren.** Der Betrieb eines eigenen Servers ist ein guter Kontext, um die grundlegenden Mechanismen von Betriebssystemen und dem Internet zu verstehen. Möglicherweise müssen Sie sich mit der Befehlszeilenschnittstelle, der Netzwerkarchitektur, der DNS-Konfiguration und mit SSH usw. befassen.

33
pages/01.overview/05.self_hosting/self_hosting.es.md
View file

@ -6,59 +6,28 @@ taxonomy:
routes:
default: '/selfhosting'
---
<!--
L'auto-hébergement est le fait d'avoir et d'administrer son propre serveur, typiquement chez soi, pour héberger soi-même ses données personnelles et des services plutôt que de se reposer exclusivement sur des tiers. Par exemple, il est possible d'auto-héberger son blog de sorte qu'il "vive" dans une machine que vous contrôlez, au lieu qu'il soit sur l'ordinateur de quelqu'un d'autre (a.k.a. le Cloud) en échange d'argent, de publicités ou de données privées.
-->
El auto-alojamiento se refiere al hecho de tener y administrar tú tu propio servidor, normalmente en tu casa, para hospedar tus datos personales y servicios, en lugar de depender de terceros. Por ejemplo, es posible el auto-hospedaje de tu blog, de manera que este "viva" dentro de una máquina que controlas, en lugar de que se aloje en un ordenador de otra persona/empresa (alias La Nube) contra dinero, publicidad o cesión de datos privados.
<!--
L'auto-hébergement implique de disposer d'un serveur. Un serveur est un ordinateur qui est destiné à être accessible sur le réseau en permanence, et n'a généralement pas d'écran ni de clavier puisqu'il est administré à distance. Contrairement à une croyance répandue, les serveurs ne sont pas nécessairement des machines énormes et extrêmement puissantes : aujourd'hui, une petite carte ARM à ~30€ est adéquate pour de l'auto-hébergement.
-->
Auto-alojar implica disponer de un servidor. Un servidor es un ordenador destinado a ser accesible en la red las 24 horas del día y que normalmente no tiene ni pantalla ni teclado, ya que se controla a distancia. Contrariamente a una creencia extendida, los servidores no son necesariamente máquinas enormes y muy potentes: en la actualidad, una pequeña placa ARM de unos ~30€/$ es suficiente para el auto-hospedaje.
<!--
Pratiquer l'auto-hébergement ne rend pas "votre internet" plus sécurisé et ne fournit pas d'anonymat en tant que tel. L'objectif est généralement de pouvoir être autonome et au contrôle de ses services et de ses données - ce qui implique aussi d'en être responsable.
-->
La práctica del auto-alojamiento no convierte "tu internet" más segura y tampoco proporciona anonimato por si mismo. El objetivo es generalmente generar autonomía y control de tus servicios y tus datos - lo que también implica una responsabilidad.
## ¿Cuáles son los beneficios del auto-alojamiento?
<!--
- **Vous croyez en un internet libre, ouvert et décentralisé.** Dans un internet centralisé, les entités privées et les gouvernements peuvent espionner, analyser et influencer les personnes en dictant la façon dont elle peuvent interagir les unes avec les autres, ainsi qu'en filtrant du contenu. YunoHost est développé par une communauté qui croit en un internet ouvert et décentralisé. Nous espérons que vous aussi !
-->
- **Crées en una internet libre, abierta y descentralizada.** En una internet centralizada, entidades privadas y gobiernos pueden espiar, analizar e influir en nosotras dictando como iteraccionamos entre nosotras o filtrando contenidos. A YunoHost lo desarrolla por una comunidad que cree en una internet abierta y descentralizada. ¡Esperamos que tú también!
<!--
- **Vous voulez avoir le contrôle de vos données et services.** Vos images, vos messages de chat, votre historique de navigation, et votre dissertation pour l'école n'ont rien à faire sur l'ordinateur de quelqu'un d'autre (a.k.a. le Cloud). Ces données font partie de votre vie privée, mais également de celle de votre famille, de vos amis, etc. Ces données devraient être gérées par *vous*, et non par une quelconque entreprise américaine qui cherche à analyser vos données pour revendre les résultats.
-->
- **Quieres tener control de tus datos y servicios.** Tus fotos, mensajes de chat, el historial de navegación y ese trabajo del colegio no tienen nada que hacer en el ordenador de otra persona (alias La Nube). Esos datos forman parte de tu vida privada, pero también de la de tu familia, de tus amistades, etc. Estos datos deberían ser gestionados por *ti*, y no por una empresa americana cualquiera que busca analizar tus datos para vender los resultados.
<!--
- **Vous souhaitez apprendre comment fonctionnent les ordinateurs et Internet.** Opérer son propre serveur est un bon contexte pour apprendre les mécanismes de base au cœur des systèmes d'exploitation (OS) et d'Internet. Il vous faudra possiblement toucher à la ligne de commande et à des morceaux de configuration réseau et DNS.
-->
- **Quieres aprender cómo funcionan los ordenadores e internet.** Operar tu propio servidor es un ejercicio muy enriquecedor para entender los mecanismos básicos en el corazón de los sistemas operativos y de internet. Es posible que tengas que escribir en la línea de comandos o a segmentos de configuración de la red y de DNS.
<!--
- **Vous voulez explorer de nouvelles possibilités et personnaliser votre espace.** Avez-vous déjà rêvé d'avoir votre propre serveur Minecraft pour vos ami·e·s, ou un client IRC ou XMPP persistant ? Avec votre propre serveur, vous pouvez manuellement installer et faire tourner n'importe quel programme et personnaliser chaque morceau.
-->
- **Quieres explorar las nuevas posibilidades y personalizar tu espacio.** ¿Alguna vez has soñado con tener tu propio servidor de Minecraft para jugar con tus amistades, o un cliente sw IRC o XMPP persistente? Con tu propio servidor, puedes instalar manualmente y ejecutar prácticamente cualquier programa que quieras y personalizar cada parte.
## ¿Qué implica el auto-alojamiento?
<!--
- **L'auto-hébergement requiert du travail et de la patience.** S'auto-héberger est un peu comme avoir son propre jardin ou potager : cela demande du travail et de la patience. Bien que YunoHost cherche à faire tout le travail compliqué pour vous, il vous faudra tout de même prendre le temps d'apprendre et configurer quelques détails pour que votre installation marche correctement. Il vous faudra aussi gérer quelques tâches de maintenance (telles que les mises à jour) de temps en temps, et demander de l'aide si des choses ne fonctionnent pas comme prévu.
-->
- **Auto-alojarse requiere del trabajo y de la paciencia.** Auto-alojarte es algo parecido a cultivar tu propio jardín o huerto: requiere del trabajo y de la paciencia. Mientras que YunoHost pretende hacer todo el trabajo duro por ti, necesitarás tomarte el tiempo para aprender y configurar pequeños detalles para que tu instalación funcione correctamente. También necesitarás realizar algunas tareas de mantenimiento (como actualizaciones) de vez en cuando, o pedir soporte si las cosas no funcionan.
<!--
- **Avec de grands serveurs viennent les grandes responsabilités.** Opérer un serveur implique d'être responsable des données que vous hébergez : personne ne pourra récupérer des données à votre place si vous les perdez. YunoHost fournit des fonctionnalités de sauvegarde qu'il est recommandé d'utiliser pour sauvegarder les configurations et données importantes. Il vous faut aussi garder un œil sur les recommandations et les nouvelles à propos de la sécurité pour que votre serveur ou vos données ne soient pas compromises.
-->
- **Un gran servidor conlleva una gran responsabilidad.** Operar un servidor significa que eres responsable de los datos que alojas. Nadie podrá recuperarlos por ti si se pierden. YunoHost proporciona funciones de copia de seguridad, que es recomendable utilizar regularmente para hacer copias de seguridad de las configuraciones y de los datos importantes. También deberías echar un ojo a las noticias y recomendaciones de seguridad, para que tu servidor o tus datos no se vean comprometidos.
<!--
- **La qualité et les performances ne seront probablement pas aussi bonnes que des services premium.** YunoHost (et la plupart des applications qui sont packagées) sont des logiciels libres et open-source, développés par des communautés bénévoles. Il n'y a pas de garantie absolue que ces logiciels fonctionneront dans toutes les circonstances possibles. Les performances de votre serveur auto-hébergé sont aussi liées au processeur, à la mémoire vive et à la connectivité internet.
-->
- **La calidad y el rendimiento probablemente no serán tan buenos como los de los servicios "premium".** YunoHost (y la mayoría de las aplicaciones empaquetadas) son programas libres basados de código abierto, desarrollados por comunidades de personas de manera voluntaria. No hay garantía absoluta de que el software funcione en todas las circunstancias posibles. El rendimiento de su servidor autohospedado también está relacionado con su procesador, a la memoria RAM y la conectividad a internet.

2
pages/01.overview/05.self_hosting/self_hosting.it.md
View file

@ -30,5 +30,3 @@ Praticare il self-hosting non rende il "tuo internet" più sicuro e non fornisce
- **Con grandi server derivano grandi responsabilità.** Gestire un server implica l'essere responsabile dei dati che ospiti: nessuno potrà recuperare i dati al tuo posto se li perderai. YunoHost offre funzionalità di salvataggio che è raccomandato utilizzare per memorizzare le configurazioni e i dati importanti. Devi tenere controllate le raccomandazioni e le novità riguardo la sicurezza perché il tuo server o i tuoi dati non vengano compromessi.
- **La qualità e le performances probabilmente non saranno le stesse dei servizi premium.** YunoHost (e la maggior parte delle applicazioni che sono predisposte) sono programmi liberi e open-source, sviluppati da comunità di volontari. Non c'è la garanzia assoluta che i programmi funzionino in tutte le possibili situazioni. Le performance del tuo server self-hosting sono legate anche al processore, alla memoria RAM e alla connessione internet.

4
pages/01.overview/05.self_hosting/self_hosting.ru.md
View file

@ -17,13 +17,13 @@ routes:
- **Вы верите в свободный, открытый и децентрализованный Интернет.** В централизованном Интернете частные компании и правительство могут шпионить, анализировать людей и влиять на них, диктуя, как они взаимодействуют друг с другом, и фильтруя контент. YunoHost разработан сообществом, которое верит в открытый и децентрализованный Интернет, и мы надеемся, что вы тоже верите!
- **Вы хотите иметь контроль над своими данными и сервисами.** Вашим фотографиям, сообщениям в чате, истории посещенных страниц и тексту, который вы пишете для школы, нечего делать на чужом сервере (он же Облако). Они являются частью вашей личной жизни, но также и частью жизни вашей семьи, жизни вашего друга и так далее. Этими данными должны управлять * вы*, а не случайная компания в США, которая хочет, чтобы ваши данные анализировались и продавались результаты.
- **Вы хотите иметь контроль над своими данными и сервисами.** Вашим фотографиям, сообщениям в чате, истории посещенных страниц и тексту, который вы пишете для школы, нечего делать на чужом сервере (он же Облако). Они являются частью вашей личной жизни, но также и частью жизни вашей семьи, жизни вашего друга и так далее. Этими данными должны управлять *вы*, а не случайная компания в США, которая хочет, чтобы ваши данные анализировались и продавались результаты.
- **Вы хотите узнать о том, как работают компьютеры и Интернет.** Управление собственным сервером - довольно хороший контекст для понимания основных механизмов, лежащих в основе операционных систем и Интернета. Возможно, вам придется иметь дело с интерфейсом командной строки, сетевой архитектурой, конфигурацией DNS, SSH и так далее.
- **Вы хотите исследовать новые возможности и настраивать вещи.** Вы когда-нибудь мечтали запустить сервер Minecraft для своих друзей или постоянный IRC или XMPP-клиент? Имея свой собственный сервер, вы можете вручную установить и запустить практически любую программу, которую пожелаете, и настроить все до мелочей.
## Почему вы * не должны* принимать гостей сами?
## Почему вы *не должны* принимать гостей сами?
- **Самостоятельный хостинг требует некоторой работы и терпения.** Самостоятельный хостинг немного похож на выращивание собственного сада или овощей: это требует работы и терпения. В то время как YunoHost стремится выполнить всю тяжелую работу за вас, самостоятельный хостинг по-прежнему требует, чтобы вы потратили время на изучение и настройку нескольких вещей для правильной настройки вашего сервера. Вам также нужно будет время от времени выполнять задачи технического обслуживания (например, обновления) или обращаться за поддержкой, если что-то выйдет из строя.

6
pages/01.overview/10.what_is_yunohost/what_is_yunohost.ar.md
View file

@ -29,11 +29,10 @@ routes:
### أصل فكرة المشروع
تعود نشأة فكرة مشروع واي يونوهوست YunoHost إلى شهر فيفري مِن عام 2012 بعد محادثة بدأت على هذا الشكل تقريبًا :
<blockquote>« تبًا، لقد سئِمتُ مِن إعادة إعداد خادم البريد الإلكتروني ... Beudbeud، كيف قُمتَ بإعداد خادومك الجميل حول LDAP ؟ »
<small>Kload، فيفري 2012</small></blockquote>
> « تبًا، لقد سئِمتُ مِن إعادة إعداد خادم البريد الإلكتروني ... Beudbeud، كيف قُمتَ بإعداد خادومك الجميل حول LDAP ؟ »
> <small>Kload، فيفري 2012</small>
Il ne manquait en fait qu’une interface d’administration au serveur de Beudbeud pour en faire quelque chose d’exploitable, alors Kload a décidé de la développer. Finalement, après l’automatisation de quelques configurations et le packaging de quelques applications web, la première version de YunoHost était sortie.
@ -79,4 +78,3 @@ Même si YunoHost est multi-domaine et multi-utilisateur, il reste **inappropri
Premièrement parce que le logiciel est trop jeune, donc non-testé et non-optimisé pour être mis en production pour des centaines d’utilisateurs en même temps. Et quand bien même, ce n’est pas le chemin que l’on souhaite faire suivre à YunoHost. La virtualisation se démocratise, et c’est une façon bien plus étanche et sécurisée de faire de la mutualisation.
Vous pouvez héberger vos amis, votre famille ou votre entreprise sans problème, mais vous devez **avoir confiance** en vos utilisateurs, et ils doivent de la même façon avoir confiance en vous. Si vous souhaitez tout de même fournir des services YunoHost à des inconnus, **un VPS entier par utilisateur** sera la meilleure solution.

3
pages/01.overview/10.what_is_yunohost/what_is_yunohost.de.md
View file

@ -29,7 +29,8 @@ YunoHost ist ein **Betriebssystem**, das auf die einfachste Verwaltung eines **S
YunoHost wurde im Februar 2012 aus folgender Situation heraus erstellt:
<blockquote><p>"Scheiße, ich bin zu faul, um meinen Mailserver neu zu konfigurieren ... Beudbeud, wie hast Du deinen kleinen Server mit LDAP zum Laufen gebracht?"</p><small> Kload, Februar 2012</small></blockquote>
> "Scheiße, ich bin zu faul, um meinen Mailserver neu zu konfigurieren ... Beudbeud, wie hast Du deinen kleinen Server mit LDAP zum Laufen gebracht?"
> <small> Kload, Februar 2012</small>
Alles, was benötigt wurde, war eine Administrationsoberfläche für Beudbeud's Server, um etwas nutzbar zu machen, also entschied sich Kload, eine zu entwickeln. Schließlich wurde YunoHost v1, nach der Automatisierung mehrerer Konfigurationen und der Paketierung in einigen Webanwendungen, fertiggestellt.

6
pages/01.overview/10.what_is_yunohost/what_is_yunohost.es.md
View file

@ -29,14 +29,14 @@ YunoHost es un **sistema operativo** que persigue simplificar la administración
YunoHost se creó en Febrero de 2012 tras algo así:
<blockquote><p>"¡Mierda, soy muy vago para reconfigurar mi servidor de correo!… Beudbeud, ¿Cómo hiciste para conectar tu pequeño servidor a LDAP?"</p>
<small>Kload, Febrero de 2012</small></blockquote>
> "¡Mierda, soy muy vago para reconfigurar mi servidor de correo!… Beudbeud, ¿Cómo hiciste para conectar tu pequeño servidor a LDAP?"
> <small>Kload, Febrero de 2012</small>
Lo único que necesitaba era un interfaz de administración para el servidor de Beudbeud para tener algo usable, así que Kload decidió desarrollar uno. Finalmente, tras automatizar varias configuraciones y empaquetar algunas aplicaciones web, YunoHost v1 quedó terminado.
Notando un entusiasmo creciente alrededor de YunoHost y del autoalojamiento en general, los desarrolladores originales junto con nuevas personas contribuyentes decidieron comenzar a trabajar en la versión 2, una versión más extensible, más potente, más fácil de usar, y ya de paso, una que prepare ricas tazas de café de comercio justo para los elfos de Laponia.
El nombre **YunoHost** viene de la jerga "Y U NO Host". El [meme de Internet ](https://en.wikipedia.org/wiki/Internet_meme) debería ilustrarlo:
El nombre **YunoHost** viene de la jerga "Y U NO Host". El [meme de Internet](https://en.wikipedia.org/wiki/Internet_meme) debería ilustrarlo:
![](image://dude_yunohost.jpg)
## ¿Qué no es YunoHost?

4
pages/01.overview/10.what_is_yunohost/what_is_yunohost.fr.md
View file

@ -29,8 +29,8 @@ YunoHost est un **système d’exploitation** qui vise à simplifier autant que
YunoHost est un projet né en février 2012 à la suite d’à peu près ça :
<blockquote><p>« Merde, j’ai la flemme de me reconfigurer un serveur mail... Beudbeud, comment t’as fait pour configurer ton joli serveur sous LDAP ? »</p>
<small>Kload, février 2012</small></blockquote>
> « Merde, j’ai la flemme de me reconfigurer un serveur mail... Beudbeud, comment t’as fait pour configurer ton joli serveur sous LDAP ? »
> <small>Kload, février 2012</small>
Il ne manquait en fait qu’une interface d’administration au serveur de Beudbeud pour en faire quelque chose d’exploitable, alors Kload a décidé de la développer. Finalement, après l’automatisation de quelques configurations et le packaging de quelques applications web, la première version de YunoHost était sortie.

7
pages/01.overview/10.what_is_yunohost/what_is_yunohost.it.md
View file

@ -16,7 +16,7 @@ YunoHost è un **sistema operativo** che mira a rendere il più semplice possibi
- ![](image://icon-debian.png?resize=32&classes=inline) Basato su Debian;
- ![](image://icon-tools.png?resize=32&classes=inline) Amministra il tuo server attraverso **un'interfaccia web amichevole** ;
- ![](image://icon-package.png?resize=32&classes=inline) Installa le **applicazioni in pochi clic**;
- ![](image://icon-users.png?resize=32&classes=inline) Gestisci **gli utenti ** <small>(basato su LDAP)</small>;
- ![](image://icon-users.png?resize=32&classes=inline) Gestisci **gli utenti** <small>(basato su LDAP)</small>;
- ![](image://icon-globe.png?resize=32&classes=inline) Gestisci **i nomi di dominio**;
- ![](image://icon-medic.png?resize=32&classes=inline) Crea e ripristina **i backup**;
- ![](image://icon-door.png?resize=32&classes=inline) Connettiti contemporaneamente a tutte le applicazioni attraverso **il portale utente** <small>(NGINX, SSOwat)</small>;
@ -26,10 +26,11 @@ YunoHost è un **sistema operativo** che mira a rendere il più semplice possibi
- ![](image://icon-shield.png?resize=32&classes=inline)... e i **sistemi di sicurezza** <small>(Fail2ban, yunohost-firewall)</small>;
## Origine
YunoHost è stata creata nel febbraio 2012 dopo qualcosa del genere:
<blockquote><p>"Merda, sono troppo pigro per riconfigurare il mio server di posta... Beudbeud, come sei riuscito a far funzionare il tuo piccolo server con LDAP?"</p>
<small>Kload, Febbraio 2012</small></blockquote>
> "Merda, sono troppo pigro per riconfigurare il mio server di posta... Beudbeud, come sei riuscito a far funzionare il tuo piccolo server con LDAP?"
> <small>Kload, Febbraio 2012</small>
Tutto ciò che serviva era un'interfaccia di amministrazione per il server di Beudbeud per creare qualcosa di utilizzabile, così Kload ha deciso di svilupparne una. Alla fine, dopo aver automatizzato diverse configurazioni e aver inserito alcune applicazioni web, YunoHost versione 1 è stato completato.

4
pages/01.overview/10.what_is_yunohost/what_is_yunohost.md
View file

@ -29,8 +29,8 @@ YunoHost is an **operating system** aiming for the simplest administration of a
YunoHost was created in February 2012 after something like this:
<blockquote><p>"Shit, I'm too lazy to reconfigure my mail server... Beudbeud, how were you able to get your little server running with LDAP?"</p>
<small>Kload, February 2012</small></blockquote>
> "Shit, I'm too lazy to reconfigure my mail server... Beudbeud, how were you able to get your little server running with LDAP?"
> <small>Kload, February 2012</small>
All that was needed was an admin interface for Beudbeud's server to make something usable, so Kload decided to develop one. Finally, after automating several configs and packaging in some web apps, YunoHost v1 was finished.

4
pages/01.overview/10.what_is_yunohost/what_is_yunohost.ru.md
View file

@ -29,8 +29,8 @@ YunoHost это **операционная система** позволяюща
YunoHost был создан в Феврале 2012 после чего-то вроде:
<blockquote><p>"Блин, Я слишком ленив чтобы перенастроить мой почтовый сервер... Beudbeud, как вам удалось запустить свой малеький сервер LDAP?"</p>
<small>Kload, Февраль 2012</small></blockquote>
> "Блин, Я слишком ленив чтобы перенастроить мой почтовый сервер... Beudbeud, как вам удалось запустить свой малеький сервер LDAP?"
> <small>Kload, Февраль 2012</small>
Всё что было нужно - админ панель для сервера Beudbeud-а чтобы сделать что-то юзабельное, поэтому Kload решил её разработать. В итоге, после автоматизации нескольких конфигураций и упаковки некоторых Веб-приложений, YunoHost v1 был завершён.

2
pages/02.administer/05.how_to_host_yourself/how_to_host_yourself.ru.md
View file

@ -12,6 +12,7 @@ routes:
### Дома, например, на плате ARM или старом компьютере
Вы можете запустить YunoHost у себя дома с помощью платы ARM или переоборудованного обычного компьютера, подключенного к вашему домашнему роутеру.
- **Плюсы** : у вас будет физический контроль над машиной, и вам нужно будет только купить оборудование;
- **Минусы** : вам придется [вручную настроить свой роутер](/isp_box_config) и [возможные ограничения вашим провайдером](/isp).
@ -22,6 +23,7 @@ VPN - это зашифрованный туннель между двумя к
- **Плюсы** : у вас будет физический контроль над машиной, а VPN скрывает ваш трафик от вашего интернет-провайдера и позволяет вам обойти его ограничения;
- **Минусы** : вам придется оплатить ежемесячную подписку на VPN.
-
### На удалённом сервере (VPS или выделенный)
Вы можете арендовать виртуальный частный сервер (VPS) или выделенную машину у [ассоциации](https://db.ffdn.org/) или [коммерческие](/providers/server) облачные провайдеры.

2
pages/02.administer/10.install/05.images/docs.fr.md
View file

@ -45,7 +45,6 @@ Cette page requiert que Javascript soit activé pour s'afficher correctement :s.
</div>
</template>
<script>
/*
###############################################################################
@ -81,4 +80,3 @@ $(document).ready(function () {
});
});
</script>

2
pages/02.administer/10.install/05.images/images.de.md
View file

@ -39,7 +39,6 @@ N B : Auch wenn das Image nicht der neuesten Version von YunoHost entspricht, k
</div>
</template>
<script>
/*
###############################################################################
@ -75,4 +74,3 @@ $(document).ready(function () {
});
});
</script>

3
pages/02.administer/10.install/05.images/images.es.md
View file

@ -38,7 +38,6 @@ N.B. : Incluso si la imagen no corresponde con la última versión de YunoHost,
</div>
</template>
<script>
/*
###############################################################################
@ -74,5 +73,3 @@ $(document).ready(function () {
});
});
</script>

2
pages/02.administer/10.install/05.images/images.fr.md
View file

@ -40,7 +40,6 @@ Cette page requiert que Javascript soit activé pour s'afficher correctement :s.
</div>
</template>
<script>
/*
###############################################################################
@ -76,4 +75,3 @@ $(document).ready(function () {
});
});
</script>

2
pages/02.administer/10.install/05.images/images.md
View file

@ -40,7 +40,6 @@ This page requires Javascript enabled to display properly :s.
</div>
</template>
<script>
/*
###############################################################################
@ -76,4 +75,3 @@ $(document).ready(function () {
});
});
</script>

2
pages/02.administer/10.install/05.images/images.ru.md
View file

@ -40,7 +40,6 @@ routes:
</div>
</template>
<script>
/*
###############################################################################
@ -76,4 +75,3 @@ $(document).ready(function () {
});
});
</script>

4
pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.de.md
View file

@ -10,14 +10,17 @@ routes:
Bei einer Installation zu Hause sollte Ihr Server normalerweise über die Domäne`yunohost.local` erreichbar sein. Wenn dies aus irgendeinem Grund nicht funktioniert, müssen Sie möglicherweise die *lokale* IP-Adresse Ihres Servers ermitteln.
## Was ist ein locales IP ?
Die lokale IP-Adresse ist die, die verwendet wird, um auf Ihren Server innerhalb des lokalen Netzwerks (typischerweise Ihr Zuhause) zu verweisen, wo mehrere Geräte an einen Router (Ihre Internetbox) angeschlossen sind. Die lokale IP-Adresse sieht typischerweise so aus `192.168.x.y` (oder manchmal `10.0.x.y` oder `172.16.x.y`)
## Wie findet man es?
Jeder dieser Tricks sollte es Ihnen ermöglichen, die lokale IP-Adresse Ihres Servers zu finden:
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="(Empfohlen) Mit Angry IP Scanner"]
Verwenden Sie dazu die [AngryIP](https://angryip.org/download/) Software. Sie Brauchen nur diese lokalen IP-Bereiche in dieser Reihenfolge durchsuchen, bis Sie die aktive IP-Adresse finden, die Ihrem Server entspricht:
- `192.168.0.0` -> `192.168.0.255`
- `192.168.1.0` -> `192.168.1.255`
- `192.168.2.0` -> `192.168.255.255`
@ -44,6 +47,7 @@ Wenn der Befehl `arp-scan` viele Geräte anzeigt, können Sie dann mit dem Befeh
Bildschirm auf den Server anschliessen, sich einloggen und diesen Befehl eingeben`hostname --all-ip-address`.
Die Standard-Anmeldedaten (vor der Nachinstallation!) zum Einloggen sind:
- login: root
- password: yunohost

5
pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.fr.md
View file

@ -10,14 +10,17 @@ routes:
Dans le cas d'une installation à la maison, votre serveur devrait typiquement être accessible (depuis son réseau local) avec le domaine `yunohost.local`. Si pour une raison quelconque cela ne fonctionne pas, il vous faut peut-être trouver l'IP locale de votre serveur.
## Qu'est ce qu'une IP locale ?
L'IP locale d'une machine est utilisée pour y faire référence à l'intérieur d'un réseau local (typiquement le réseau dans une maison) où plusieurs appareils se connectent à un même routeur (votre box internet). Une adresse IP locale ressemble généralement à `192.168.x.y` (ou parfois `10.0.x.y` ou `172.16.x.y`)
## Comment la trouver ?
L'une de ces astuces devrait permettre de trouver l'IP locale de votre serveur :
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="(Recommandé) Avec AngryIP"]
Vous pouvez utiliser le logiciel [AngryIP](https://angryip.org/download/) pour y parvenir. Vous devez juste scanner ces plages d'IP dans cet ordre jusqu'à trouver l'IP correspondante à votre serveur :
- `192.168.0.0` -> `192.168.0.255`
- `192.168.1.0` -> `192.168.1.255`
- `192.168.2.0` -> `192.168.255.255`
@ -44,6 +47,7 @@ Si la commande `arp-scan` vous affiche beaucoup de machines, vous pouvez vérifi
Branchez un écran sur votre serveur, loggez-vous et tapez `hostname --all-ip-address`.
Les identifiants par défaut (avant la post-installation!) sont :
- login : root
- mot de passe : yunohost
@ -53,6 +57,7 @@ Les identifiants par défaut (avant la post-installation!) sont :
[/ui-tabs]
## Je ne trouve toujours pas mon IP locale
Si vous n'êtes pas capable de trouver votre serveur avec les méthodes précédentes, alors peut-être que votre serveur n'a pas démarré correctement.
- Assurez-vous que le serveur est correctement branché ;

4
pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.md
View file

@ -10,14 +10,17 @@ routes:
On an installation at home, your server should typically be accessible using the `yunohost.local` domain. If for any reason this does not work, you may need to find the *local* IP of your server.
## What is a local IP ?
The local IP is the address used to refer to your server inside the local network (typically your home) where multiple devices are connected to a router (your internet box). The local IP typically looks like `192.168.x.y` (or sometimes `10.0.x.y` or `172.16.x.y`)
## How to find it ?
Any of these tricks should allow you to find the local IP of your server:
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="(Recommended) With AngryIP"]
You can use the [AngryIP](https://angryip.org/download/) software to achieve that. You just need to scan these local ip ranges in this order until you find the active IP corresponding to your server:
- `192.168.0.0` -> `192.168.0.255`
- `192.168.1.0` -> `192.168.1.255`
- `192.168.2.0` -> `192.168.255.255`
@ -44,6 +47,7 @@ If the `arp-scan` command displays a confusing number of devices, you can check
Plug a screen on your server, log in and type `hostname --all-ip-address`.
The default credentials (before post-installation!) to log in are:
- login: root
- password: yunohost

6
pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.ru.md
View file

@ -10,14 +10,17 @@ routes:
При установке дома ваш сервер, как правило, должен быть доступен с использованием домена `yunohost.local`. Если по какой-либо причине это не сработает, возможно, вам потребуется найти *локальный* IP-адрес вашего сервера.
## Что такое локальный IP-адрес ?
Локальный IP-адрес - это адрес, используемый для обращения к вашему серверу внутри локальной сети (обычно вашего дома), где несколько устройств подключены к маршрутизатору. Локальный IP-адрес обычно выглядит как `192.168.x.y` (или иногда `10.0.x.y` или `172.16.x.y`).
## Как его найти ?
Любой из этих приемов должен позволить вам найти локальный IP-адрес вашего сервера:
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="(Рекомендуемый) используя AngryIP"]
Вы можете использовать [AngryIP](https://angryip.org/download/) для достижения этой цели. Вам просто нужно сканировать эти локальные диапазоны ip-адресов в таком порядке, пока вы не найдете активный IP-адрес, соответствующий вашему серверу:
- `192.168.0.0` -> `192.168.0.255`
- `192.168.1.0` -> `192.168.1.255`
- `192.168.2.0` -> `192.168.255.255`
@ -27,7 +30,7 @@ routes:
!!! **Советы**:
!!! - вы можете сделать отсортировать по ping, как показано на этом скриншоте, чтобы легко увидеть используемый IP.
!!! - обычно ваш сервер должен отображаться как прослушивающий на портах 80 и 443
!!! - в случае сомнений просто введите `https://192.168.x.y " в вашем браузере, чтобы проверить, является ли это YunoHost или нет.
!!! - в случае сомнений просто введите `<https://192.168.x.y> " в вашем браузере, чтобы проверить, является ли это YunoHost или нет.
![](image://angryip.png?class=inline)
@ -44,6 +47,7 @@ routes:
Подключите экран к своему серверу, войдите в систему и введите `hostname --all-ip-address`.
Учетные данные по умолчанию (перед постустановкой!) для входа в систему:
- логин: root
- пароль: yunohost

12
pages/02.administer/10.install/15.isp_box_config/isp_box_config.de.md
View file

@ -11,7 +11,7 @@ routes:
Wenn Sie zu Hause selbst hosten und kein VPN nutzen, müssen Sie die Ports Ihres Routers umleiten ("Internet box"). Das folgende Schema versucht, die Rolle der Portweiterleitung beim Einrichten eines Servers zu Hause kurz zu erklären.
[figure caption="Abbildung der Wichtigkeit von Port-Weiterleitung"]![](image://portForwarding_en.png)[/figure]
[figure caption="Abbildung der Wichtigkeit von Port-Weiterleitung"]![][image://portForwarding_en.png](/figure)
### 0. Offene Ports diagnostizieren
@ -25,6 +25,7 @@ Ihre Box/Router-Administrationsoberfläche ist in der Regel erreichbar über [ht
### 2. Die lokale IP Ihres Servers finden
Identifizieren Sie die lokale IP Ihres Servers, entweder :
- von Ihrer Box/Router-Schnittstelle, die möglicherweise angeschlossene Geräte auflistet
- über die YunoHost-Schnittstelle, Abschnitt "Internetkonnektivität", dann auf "Details" im IPv4-Bericht klicken.
- von der Befehlszeile Ihres Servers aus, indem Sie `hostname -I` ausführen
@ -39,12 +40,13 @@ Suchen Sie in der Verwaltungsoberfläche Ihres Routers nach etwas wie "Router-Ko
Das Öffnen der unten aufgeführten Ports ist notwendig, damit die verschiedenen in YunoHost verfügbaren Dienste funktionieren. Für jeden von ihnen wird die 'TCP'-Weiterleitung benötigt. Einige Schnittstellen beziehen sich auf 'externe' und 'interne' Ports : diese sind in unserem Fall gleich.
* Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
* [SSH](/ssh): 22
* [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(servers)</small>
* [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
- Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
- [SSH](/ssh): 22
- [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(servers)</small>
- [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
Wenn Sie sowohl ein Modem als auch einen Router verwenden, dann müssen Sie Folgendes tun:
1. zuerst auf dem Modem (der Box, die dem Internet am nächsten ist) Regeln erstellen, um die oben genannten Ports an Ihren Router weiterzuleiten;
2. dann auf dem Router (der Box zwischen dem Modem und Ihren Geräten) Regeln erstellen, um die oben genannten Ports an die statische IP-Adresse für Ihren Server weiterzuleiten.

15
pages/02.administer/10.install/15.isp_box_config/isp_box_config.es.md
View file

@ -13,7 +13,7 @@ Si te estás auto-alojando en casa y sin VPN, tienes que redirigirse los puertos
El esquema aquí abajo intenta explicar brevemente el rol de la redirección de los puertos durante la instalación de un servidor en tu casa.
[figure caption="Ilustración de la importancia del redirección de puertos"]![](image://portForwarding_en.png)[/figure]
[figure caption="Ilustración de la importancia del redirección de puertos"]![][image://portForwarding_en.png](/figure)
[Esta página](https://www.testdevelocidad.es/configuraciones/abrir-correctamente-los-puertos-router/) también propone explicaciones detalladas sobre el funcionamiento de los puertos, y las etapas de configuración para un router genérico.
@ -25,12 +25,13 @@ Una vez que tienes la redirección configurada, deberías poder comprobar que lo
### 1. Acceder a la interfaz de administración de tu router/caja/box
En general la interfaz de administración está accesible desde http://192.168.0.1 o http://192.168.1.1.
En general la interfaz de administración está accesible desde <http://192.168.0.1> o <http://192.168.1.1>.
Luego, es posible que tengas que autenticarte con los ID provechos pour tu proveedor de acceso a Internet.
### 2. Descubrir la IP local del servidor
Identifica cuál es la IP local de tu servidor, o sea :
- desde la interfaz de tu router/caja/box, donde tal vez estén listados los dipositivos conectados a la red local
- desde la webadmin de YunoHost, en 'Estado del servidor', 'Red'
- desde la línea de comandos en tu servidor, por ejemplo con `ip a | grep "scope global" | awk '{print $2}'`
@ -43,10 +44,10 @@ En la interfaz de administración de tu router/caja/box, tienes que encontrar un
Luego tienes que redirigir cada uno de los puertos listados a continuación hacia la IP local de tu router para que los varios servicios de YunoHost funcionen. Para cada uno de ellos, una redirección 'TCP' es necesaria. En algunas interfaces, tal vez encontrarás referencias a un puerto 'externo' y un puerto 'interno' : en nuestro caso, se trata del mismo número de puerto, que sea interno o externo.
* Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
* [SSH](/ssh): 22
* [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(servers)</small>
* [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
- Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
- [SSH](/ssh): 22
- [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(servers)</small>
- [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
! [fa=exclamation-triangle /] Algunos proveedores de acceso a Internet bloquean el puerto 25 (mail SMTP) por defecto para luchar con el spam. Otros (más escasos) no permiten utilizar libremente los puertos 80/443. Dependiendo de tu proveedor, puede ser posible de abrir estos puertos en la interfaz... Ver [esta página](/isp) por más informaciones.
@ -54,8 +55,6 @@ Luego tienes que redirigir cada uno de los puertos listados a continuación haci
Una tecnología llamada UPnP está disponible en algunos routers/cajas/box y permite redirigir automáticamente puertos hacia una máquina que lo pide. Si UPnP está activado en tu casa, ejecutar este comando debería automáticamente redirigir los puertos correctos :
```bash
sudo yunohost firewall reload
```

13
pages/02.administer/10.install/15.isp_box_config/isp_box_config.fr.md
View file

@ -11,7 +11,7 @@ routes:
Si vous vous auto-hébergez à la maison et sans VPN, il vous faut rediriger les ports de votre routeur ("machin-box"). Le schéma ci-dessous tente d'expliquer brièvement le rôle de la redirection des ports lors de la mise en place d'un serveur à la maison.
[figure caption="Illustration de l'importance de la redirection des ports"]![](image://portForwarding_fr.png)[/figure]
[figure caption="Illustration de l'importance de la redirection des ports"]![][image://portForwarding_fr.png](/figure)
[Cette page](https://craym.eu/tutoriels/utilitaires/ouvrir_les_ports_de_sa_box.html) propose également des explications détaillées sur le fonctionnement des ports, et les étapes de configuration pour différents routeurs.
@ -22,13 +22,14 @@ YunoHost 3.8 vous permettra de vérifier si les ports sont correctement exposés
### 2. Accéder à l'interface d'administration de votre box/routeur
L'interface d'administration est généralement accessible via http://192.168.0.1 ou http://192.168.1.1.
L'interface d'administration est généralement accessible via <http://192.168.0.1> ou <http://192.168.1.1>.
Ensuite, il vous faudra peut-être vous authentifier avec les identifiants
fournis par votre fournisseur d'accès à Internet (FAI).
### 3. Trouver l'IP locale de votre serveur
Identifiez quelle est l'IP locale de votre serveur, soit :
- depuis l'interface de votre routeur/box, qui liste peut-être les dispositifs
connectés;
- depuis la webadmin de YunoHost, dans 'Diagnostic', section 'Connectivité Internet', cliquer sur 'Détails' à côté de la ligne sur IPv4.
@ -44,10 +45,10 @@ nom diffère suivant le type / marque de la box...
Il vous faut ensuite rediriger chacun des ports listés ci-dessous vers l'IP locale de votre serveur pour que les différents services de YunoHost fonctionnent. Pour chacun d'eux, une redirection 'TCP' est nécessaire. Certaines interfaces font référence à un port « externe » et un port « interne » : dans notre cas il s'agit du même.
* Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
* [SSH](/ssh): 22
* [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(serveurs)</small>
* [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
- Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
- [SSH](/ssh): 22
- [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(serveurs)</small>
- [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
! [fa=exclamation-triangle /] Certains fournisseurs d'accès à Internet bloquent le port 25 (mail SMTP) par défaut pour combattre le spam. D'autres (plus rares) ne permettent pas d'utiliser librement les ports 80/443. En fonction de votre FAI, il peut être possible d'ouvrir ces ports dans l'interface... Voir [cette page](/isp) pour plus d'informations.

13
pages/02.administer/10.install/15.isp_box_config/isp_box_config.md
View file

@ -11,7 +11,7 @@ routes:
If you are self-hosting at home and without a VPN, you need to forward ports on your home router ("Internet box"). The sketch below tries to briefly summarize the role and necessity of port forwarding when setting up a server at home.
[figure caption="Illustration of the importance of port-forwarding"]![](image://portForwarding_en.png)[/figure]
[figure caption="Illustration of the importance of port-forwarding"]![][image://portForwarding_en.png](/figure)
### 0. Diagnose ports opened
@ -25,6 +25,7 @@ Your box/router admin interface is usually reachable via [http://192.168.0.1](ht
### 2. Find the local IP of your server
Identify what is thei *local* IP of your server, either :
- from your box/router interface, which might list devices connected
- from the YunoHost webadmin, in 'Diagnosis', section 'Internet connectivity', click on 'Details' on the IPv4 report.
- from the command line in your server, by running `hostname -I`
@ -39,12 +40,13 @@ In your router admin interface, look for something like 'router configuration' o
Opening the ports listed below is necessary for the various services available in YunoHost to work. For each of them, the 'TCP' forwarding is needed. Some interfaces refer to 'external' and 'internal' ports : these are the same in our case.
* Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
* [SSH](/ssh): 22
* [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(servers)</small>
* [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
- Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
- [SSH](/ssh): 22
- [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(servers)</small>
- [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
If you use both a modem and a router, then you need to do the following:
1. first on the modem (the box closest to the internet) create rules to forward the above ports to your router;
2. then on the router (the box between the modem and your devices) create rules to forward the above ports to the static IP address for your server.
@ -57,4 +59,3 @@ A technology called UPnP is available on some internet boxes / routers and allow
```bash
sudo yunohost firewall reload
```

13
pages/02.administer/10.install/15.isp_box_config/isp_box_config.ru.md
View file

@ -11,7 +11,7 @@ routes:
Если вы самостоятельно размещаетесь дома и у вас нет VPN, вам необходимо перенаправить порты на вашем домашнем маршрутизаторе. В приведенном ниже наброске предпринята попытка кратко описать роль и необходимость переадресации портов при настройке сервера дома.
[figure caption="Иллюстрация важности переадресации портов"]![](image://portForwarding_en.png)[/figure]
[figure caption="Иллюстрация важности переадресации портов"]![][image://portForwarding_en.png](/figure)
### 0. Диагностировать открытые порты
@ -24,6 +24,7 @@ routes:
### 2. Найдите локальный IP-адрес вашего сервера
Определите, каков *локальный* IP вашего сервера, либо :
- из вашего интерфейса box / router, в котором может быть список подключенных устройств
- в веб-администраторе YunoHost, в разделе "Диагностика", "Подключение к Интернету", нажмите "Подробности" в отчете IPv4.
- из командной строки на вашем сервере, запустив `hostname -I`
@ -38,12 +39,13 @@ routes:
Открытие перечисленных ниже портов необходимо для работы различных сервисов, доступных в YunoHost. Для каждого из них необходима переадресация "TCP". Некоторые интерфейсы относятся к "внешним" и "внутренним" портам: в нашем случае это одно и то же.
* Веб: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
* [SSH](/ssh): 22
* [XMPP](/XMPP): 5222 <small>(клиенты)</small>, 5269 <small>(серверы)</small>
* [Почтовые](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
- Веб: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
- [SSH](/ssh): 22
- [XMPP](/XMPP): 5222 <small>(клиенты)</small>, 5269 <small>(серверы)</small>
- [Почтовые](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
Если вы используете и модем, и маршрутизатор, то вам необходимо выполнить следующее:
1. сначала на модеме (поле, расположенном ближе всего к Интернету) создайте правила для перенаправления вышеуказанных портов на ваш маршрутизатор;
2. затем на маршрутизаторе (поле между модемом и вашими устройствами) создайте правила для пересылки вышеуказанных портов на статический IP-адрес вашего сервера.
@ -56,4 +58,3 @@ routes:
```bash
sudo yunohost firewall reload
```

6
pages/02.administer/10.install/20.dns_config/dns_config.de.md
View file

@ -17,9 +17,11 @@ sollte die Konfiguration automatisch erfolgen. Wenn Sie Ihren eigenen Domainname
Domain über die Schnittstelle Ihres Registrars konfigurieren.
## Empfohlene DNS-Konfiguration
_N.B. : Die Beispiele hier verwenden den Text: `your.domain.tld`, der durch Ihre eigene Domain (z. B.`www.yunohost.org`) zu ersetzen ist._
YunoHost bietet eine empfohlene DNS-Konfiguration, die auf zwei Arten zugänglich ist :
- mit dem Webadmin, unter Domänen > your.domain.tld > DNS-Konfiguration ;
- oder auf der Kommandozeile `yunohost domain dns-conf your.domain.tld`
@ -87,7 +89,7 @@ dargestellt wird:
- Die hier gezeigten Werte sind nur Beispiele! Beziehen Sie sich auf die generierte Konfiguration, um herauszufinden, welche Werte zu verwenden sind;
- Wir empfehlen eine [TTL](https://de.wikipedia.org/wiki/Time_to_Live#Domain_Name_System) von 3600 (1 Stunde). Es ist aber auch möglich einen anderen Wert zu verwenden, wenn Sie wissen, was Sie tun ;
- Legen Sie keinen IPv6-Eintrag an, wenn Sie nicht sicher sind, daß IPv6 auf Ihrem Server funktioniert! Sie werden Probleme mit Let's Encrypt haben, wenn dies nicht der Fall ist.
- If you're using the domain provider Namecheap the SRV DNS entries are formatted as **Service**: _xmpp-client **Protocol**: _tcp **Priority**: 0 **Weight**: 5 **Port**: 5222 **Target**: your.domain.tld
- If you're using the domain provider Namecheap the SRV DNS entries are formatted as **Service**: _xmpp-client **Protocol**:_tcp **Priority**: 0 **Weight**: 5 **Port**: 5222 **Target**: your.domain.tld
### Reverse DNS
@ -95,7 +97,7 @@ Wenn Ihr ISP oder Host dies zulässt, empfehlen wir Ihnen, eine
[Reverse-DNS-Konfiguration](https://de.wikipedia.org/wiki/Reverse_DNS)
für Ihre öffentlichen IPv4- und/oder IPv6-Adressen. Dadurch wird verhindert, dass Sie als Spammer von den Anti-Spam-Filtersystemen markiert werden.
**N.B. : Die Reverse-DNS-Konfiguration erfolgt bei Ihrem Internet Service Provider bzw. VPS-Host. Es betrifft *nicht* den Registrar Ihres Domainnamens.**
**N.B. : Die Reverse-DNS-Konfiguration erfolgt bei Ihrem Internet Service Provider bzw. VPS-Host. Es betrifft _nicht_ den Registrar Ihres Domainnamens.**
Das heißt, wenn Ihre öffentliche IPv4-Adresse `111.222.333.444`ist und Ihr
Domänename `domain.tld`ist, sollten Sie mit dem Befehl

8
pages/02.administer/10.install/20.dns_config/dns_config.es.md
View file

@ -13,11 +13,12 @@ DNS (sistema de nombre de dominios) es un elemento esencial de Internet que perm
Si utilizas un [dominio automático](/dns_nohost_me) provecho por el Proyecto YunoHost, la configuración debería ser automática. Si quieres utilizar tu propio nombre de dominio (comprado a un registrar), hay que configurar manualmente tu proprio nombre de dominio vía la interfaz de tu registrar.
## Configuración DNS recomendada
_Nota: los ejemplos utilizan el marcador `tu.dominio.tld`, debe ser reemplazado por su propio dominio, como `www.yunohost.org`._
YunoHost provee una configuración DNS recomendada, accesible vía :
- la webadmin, en Dominios > tu.dominio.tld > Configuración DNS ;
- o la linea de comando, `yunohost domain dns-conf tu.dominio.tld`
@ -57,7 +58,6 @@ _dmarc 3600 IN TXT "v=DMARC1; p=none"
Pero puede ser un poco más fácil entenderla viéndola de esta manera :
| Tipo | Nombre | Valor |
| :-----: | :--------------------: | :----------------------------------------------------: |
| **A** | **@** | `111.222.333.444` (tu IPv4) |
@ -75,7 +75,7 @@ Pero puede ser un poco más fácil entenderla viéndola de esta manera :
| TXT | mail._domainkey | `"v=DKIM1; k=rsa; p=uneGrannnndeClef"` |
| TXT | _dmarc | `"v=DMARC1; p=none"` |
#### Algunas notas a propósito de esta tabla :
#### Algunas notas a propósito de esta tabla
- Todos los registros no son necesarios. Para una instalación mínima, solos los registros en negrita son necesarios.
- El punto al final de `tu.dominio.tld.` es importante ;) ;
@ -83,7 +83,7 @@ Pero puede ser un poco más fácil entenderla viéndola de esta manera :
- ¡ Los valores mostrados son ejemplos ! Refiérete a la configuración generada por tu servidor qué valores utilizar.
- Recomendamos un [TTL](https://en.wikipedia.org/wiki/Time_to_live) de 3600 (1 hora). Pero puedes utilizar otro valor si sabes lo que estás haciendo ;
- ¡ No pongas registros IPv6 si no estás seguro que el IPv6 funcione en tu servidor ! Tendrás problemas con Let's Encrypt si no es el caso :-)
- If you're using the domain provider Namecheap the SRV DNS entries are formatted as **Service**: _xmpp-client **Protocol**: _tcp **Priority**: 0 **Weight**: 5 **Port**: 5222 **Target**: your.domain.tld
- If you're using the domain provider Namecheap the SRV DNS entries are formatted as **Service**: _xmpp-client **Protocol**:_tcp **Priority**: 0 **Weight**: 5 **Port**: 5222 **Target**: your.domain.tld
### IP Dinámica

6
pages/02.administer/10.install/20.dns_config/dns_config.fr.md
View file

@ -22,9 +22,11 @@ la configuration devrait être faite automatiquement. Si vous utilisez votre pro
domaine via l'interface de votre registrar.
## Configuration DNS recommandée
_NB : les exemples utilisent ici le texte `votre.domaine.tld`, à remplacer par votre propre domaine (par exemple `www.yunohost.org`)._
YunoHost fournit une configuration DNS recommandée, accessible via :
- la webadmin, dans Domaines > votre.domain.tld > Configuration DNS ;
- ou la ligne de commande, `yunohost domain dns-conf votre.domaine.tld`
@ -92,7 +94,7 @@ suivante :
- Les valeurs montrées ici sont des valeurs d'exemple ! Référez-vous à la configuration générée chez vous pour savoir quelles valeurs utiliser ;
- Nous recommandons un [TTL](https://fr.wikipedia.org/wiki/Time_to_Live#Le_Time_to_Live_dans_le_DNS) de 3600 (1 heure). Mais vous pouvez utiliser une autre valeur si vous savez ce que vous faîtes ;
- Ne mettez pas d'enregistrement IPv6 si vous n'êtes pas certain que l'IPv6 fonctionne sur votre serveur ! Vous aurez des problèmes avec Let's Encrypt si ce n'est pas le cas.
- Si vous utilisez le registrar Namecheap, les entrées SRV sont formattées comme **Service**: _xmpp-client **Protocol**: _tcp **Priority**: 0 **Weight**: 5 **Port**: 5222 **Target**: votre.domaine.tld
- Si vous utilisez le registrar Namecheap, les entrées SRV sont formattées comme **Service**: _xmpp-client **Protocol**:_tcp **Priority**: 0 **Weight**: 5 **Port**: 5222 **Target**: votre.domaine.tld
### Résolution DNS inverse
@ -102,7 +104,7 @@ inverse](https://fr.wikipedia.org/wiki/Domain_Name_System#R%C3%A9solution_invers
pour vos adresses publiques IPv4 et/ou IPv6. Ceci vous évitera d'être marqué
comme spammeur par les systèmes de filtrage anti-spams.
**N.B. : la configuration du DNS inverse se passe au niveau de votre fournisseur d'accès à Internet, ou de votre hébergeur de VPS. Elle ne se fait *pas* sur le registrar de votre nom de domaine.**
**N.B. : la configuration du DNS inverse se passe au niveau de votre fournisseur d'accès à Internet, ou de votre hébergeur de VPS. Elle ne se fait _pas_ sur le registrar de votre nom de domaine.**
Cela signifie que si votre adresse IPv4 publique est `111.222.333.444` et que
votre nom de domaine est `domain.tld`, vous devez obtenir le résultat suivant

4
pages/02.administer/10.install/20.dns_config/dns_config.md
View file

@ -24,6 +24,7 @@ interface.
NB: Examples here use the placeholder `your.domain.tld`, you have to replace it with your real domain, such as `www.yunohost.org`.
YunoHost provides a recommended DNS configuration, available via:
- the webadmin, in Domain > your.domain.tld > DNS configuration;
- or the command line, `yunohost domain dns-conf your.domain.tld`
@ -65,7 +66,6 @@ _dmarc 3600 IN TXT "v=DMARC1; p=none"
Though it might be easier to understand it if displayed like this:
| Type | Name | Value |
| :-----: | :--------------------: | :--------------------------------------------------: |
| **A** | **@** | `111.222.333.444` (your IPv4) |
@ -91,7 +91,7 @@ Though it might be easier to understand it if displayed like this:
- These are example values ! See your generated conf for the actual values you should use;
- We recommend a [TTL](https://en.wikipedia.org/wiki/Time_to_live#DNS_records) of 3600 (1 hour). But you can use something else if you know what you're doing;
- Don't put an IPv6 record if you're not sure IPv6 really works on your server! You might have issues with Let's Encrypt if it doesn't.
- If you're using the domain provider Namecheap the SRV DNS entries are formatted as **Service**: _xmpp-client **Protocol**: _tcp **Priority**: 0 **Weight**: 5 **Port**: 5222 **Target**: your.domain.tld
- If you're using the domain provider Namecheap the SRV DNS entries are formatted as **Service**: _xmpp-client **Protocol**:_tcp **Priority**: 0 **Weight**: 5 **Port**: 5222 **Target**: your.domain.tld
### Reverse DNS

4
pages/02.administer/10.install/20.dns_config/dns_config.ru.md
View file

@ -24,6 +24,7 @@ DNS (система доменных имен) - это система, кото
ПРИМЕЧАНИЕ: В примерах здесь используется заполнитель `your.domain.tld`, вы должны заменить его своим реальным доменом, например `www.yunohost.org`.
YunoHost предоставляет рекомендуемую конфигурацию DNS, доступную через:
- веб-администратор, Домены > `your.domain.tld` > DNS;
- или в командной строке: `yunohost domain dns-conf your.domain.tld`
@ -65,7 +66,6 @@ _dmarc 3600 IN TXT "v=DMARC1; p=none"
Хотя, возможно, было бы легче понять это, если бы оно отображалось следующим образом:
| Тип | Название | Значение |
| :-----: | :--------------------: | :--------------------------------------------------: |
| **A** | **@** | `111.222.333.444` (ваш IPv4) |
@ -91,7 +91,7 @@ _dmarc 3600 IN TXT "v=DMARC1; p=none"
- Это примерные значения! Смотрите сгенерированный вами conf для получения фактических значений, которые вы должны использовать;
- Мы рекомендуем использовать [TTL](https://en.wikipedia.org/wiki/Time_to_live#DNS_records ) 3600 (1 час). Но вы можете использовать что-то еще, если знаете, что делаете;
- Не размещайте запись IPv6, если вы не уверены, что IPv6 действительно работает на вашем сервере! У вас могут возникнуть проблемы с Let's Encrypt, если это не так.
- Если вы используете Namecheap поставщика домена, записи SRV DNS форматируются как **Сервис**: _xmpp-client **Протокол**: _tcp **Приоритет**: 0 **Вес**: 5 **Порт**: 5222 **Цель**: your.domain.tld
- Если вы используете Namecheap поставщика домена, записи SRV DNS форматируются как **Сервис**: _xmpp-client **Протокол**:_tcp **Приоритет**: 0 **Вес**: 5 **Порт**: 5222 **Цель**: your.domain.tld
### Обратный DNS

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

@ -51,5 +51,5 @@ The installer will ask about which **desktop environment** you want. You should
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
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.

106
pages/02.administer/10.install/install.de.md
View file

@ -70,27 +70,27 @@ 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)
[[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)
[[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)
[[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)
[[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)
[[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)
[[figure caption="Remote Server"]![][image://vps.png?height=75](/figure)](/install/hardware:vps_debian)
[/div]
[/div]
@ -98,51 +98,50 @@ Wähle die Hardware, auf der du YunoHost installieren willst :
{% 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)
[[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)
[[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)
[[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)
[[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)
[[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)
[[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)
[[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
@ -190,7 +189,9 @@ Wähle die Hardware, auf der du YunoHost installieren willst :
{% 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.
@ -225,6 +226,7 @@ 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:
@ -252,6 +254,7 @@ 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
@ -263,6 +266,7 @@ 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
@ -292,7 +296,9 @@ 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:
```
@ -307,10 +313,11 @@ 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 :
@ -318,19 +325,19 @@ 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)
[[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)
[[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)
[[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 %}
@ -413,17 +420,16 @@ $(document).ready(function () {
});
</script>
{% 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 %}
@ -457,6 +463,7 @@ Führe dann Folgendes aus :
# 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"]
@ -493,15 +500,8 @@ Gehe zu **Settings** > **Network**:
{% endif %}
{% if arm %}
## [fa=plug /] Das Board einschalten
* Schließe das Ethernet Kabel an (ein Ende an deinem Router, das andere an deinem Board).
@ -513,6 +513,7 @@ Gehe zu **Settings** > **Network**:
* 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.
@ -521,8 +522,8 @@ Starte die virtuelle Maschine nach der Auswahl des YunoHost Image.
! 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).
@ -532,6 +533,7 @@ Starte die virtuelle Maschine nach der Auswahl des YunoHost Image.
{% endif %}
{% if regular or virtualbox %}
## [fa=rocket /] Die grafische Installation starten
Du solltest einen Bildschirm wie diesen sehen:
@ -556,7 +558,8 @@ Das YunoHost-Projekt hat die klassische Installation so weit wie möglich verein
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:
### 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.
@ -582,32 +585,39 @@ Wenn du über eine oder mehrere Festplatten zum Speichern von Daten verfügst, k
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.
* 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}
@ -616,6 +626,7 @@ 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
```
@ -623,6 +634,7 @@ sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/fir
! 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.
@ -635,13 +647,13 @@ ssh root@192.168.x.xxx
{% 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:
* Ö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
@ -729,7 +741,6 @@ Wenn du Subdomains erstellen möchtest, denk daran, diese auch in der Datei `hos
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.
@ -747,7 +758,6 @@ Das Diagnosesystem soll eine einfache Möglichkeit bieten, zu überprüfen, ob a
!!! 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:
@ -758,10 +768,12 @@ Um eine Diagnose auszuführen, gehe im Web Admin auf den Abschnitt "Diagnose". K
[/ui-tab]
[ui-tab title="In der Kommandozeile"]
```
yunohost diagnosis run
yunohost diagnosis show --issues --human-readable
```
[/ui-tab]
[/ui-tabs]
@ -782,13 +794,15 @@ Gehe zu Domains > Klicke auf deine Domain > SSL Zertifikat
[/ui-tab]
[ui-tab title="In der Kommandozeile"]
```
yunohost domain cert install
```
[/ui-tab]
[/ui-tabs]
## ![](image://tada.png?resize=32&classes=inline) Gratulation!
## ![](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)!

101
pages/02.administer/10.install/install.fr.md
View file

@ -68,23 +68,23 @@ Sélectionnez le matériel sur lequel vous souhaitez installer YunoHost :
[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)
[[figure caption="VirtualBox"]![][image://virtualbox.png?height=75](/figure)](/install/hardware:virtualbox)
[/div]
[div class="flex-child hardware{%if rpi34 or rpi012 %} active{% endif %}"]
[[figure caption="Raspberry Pi"]![](image://raspberrypi.png?height=75)[/figure]](/install/hardware:rpi34)
[[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="Carte ARM"]![](image://olinuxino.png?height=75)[/figure]](/install/hardware:arm)
[[figure caption="Carte ARM"]![][image://olinuxino.png?height=75](/figure)](/install/hardware:arm)
[/div]
[div class="flex-child hardware{%if regular %} active{% endif %}"]
[[figure caption="Ordinateur standard"]![](image://computer.png?height=75)[/figure]](/install/hardware:regular)
[[figure caption="Ordinateur standard"]![][image://computer.png?height=75](/figure)](/install/hardware:regular)
[/div]
[div class="flex-child hardware{%if vps_debian or vps_ynh %} active{% endif %}"]
[[figure caption="Serveur distant"]![](image://vps.png?height=75)[/figure]](/install/hardware:vps_debian)
[[figure caption="Serveur distant"]![][image://vps.png?height=75](/figure)](/install/hardware:vps_debian)
[/div]
[/div]
@ -92,46 +92,46 @@ Sélectionnez le matériel sur lequel vous souhaitez installer YunoHost :
{% if rpi34 or rpi012 %}
[div class="flex-child hardware{%if rpi34 %} active{% endif %}"]
[[figure caption="Raspberry Pi 3 ou 4"]![](image://raspberrypi.png?height=50)[/figure]](/install/hardware:rpi34)
[[figure caption="Raspberry Pi 3 ou 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 or 2"]![](image://rpi1.png?height=50)[/figure]](/install/hardware:rpi012)
[[figure caption="Raspberry Pi 0, 1 or 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="La Brique Internet avec un VPN"]![](image://internetcube.png?height=50)[/figure]](/install/hardware:internetcube)
[[figure caption="La Brique Internet avec un 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 ou Orange Pi PC+"]![](image://olinuxino.png?height=50)[/figure]](/install/hardware:arm_sup)
[[figure caption="Olinuxino lime1&2 ou 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="Autres cartes ARM"]![](image://odroidhc4.png?height=50)[/figure]](/install/hardware:arm_unsup)
[[figure caption="Autres cartes ARM"]![][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 ou serveur dédié avec Debian 11"]![](image://debian-logo.png?height=50)[/figure]](/install/hardware:vps_debian)
[[figure caption="VPS ou serveur dédié avec 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 ou serveur dédié avec YunoHost pre-installé"]![](image://logo.png?height=50)[/figure]](/install/hardware:vps_ynh)
[[figure caption="VPS ou serveur dédié avec YunoHost pre-installé"]![][image://logo.png?height=50](/figure)](/install/hardware:vps_ynh)
[/div]
{% endif %}
[/div]
{% if hardware != '' %}
## [fa=list-alt /] Pré-requis
{% if regular %}
* Un matériel compatible x86 dédié à YunoHost : portable, netbook, ordinateur avec 512Mo de RAM et 16Go de capacité de stockage (au moins) ;
{% elseif rpi34 %}
* Un Raspberry Pi 3 ou 4 ;
@ -172,10 +172,8 @@ Sélectionnez le matériel sur lequel vous souhaitez installer YunoHost :
! N.B. : Installer YunoHost dans une VirtualBox est généralement destiné à tester la distribution ou pour développer. VirtualBox n'est pas pratique pour faire tourner un 'vrai' serveur sur le long terme car la machine surlaquelle il est installé ne sera sans doute pas allumé 24h/24, et parce que Virtualbox rajoute une couche de complexité supplémentaire pour ce qui est d'exposer la machine sur Internet.
{% endif %}
{% if vps_ynh %}
## Fournisseurs de VPS YunoHost
Ci-dessous une liste de fournisseurs de VPS supportant nativement YunoHost :
@ -183,19 +181,19 @@ Ci-dessous une liste de fournisseurs de VPS supportant nativement YunoHost :
[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)
[[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)
[[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="ECOWAN - FR"]![](image://vps_ynh_ecowan.png?height=50)[/figure]](https://www.ecowan.fr/vps-linux)
[[figure caption="ECOWAN - FR"]![][image://vps_ynh_ecowan.png?height=50](/figure)](<https://www.ecowan.fr/vps-linux>)
[/div]
[/div]
{% endif %}
{% if at_home %}
## [fa=download /] Télécharger l'image {{image_type}}
{% if rpi012 %}
@ -278,17 +276,16 @@ $(document).ready(function () {
});
</script>
{% if not virtualbox %}
{% if arm %}
## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flasher l'image {{image_type}}
{% else %}
## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flasher l'image YunoHost
{% endif %}
Maintenant que vous avez téléchargé l’image de {{image_type}}, vous devez la mettre sur {% if arm %}une carte microSD{% else %}une clé USB ou un CD/DVD.{% endif %}
@ -339,10 +336,11 @@ Pour les anciens matériels, il vous faut peut-être utiliser un CD/DVD. Le logi
Ventoy sera utile si vous n'arrivez pas à démarrer l'image de Yunohost en utilisant les autres méthodes
[Ventoy](https://www.ventoy.net/) est un outil pratique qui permet de mettre plusieurs images Linux sur une même clé USB et démarrer ces images sans devoir re-flasher la clé USB à chaque fois. C'est aussi pratique pour démarer une image qui refuse de démarrer: Ventoy réussi habituellement à tout démarrer!
1. Installer [Ventoy](https://www.ventoy.net/) sur la clé USB. Référez-vous aux [instructions d'installation](https://www.ventoy.net/en/doc_start.html).
- Cela va créer 2 partition sur la clé USB.
* Cela va créer 2 partition sur la clé USB.
3. En utilisant votre application de fichiers préférée, copiez l'image Yunohost sur la grande partition "Ventoy (pas celle "VTOYEFI")
- N'utilisez pas *Balena Etcher*, USBImager ou `dd` pour faire ça!
* N'utilisez pas *Balena Etcher*, USBImager ou `dd` pour faire ça!
Insérez cette clé USB dans l'ordinateur et démarrez en utisant celle-ci. Ventoy va apparaitre et lister toutes les images qui sont sur la clé USB. Sélectionnez l'image de Yunohost. Sélectionnez ensuite "GRUB2" comme option de démarrage (ou utilisez n'importe laquelle qui fonctionnera sur votre ordinateur 😉)
[/ui-tab]
@ -371,15 +369,8 @@ Allez dans **Réglages** > **Réseau** :
{% endif %}
{% if arm %}
## [fa=plug /] Démarrer la carte
* Branchez le câble Ethernet (un côté sur votre box, l'autre côté à votre carte).
@ -391,6 +382,7 @@ Allez dans **Réglages** > **Réseau** :
* Assurez-vous que votre ordinateur (de bureau ou portable) est connecté au même réseau local (c'est-à-dire la même box Internet) que votre serveur.
{% elseif virtualbox %}
## [fa=plug /] Lancer la machine virtuelle
Démarrez votre machine virtuelle après avoir sélectionné l'image YunoHost.
@ -400,6 +392,7 @@ Démarrez votre machine virtuelle après avoir sélectionné l'image YunoHost.
! Si vous rencontrez l'erreur "VT-x is not available", il vous faut probablement activer (enable) la virtualisation dans les options du BIOS de votre ordinateur.
{% else %}
## [fa=plug /] Démarrer la machine sur la clé USB
* Branchez le câble Ethernet (un côté à votre box, de l'autre côté à votre carte).
@ -411,8 +404,8 @@ Démarrez votre machine virtuelle après avoir sélectionné l'image YunoHost.
{% endif %}
{% if regular or virtualbox %}
## [fa=rocket /] Lancer l’installation graphique
## [fa=rocket /] Lancer l’installation graphique
Votre écran devrait ressembler à la capture ci-dessous :
@ -434,7 +427,8 @@ Le projet YunoHost a simplifié au maximum l'installation classique afin d'évit
Avec l'installation en mode expert, vous avez plus de possibilités notamment concernant le partitionnement exact de vos supports de stockages. Vous pouvez aussi décider d'utiliser le mode classique et [ajouter vos disques après coup](/external_storage).
### Résumé des étapes en mode expert:
### Résumé des étapes en mode expert
1. Sélectionnez `Expert graphical install`
2. Sélectionnez votre langue, votre localisation, votre agencement de clavier et éventuellement votre timezone.
3. Partitionner vos disques. C'est à cette étape que vous pouvez configurer un RAID ou chiffrer tout ou partie du serveur.
@ -460,13 +454,16 @@ Si vous avez un ou des disques durs pour stocker les données, vous pouvez chois
Si vous souhaitez de la souplesse et ne pas avoir à (re-)dimensionner des partitions, vous pouvez aussi choisir de monter sur `/mnt/hdd` et de suivre ce [tutoriel pour monter l'ensemble de ces dossiers avec `mount --bind`](/external_storage).
### A propos du chiffrement
Prenez bien en compte que si vous chiffrez tout ou partie de vos disques, vous aurez à taper la phrase de passe à chaque redémarrage de votre serveur, ce qui peut poser problème si vous n'êtes pas sur place. Il existe toutefois des solutions (assez difficiles à mettre en oeuvre) qui permettent de tapper la phrase via SSH ou via une page web (cherchez "dropbear encrypted disk").
### A propos du RAID
Ne perdez pas de vue que:
* les disques de vos RAID doivent être de marque, d'usure ou de lots distincts (surtout si ce sont des SSD)
* un RAID 1 (même sans disque de spare) est plus fiable qu'un RAID5 d'un point de vue probabilité
* les raid matériels sont dépendant de la carte raid, si celle-ci fait défaut il en faudra une de remplacement pour pouvoir lire et reconstruire la grappe
* les disques de vos RAID doivent être de marque, d'usure ou de lots distincts (surtout si ce sont des SSD)
* un RAID 1 (même sans disque de spare) est plus fiable qu'un RAID5 d'un point de vue probabilité
* les raid matériels sont dépendant de la carte raid, si celle-ci fait défaut il en faudra une de remplacement pour pouvoir lire et reconstruire la grappe
[/ui-tab]
[/ui-tabs]
@ -474,20 +471,24 @@ Ne perdez pas de vue que:
!!! Si l'installation de Yunohost échoue sur votre machine et que vous n'arrivez pas à résoudre le problème, sachez qu'il est aussi possible d'installer Debian et ensuite d'installer Yunohost dessus. Pour les instructions, au sommet de cette page, sélectionnez "Serveur distant" puis "VPS ou serveur dédié avec Debian".
{% endif %}
{% if rpi012 %}
## [fa=bug /] Se connecter à la carte et corriger l'image
Les Raspberry Pi 1 et Zero ne sont pas totalement supportés à cause de [problèmes de compilation pour cette architecture](https://github.com/YunoHost/issues/issues/1423).
Cependant, il est possible de corriger l'image par vous-même avant de lancer la configuration initiale.
Pour y parvenir, vous devez vous connecter à votre Raspberry Pi en tant que root [via SSH](/ssh) avec le mot de passe temporaire `yunohost`:
```
ssh root@yunohost.local
```
(utilisez `yunohost-2.local`, etc. s'il y a plusieurs serveurs YunoHost sur le réseau)
Ensuite, lancez les commandes suivantes pour contourner le dysfonctionnement de Metronome :
```
mv /usr/bin/metronome{,.bkp}
mv /usr/bin/metronomectl{,.bkp}
@ -496,6 +497,7 @@ ln -s /usr/bin/true /usr/bin/metronomectl
```
Et celle-ci pour contourner celui de upnpc :
```
sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py
```
@ -503,6 +505,7 @@ sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/fir
! Cette dernière commande nécessite d'être lancée après chaque mise à jour de YunoHost :/
{% elseif arm_unsup %}
## [fa=terminal /] Se connecter à la carte
Ensuite, il vous faut [trouver l'adresse IP locale de votre serveur](/finding_the_local_ip) pour vous connecter en tant que root [via SSH](/ssh) avec le mot de passe temporaire `1234`.
@ -515,17 +518,18 @@ ssh root@192.168.x.xxx
{% endif %}
{% if vps_debian or arm_unsup %}
## [fa=rocket /] Lancer le script d'installation
- Ouvrez la ligne de commande sur votre serveur (soit directement, soit avec [SSH](/ssh))
- Assurez-vous d'être connecté en tant que root (ou tapez `sudo -i` pour le devenir)
- Lancez la commande suivante :
* Ouvrez la ligne de commande sur votre serveur (soit directement, soit avec [SSH](/ssh))
* Assurez-vous d'être connecté en tant que root (ou tapez `sudo -i` pour le devenir)
* Lancez la commande suivante :
```bash
curl https://install.yunohost.org | bash
```
!!! Si `curl` n'est pas installé sur votre système, il vous faudra peut-être l'installer avec `apt install curl`.
!!! Autrement, si la commande n'affiche rien du tout, vous pouvez tenter `apt install ca-certificates`
@ -533,7 +537,6 @@ curl https://install.yunohost.org | bash
{% endif %}
## [fa=cog /] Lancer la configuration initiale
!!! Si vous êtes en train de restaurer une sauvegarde YunoHost, vous devez sauter cette étape et vous référer à la section [Restaurer durant la post-installation à la place de cette étape de configuration initiale](/backup#restoring-during-the-postinstall).
@ -612,10 +615,12 @@ Pour lancer le diagnostic, allez dans l'Administration Web dans la partie Diagno
[/ui-tab]
[ui-tab title="À partir de la ligne de commande"]
```
yunohost diagnosis run
yunohost diagnosis show --issues --human-readable
```
[/ui-tab]
[/ui-tabs]
@ -634,13 +639,15 @@ Pour plus d'instructions détaillées, ou pour en savoir plus à propos des cert
[/ui-tab]
[ui-tab title="À partir de la ligne de commande"]
```
yunohost domain cert install
```
[/ui-tab]
[/ui-tabs]
## ![](image://tada.png?resize=32&classes=inline) Félicitations !
## ![](image://tada.png?resize=32&classes=inline) Félicitations
Vous avez maintenant un serveur plutôt bien configuré. Si vous découvrez YunoHost, nous vous recommandons de jeter un œil à [la visite guidée](/overview). Vous devriez aussi être en mesure d'[installer vos applications favorites](/apps). N'oubliez pas de [prévoir des sauvegardes](/backup) !

110
pages/02.administer/10.install/install.md
View file

@ -70,27 +70,27 @@ Select the hardware on which you want install YunoHost :
[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)
[[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)
[[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)
[[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="Regular computer"]![](image://computer.png?height=75)[/figure]](/install/hardware:regular)
[[figure caption="Regular 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)
[[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)
[[figure caption="Remote server"]![][image://vps.png?height=75](/figure)](/install/hardware:vps_debian)
[/div]
[/div]
@ -98,51 +98,50 @@ Select the hardware on which you want install YunoHost :
{% if rpi012 or rpi34 %}
[div class="flex-child hardware{%if rpi34 %} active{% endif %}"]
[[figure caption="Raspberry Pi 3 or 4"]![](image://raspberrypi.png?height=50)[/figure]](/install/hardware:rpi34)
[[figure caption="Raspberry Pi 3 or 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 or 2"]![](image://rpi1.png?height=50)[/figure]](/install/hardware:rpi012)
[[figure caption="Raspberry Pi 0, 1 or 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 With VPN"]![](image://internetcube.png?height=50)[/figure]](/install/hardware:internetcube)
[[figure caption="Internet cube With 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 or Orange Pi PC+"]![](image://olinuxino.png?height=50)[/figure]](/install/hardware:arm_sup)
[[figure caption="Olinuxino lime1&2 or 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="Others boards"]![](image://odroidhc4.png?height=50)[/figure]](/install/hardware:arm_unsup)
[[figure caption="Others 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 or dedicated server with Debian 11"]![](image://debian-logo.png?height=50)[/figure]](/install/hardware:vps_debian)
[[figure caption="VPS or dedicated server with 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 or dedicated server with YunoHost pre-installed"]![](image://logo.png?height=50)[/figure]](/install/hardware:vps_ynh)
[[figure caption="VPS or dedicated server with YunoHost pre-installed"]![][image://logo.png?height=50](/figure)](/install/hardware:vps_ynh)
[/div]
{% endif %}
[/div]
{% if hardware != '' %}
{% if wsl %}
!! This setup is mainly meant for local testing by advanced users. Due to limitations on WSL's side (changing IP address, notably), selfhosting from it can be tricky and will not be described here.
{% endif %}
## [fa=list-alt /] Pre-requisites
{% if regular %}
* A x86-compatible hardware dedicated to YunoHost: laptop, nettop, netbook, desktop with 512MB RAM and 16GB capacity (at least)
{% elseif rpi34 %}
* A Raspberry Pi 3 or 4
@ -190,7 +189,9 @@ Select the hardware on which you want install YunoHost :
{% endif %}
{% if wsl %}
## Introduction
WSL is a nice feature of Windows 10, making Linux pseudo-distributions available through command line. Let's say pseudo, because even though they are not really like virtual machines, they rely on virtualization capacities that make their integration with Windows almost seamless.
Docker for Windows can now rely on WSL instead of Hyper-V, for example.
@ -225,6 +226,7 @@ sudo apt update
sudo apt upgrade
sudo apt dist-upgrade
```
## Prevent WSL from tweaking configuration files
Edit `/etc/wsl.conf` and put the following code in it:
@ -252,6 +254,7 @@ Debian on WSL does not have `systemd`, a service configuration software.
This is a key element for YunoHost, and for any decent Debian distro (seriously MS, what the heck). Let's install it:
1. Install dotNET runtime:
```bash
# In WSL
wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
@ -263,6 +266,7 @@ sudo apt install -y dotnet-sdk-3.1
```
2. Install [Genie](https://github.com/arkane-systems/genie):
```bash
# In WSL
# Add their repository
@ -292,7 +296,9 @@ Always call `genie -s` while starting your distro.
`wsl -d YunoHost -e genie -s`
## Backup and restore the distro
### Make your first distro backup
As said before, there is no rollback capability. So let's export your fresh distro. In PowerShell:
```
@ -307,10 +313,11 @@ cd ~
wsl --unregister YunoHost
wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
```
{% endif %}
{% if vps_ynh %}
## YunoHost VPS providers
Here are some VPS providers supporting YunoHost natively :
@ -318,19 +325,19 @@ Here are some VPS providers supporting YunoHost natively :
[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)
[[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)
[[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="ECOWAN - FR"]![](image://vps_ynh_ecowan.png?height=50)[/figure]](https://www.ecowan.fr/vps-linux)
[[figure caption="ECOWAN - FR"]![][image://vps_ynh_ecowan.png?height=50](/figure)](<https://www.ecowan.fr/vps-linux>)
[/div]
[/div]
{% endif %}
{% if at_home %}
## [fa=download /] Download the {{image_type}} image
{% if rpi012 %}
@ -413,17 +420,16 @@ $(document).ready(function () {
});
</script>
{% if not virtualbox %}
{% if arm %}
## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash the {{image_type}} image
{% else %}
## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flash the YunoHost image
{% endif %}
Now that you downloaded the image of {{image_type}}, you should flash it on {% if arm %}a microSD card{% else %}a USB stick or a CD/DVD.{% endif %}
@ -457,6 +463,7 @@ Then run :
# Replace /dev/mmcblk0 if the name of your device is different...
dd if=/path/to/yunohost.img of=/dev/mmcblk0
```
[/ui-tab]
{% if regular %}
[ui-tab title="Burning a CD/DVD"]
@ -472,10 +479,11 @@ For older devices, you might want to burn a CD/DVD. The software to use depends
Ventoy will be useful if you can't sucessfully boot the Yunohost image using the other methods.
[Ventoy](https://www.ventoy.net/) is a nice tool that makes it really easy to put multiple linux images on a USB stick. When the computer refuses to boot from an image on a usb stick, Ventoy will usually be able to boot it anyway!
1. Install [Ventoy](https://www.ventoy.net/) on the USB stick. Refer to the [install instructions](https://www.ventoy.net/en/doc_start.html).
- This will create 2 partitions on the stick.
* This will create 2 partitions on the stick.
3. Using your favorite file explorer app, copy the Yunohost image file on the big `Ventoy` partition (not "VTOYEFI")
- Don't use *Balena Etcher*, USBImager or `dd` for this!
* Don't use *Balena Etcher*, USBImager or `dd` for this!
Later, when you'll boot the computer using this usb stick, Ventoy will appear and will list the images on the USB stick. Select the Yunohost image, then select GRUB2 launch option (or use whichever works for your computer 😉)
[/ui-tab]
@ -504,15 +512,8 @@ Go to **Settings** > **Network**:
{% endif %}
{% if arm %}
## [fa=plug /] Power up the board
* Plug the ethernet cable (one side on your main router, the other on your board).
@ -524,6 +525,7 @@ Go to **Settings** > **Network**:
* Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server.
{% elseif virtualbox %}
## [fa=plug /] Boot up the virtual machine
Start the virtual machine after selecting the YunoHost image.
@ -532,8 +534,8 @@ Start the virtual machine after selecting the YunoHost image.
! If you encounter the error "VT-x is not available", you probably need to enable Virtualization in the BIOS of your computer.
{% else %}
## [fa=plug /] Boot the machine on your USB stick
* Plug the ethernet cable (one side on your main router, the other on your server).
@ -545,6 +547,7 @@ Start the virtual machine after selecting the YunoHost image.
{% endif %}
{% if regular or virtualbox %}
## [fa=rocket /] Launch the graphical install
You should see a screen like this:
@ -569,7 +572,8 @@ The YunoHost project simplified the classic installation as much as possible in
With the expert mode installation, you have more possibilities, especially concerning the exact partitioning of your storage media. You can also decide to use the classic mode and [add your disks afterwards](/external_storage).
### Summary of the steps in expert mode:
### Summary of the steps in expert mode
1. Select `Expert graphical install`.
2. Select your language, location, keyboard layout and possibly your timezone.
3. Partition your disks. This is where you can set up a RAID or encrypt all or part of the server.
@ -595,13 +599,16 @@ If you have one or more hard drives to store data, you can choose to mount it on
If you want flexibility and don't want to (re)size partitions, you can also choose to mount on `/mnt/hdd` and follow this [tutorial to mount all these folders with `mount --bind`](/external_storage).
### About encryption
Be aware that if you encrypt all or part of your disks, you will have to type the passphrase every time you restart your server, which can be a problem if you are not on site. There are however solutions (quite difficult to implement) that allow you to type the passphrase via SSH or via a web page (search for "dropbear encrypted disk").
### About RAID
Keep in mind that:
* the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs)
* a RAID 1 (even without a spare) is more reliable than a RAID 5 from a probability point of view
* hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array
* the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs)
* a RAID 1 (even without a spare) is more reliable than a RAID 5 from a probability point of view
* hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array
[/ui-tab]
[/ui-tabs]
@ -609,20 +616,24 @@ Keep in mind that:
!!! If the Yunohost installer fails and you can't solve the issue, know that it's also possible to install Debian and then install Yunohost on top. For instructions, at the top of this page, select "Remote server", then "VPS or dedicated server with Debian".
{% endif %}
{% if rpi012 %}
## [fa=bug /] Connect to the board and hotfix the image
Raspberry Pi 1 and 0 are not totally supported due to [compilation issues for this architecture](https://github.com/YunoHost/issues/issues/1423).
However, it is possible to fix by yourself the image before to run the initial configuration.
To achieve this, you need to connect on your raspberry pi as root user [via SSH](/ssh) with the temporary password `yunohost`:
```
ssh root@yunohost.local
```
(or `yunohost-2.local`, and so on if multiple YunoHost servers are on your network)
Then run the following commands to work around the metronome issue:
```
mv /usr/bin/metronome{,.bkp}
mv /usr/bin/metronomectl{,.bkp}
@ -631,6 +642,7 @@ ln -s /usr/bin/true /usr/bin/metronomectl
```
And this one to work around the upnpc issue:
```
sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py
```
@ -638,6 +650,7 @@ sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/fir
! This last command need to be run after each yunohost upgrade :/
{% elseif arm_unsup %}
## [fa=terminal /] Connect to the board
Next you need to [find the local IP address of your server](/finding_the_local_ip) to connect as root user [via SSH](/ssh) with the temporary password `1234`.
@ -650,13 +663,13 @@ ssh root@192.168.x.xxx
{% endif %}
{% if vps_debian or arm_unsup %}
## [fa=rocket /] Run the install script
- Open a command line prompt on your server (either directly or [through SSH](/ssh))
- Make sure you are root (or type `sudo -i` to become root)
- Run the following command:
* Open a command line prompt on your server (either directly or [through SSH](/ssh))
* Make sure you are root (or type `sudo -i` to become root)
* Run the following command:
```bash
curl https://install.yunohost.org | bash
@ -744,7 +757,6 @@ If you want to create subdomains, do not forget to add them in the `hosts` file
This user replaces the old `admin` user, which some old documentation page may still refer to. In which case : just replace `admin` with your username.
## [fa=stethoscope /] Run the initial diagnosis
Once the postinstall is done, you should be able to actually log in the web admin interface using the credentials of the first user you just created.
@ -772,10 +784,12 @@ To run a diagnosis, go on Web Admin in the Diagnosis section. Click Run initial
[/ui-tab]
[ui-tab title="From the command line"]
```
yunohost diagnosis run
yunohost diagnosis show --issues --human-readable
```
[/ui-tab]
[/ui-tabs]
@ -796,13 +810,15 @@ Go in Domains > Click on your domain > SSL Certificate
[/ui-tab]
[ui-tab title="From the command line"]
```
yunohost domain cert install
```
[/ui-tab]
[/ui-tabs]
## ![](image://tada.png?resize=32&classes=inline) Congratz!
## ![](image://tada.png?resize=32&classes=inline) Congratz
You now have a pretty well configured server. If you're new to YunoHost, we recommend to have a look at [the guided tour](/overview). You should also be able to [install your favourite applications](/apps). Don't forget to [plan backups](/backup) !

105
pages/02.administer/10.install/install.ru.md
View file

@ -70,27 +70,27 @@ routes:
[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)
[[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)
[[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 платы"]![](image://olinuxino.png?height=75)[/figure]](/install/hardware:arm)
[[figure caption="ARM платы"]![][image://olinuxino.png?height=75](/figure)](/install/hardware:arm)
[/div]
[div class="flex-child hardware{%if regular %} active{% endif %}"]
[[figure caption="Обычный компьютер"]![](image://computer.png?height=75)[/figure]](/install/hardware:regular)
[[figure caption="Обычный компьютер"]![][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)
[[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="Удалённый сервер"]![](image://vps.png?height=75)[/figure]](/install/hardware:vps_debian)
[[figure caption="Удалённый сервер"]![][image://vps.png?height=75](/figure)](/install/hardware:vps_debian)
[/div]
[/div]
@ -98,51 +98,50 @@ routes:
{% if rpi012 or rpi34 %}
[div class="flex-child hardware{%if rpi34 %} active{% endif %}"]
[[figure caption="Raspberry Pi 3 или 4"]![](image://raspberrypi.png?height=50)[/figure]](/install/hardware:rpi34)
[[figure caption="Raspberry Pi 3 или 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 или 2"]![](image://rpi1.png?height=50)[/figure]](/install/hardware:rpi012)
[[figure caption="Raspberry Pi 0, 1 или 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 с VPN"]![](image://internetcube.png?height=50)[/figure]](/install/hardware:internetcube)
[[figure caption="Internet cube с 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 или Orange Pi PC+"]![](image://olinuxino.png?height=50)[/figure]](/install/hardware:arm_sup)
[[figure caption="Olinuxino lime1&2 или 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="Другие платы"]![](image://odroidhc4.png?height=50)[/figure]](/install/hardware:arm_unsup)
[[figure caption="Другие платы"]![][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 или выделенный сервер с Debian 11"]![](image://debian-logo.png?height=50)[/figure]](/install/hardware:vps_debian)
[[figure caption="VPS или выделенный сервер с 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 или выделенный сервер с предустановленным YunoHost"]![](image://logo.png?height=50)[/figure]](/install/hardware:vps_ynh)
[[figure caption="VPS или выделенный сервер с предустановленным YunoHost"]![][image://logo.png?height=50](/figure)](/install/hardware:vps_ynh)
[/div]
{% endif %}
[/div]
{% if hardware != '' %}
{% if wsl %}
!! Эта настройка в основном предназначена для локального тестирования продвинутыми пользователями. Из-за ограничений на стороне WSL (в частности, изменение IP-адреса) самостоятельный хостинг с него может быть сложным и здесь описываться не будет.
{% endif %}
## [fa=list-alt /] Предварительные условия
{% if regular %}
* x86-совместимое оборудование, предназначенное для YunoHost: ноутбук, неттоп, нетбук, настольный компьютер с 512 МБ оперативной памяти и емкостью 16 ГБ (не менее)
{% elseif rpi34 %}
* Raspberry Pi 3 or 4
@ -190,7 +189,9 @@ routes:
{% endif %}
{% if wsl %}
## Вступление
WSL is a nice feature of Windows 10, making Linux pseudo-distributions available through command line. Let's say pseudo, because even though they are not really like virtual machines, they rely on virtualization capacities that make their integration with Windows almost seamless.
Docker for Windows can now rely on WSL instead of Hyper-V, for example.
@ -225,6 +226,7 @@ sudo apt update
sudo apt upgrade
sudo apt dist-upgrade
```
## Prevent WSL from tweaking configuration files
Edit `/etc/wsl.conf` and put the following code in it:
@ -252,6 +254,7 @@ Debian on WSL does not have `systemd`, a service configuration software.
This is a key element for YunoHost, and for any decent Debian distro (seriously MS, what the heck). Let's install it:
1. Install dotNET runtime:
```bash
# In WSL
wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
@ -263,6 +266,7 @@ sudo apt install -y dotnet-sdk-3.1
```
2. Install [Genie](https://github.com/arkane-systems/genie):
```bash
# In WSL
# Add their repository
@ -292,7 +296,9 @@ Always call `genie -s` while starting your distro.
`wsl -d YunoHost -e genie -s`
## Backup and restore the distro
### Make your first distro backup
As said before, there is no rollback capability. So let's export your fresh distro. In PowerShell:
```
@ -307,10 +313,11 @@ cd ~
wsl --unregister YunoHost
wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
```
{% endif %}
{% if vps_ynh %}
## YunoHost VPS providers
Here are some VPS providers supporting YunoHost natively :
@ -318,19 +325,19 @@ Here are some VPS providers supporting YunoHost natively :
[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)
[[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)
[[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="ECOWAN - FR"]![](image://vps_ynh_ecowan.png?height=50)[/figure]](https://www.ecowan.fr/vps-linux)
[[figure caption="ECOWAN - FR"]![][image://vps_ynh_ecowan.png?height=50](/figure)](<https://www.ecowan.fr/vps-linux>)
[/div]
[/div]
{% endif %}
{% if at_home %}
## [fa=download /] Download the {{image_type}} image
{% if rpi012 %}
@ -413,17 +420,16 @@ $(document).ready(function () {
});
</script>
{% if not virtualbox %}
{% if arm %}
## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash the {{image_type}} image
{% else %}
## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flash the YunoHost image
{% endif %}
Now that you downloaded the image of {{image_type}}, you should flash it on {% if arm %}a microSD card{% else %}a USB stick or a CD/DVD.{% endif %}
@ -457,6 +463,7 @@ Then run :
# Replace /dev/mmcblk0 if the name of your device is different...
dd if=/path/to/yunohost.img of=/dev/mmcblk0
```
[/ui-tab]
{% if regular %}
[ui-tab title="Burning a CD/DVD"]
@ -493,15 +500,8 @@ Go to **Settings** > **Network**:
{% endif %}
{% if arm %}
## [fa=plug /] Power up the board
* Plug the ethernet cable (one side on your main router, the other on your board).
@ -513,6 +513,7 @@ Go to **Settings** > **Network**:
* Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server.
{% elseif virtualbox %}
## [fa=plug /] Boot up the virtual machine
Start the virtual machine after selecting the YunoHost image.
@ -521,8 +522,8 @@ Start the virtual machine after selecting the YunoHost image.
! If you encounter the error "VT-x is not available", you probably need to enable Virtualization in the BIOS of your computer.
{% else %}
## [fa=plug /] Boot the machine on your USB stick
* Plug the ethernet cable (one side on your main router, the other on your server).
@ -532,6 +533,7 @@ Start the virtual machine after selecting the YunoHost image.
{% endif %}
{% if regular or virtualbox %}
## [fa=rocket /] Launch the graphical install
You should see a screen like this:
@ -556,7 +558,8 @@ The YunoHost project simplified the classic installation as much as possible in
With the expert mode installation, you have more possibilities, especially concerning the exact partitioning of your storage media. You can also decide to use the classic mode and [add your disks afterwards](/external_storage).
### Summary of the steps in expert mode:
### Summary of the steps in expert mode
1. Select `Expert graphical install`.
2. Select your language, location, keyboard layout and possibly your timezone.
3. Partition your disks. This is where you can set up a RAID or encrypt all or part of the server.
@ -582,32 +585,39 @@ If you have one or more hard drives to store data, you can choose to mount it on
If you want flexibility and don't want to (re)size partitions, you can also choose to mount on `/mnt/hdd` and follow this [tutorial to mount all these folders with `mount --bind`](/external_storage).
### About encryption
Be aware that if you encrypt all or part of your disks, you will have to type the passphrase every time you restart your server, which can be a problem if you are not on site. There are however solutions (quite difficult to implement) that allow you to type the passphrase via SSH or via a web page (search for "dropbear encrypted disk").
### About RAID
Keep in mind that:
* the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs)
* a RAID 1 (even without a spare) is more reliable than a RAID 5 from a probability point of view
* hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array
* the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs)
* a RAID 1 (even without a spare) is more reliable than a RAID 5 from a probability point of view
* hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array
[/ui-tab]
[/ui-tabs]
{% endif %}
{% if rpi012 %}
## [fa=bug /] Connect to the board and hotfix the image
Raspberry Pi 1 and 0 are not totally supported due to [compilation issues for this architecture](https://github.com/YunoHost/issues/issues/1423).
However, it is possible to fix by yourself the image before to run the initial configuration.
To achieve this, you need to connect on your raspberry pi as root user [via SSH](/ssh) with the temporary password `yunohost`:
```
ssh root@yunohost.local
```
(or `yunohost-2.local`, and so on if multiple YunoHost servers are on your network)
Then run the following commands to work around the metronome issue:
```
mv /usr/bin/metronome{,.bkp}
mv /usr/bin/metronomectl{,.bkp}
@ -616,6 +626,7 @@ ln -s /usr/bin/true /usr/bin/metronomectl
```
And this one to work around the upnpc issue:
```
sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py
```
@ -623,6 +634,7 @@ sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/fir
! This last command need to be run after each yunohost upgrade :/
{% elseif arm_unsup %}
## [fa=terminal /] Connect to the board
Next you need to [find the local IP address of your server](/finding_the_local_ip) to connect as root user [via SSH](/ssh) with the temporary password `1234`.
@ -635,13 +647,13 @@ ssh root@192.168.x.xxx
{% endif %}
{% if vps_debian or arm_unsup %}
## [fa=rocket /] Run the install script
- Open a command line prompt on your server (either directly or [through SSH](/ssh))
- Make sure you are root (or type `sudo -i` to become root)
- Run the following command:
* Open a command line prompt on your server (either directly or [through SSH](/ssh))
* Make sure you are root (or type `sudo -i` to become root)
* Run the following command:
```bash
curl https://install.yunohost.org | bash
@ -729,7 +741,6 @@ If you want to create subdomains, do not forget to add them in the `hosts` file
This user replaces the old `admin` user, which some old documentation page may still refer to. In which case : just replace `admin` with your username.
## [fa=stethoscope /] Run the initial diagnosis
Once the postinstall is done, you should be able to actually log in the web admin interface using the credentials of the first user you just created.
@ -757,10 +768,12 @@ To run a diagnosis, go on Web Admin in the Diagnosis section. Click Run initial
[/ui-tab]
[ui-tab title="From the command line"]
```
yunohost diagnosis run
yunohost diagnosis show --issues --human-readable
```
[/ui-tab]
[/ui-tabs]
@ -781,13 +794,15 @@ Go in Domains > Click on your domain > SSL Certificate
[/ui-tab]
[ui-tab title="From the command line"]
```
yunohost domain cert install
```
[/ui-tab]
[/ui-tabs]
## ![](image://tada.png?resize=32&classes=inline) Congratz!
## ![](image://tada.png?resize=32&classes=inline) Congratz
You now have a pretty well configured server. If you're new to YunoHost, we recommend to have a look at [the guided tour](/overview). You should also be able to [install your favourite applications](/apps). Don't forget to [plan backups](/backup) !

8
pages/02.administer/15.admin_guide/05.guidelines/guidelines.de.md
View file

@ -13,16 +13,18 @@ Diese Seite listet einige Tipps und Richtlinien auf, die jeder YunoHost-Administ
Das heißt : Entweder ist der Server für den Betreib vorgesehen, oder ein Testserver, auf dem Sie sich erlauben, zu experimentieren.
Ist Ihr Ziel, einen Produktionserver zu benutzen, so beachten Sie folgendes :
Ist Ihr Ziel, einen Prsoduktionserver zu benutzen, so beachten Sie folgendes :
- ein Server ist ein empfindliches System : Seien Sie vorsichtig, methodisch und geduldig ;
- experimentieren und Anpassen einschränken - insbesondere von Konfigurationsdateien ;
- nicht Dutzende von Anwendungen installieren, bloß zum sehen, wie sie aussehen ;
- Vorsicht mit inoffiziellen Anwendungen, und verzichten auf solche, die noch "in Bearbeitung" sind, oder einen Level 0 haben ;
- wenn etwas kaputt geht, überlegen Sie richtig, bevor Sie versuchen, es selbst zu reparieren, wenn Sie nicht wissen, was Sie tun. <small>(z. B., den Admin-Benutzer nicht selbst versuchen neu anzulegen, falls er komischerweise verschwunden ist.)</small>
## Keep it simple !
## Keep it simple
YunoHost ist für allgemeine und einfache Anwendungsfälle konzipiert. Wenn Sie von diesen Bedingungen abweichen, wird es schwieriger, und Sie benötigen technisches Wissen, um sie zu erfüllen. Zum Beispiel:
- Versuchen Sie nicht, YunoHost in einem Kontext auszuführen, in dem Sie keine Kontrolle über die Ports 80 und 443 haben (oder überhaupt kein Internet);
- Versuchen Sie nicht, fünf Server über dieselbe Internetverbindung zu hosten, wenn Sie nicht bereits ein fortgeschrittener Benutzer sind;
- Reiben Sie sich nicht an dem Versuch auf, NGINX durch Apache zu ersetzen (oder beides gleichzeitig laufen zu lassen);
@ -45,7 +47,7 @@ Wenn Sie Dienste und Daten hosten, die für Ihre Benutzer wichtig sind, ist es w
Als Administrator sollten Sie einen E-Mail-Client so einrichten, dass er E-Mails prüft, die an `root@your.domain.tld` (das muss ein Alias für den ersten von Ihnen hinzugefügten Benutzer sein) gesendet werden, oder sie an eine andere Adresse weiterleitet, die Sie aktiv prüfen. Diese E-Mails können Informationen darüber enthalten, was auf Ihrem Server passiert, wie z. B. periodische automatisierte Aufgaben.
## YunoHost ist freie Software, die von Freiwilligen instand gehalten wird.
## YunoHost ist freie Software, die von Freiwilligen instand gehalten wird
Schließlich sollten Sie bedenken, dass YunoHost eine freie Software ist, die von Freiwilligen gepflegt wird - und dass das Ziel von YunoHost (die Demokratisierung des Selbst-Hostings) nicht einfach ist! Die Software wird ohne jegliche Garantie zur Verfügung gestellt. Das YunoHost Team tut sein Bestes, um das bestmögliche Erlebnis zu erhalten und zu bieten - dennoch sind die Funktionen, Anwendungen und YunoHost als Ganzes weit davon entfernt, perfekt zu sein, und Sie werden früher oder später auf kleine oder große Probleme stoßen. Wenn das passiert, kommen Sie bitte [in den Chat oder das Forum und bitten um Hilfe, oder melden das Problem](/help) :)!

6
pages/02.administer/15.admin_guide/05.guidelines/guidelines.fr.md
View file

@ -14,15 +14,17 @@ Cette page énumère quelques conseils et lignes directrices que tout administra
En d'autres termes : votre serveur est soit un « serveur de production » (destiné à fonctionner), soit un serveur de test sur lequel vous vous permettez d'expérimenter.
Si votre but est d'avoir un serveur de production :
- soyez conscient qu'un serveur est un système fragile : restez prudent, méthodique et patient ;
- limitez les expérimentations et la personnalisation - notamment des fichiers de config ;
- n'installez pas des douzaines d'applications juste pour voir de quoi elles ont l'air ;
- utilisez les applications non-officielles avec prudence, et interdisez-vous d'utiliser celles marquées 'in progress', 'not working' ou qui sont en niveau 0 ;
- si quelque chose casse, réfléchissez à deux fois avant de tenter de le réparer vous-même si vous ne savez pas ce que vous faites. <small>(Par exemple, n'essayez pas de recréer vous-même l'utilisateur admin juste parce qu'il a mystérieusement disparu...)</small>
## Keep it simple !
## Keep it simple
YunoHost est conçu pour fonctionner avec des cas d'utilisation généraux et simples. S'écarter de ces conditions rendra les choses plus difficiles et vous aurez besoin de connaissances techniques pour les faire fonctionner. Par exemple,
- n'essayez pas d'exécuter YunoHost dans un contexte où vous ne pouvez pas avoir le contrôle des ports 80 et 443 (ou pas d'Internet du tout) ;
- n'essayez pas d'héberger cinq serveurs derrière la même connexion Internet si vous n'êtes pas déjà un utilisateur avancé ;
- ne vous tourmentez pas à vouloir remplacer NGINX par Apache (ou faire tourner les deux à la fois) ;
@ -45,7 +47,7 @@ Si vous hébergez des services et des données qui sont importants pour vos util
En tant qu'administrateur, vous devriez configurer un client de messagerie pour vérifier les e-mails envoyés à `root@votre.domaine.tld` (qui doit être un alias pour le premier utilisateur que vous avez ajouté) ou les transférer à une autre adresse que vous vérifiez activement. Ces courriels peuvent contenir des informations sur ce qui se passe sur votre serveur, comme les tâches périodiques automatisées.
## YunoHost est un logiciel gratuit, maintenu par des bénévoles.
## YunoHost est un logiciel gratuit, maintenu par des bénévoles
Enfin, gardez à l'esprit que YunoHost est un logiciel libre maintenu par des volontaires - et que le but de YunoHost (démocratiser l'auto-hébergement) n'est pas simple ! Le logiciel est fourni sans aucune garantie. L'équipe de bénévoles fait de son mieux pour maintenir et fournir la meilleure expérience possible - pourtant les fonctionnalités, les applications et YunoHost dans son ensemble sont loin d'être parfaits et vous ferez face tôt ou tard à de petit ou gros problèmes. Lorsque cela se produit, venez gentiment [demander de l'aide sur le chat ou le forum, ou signaler le problème](/help) :) !

6
pages/02.administer/15.admin_guide/05.guidelines/guidelines.it.md
View file

@ -14,15 +14,17 @@ Questa pagina elenca qualche consiglio e delle linee guida che tutti gli amminis
In altre parole: il tuo server può essere un "server in produzione" (destinato a funzionare), oppure un server di test che ti permette di sperimentare.
Se il tuo obiettivo è avere un server in produzione:
- sii consapevole che i server sono sistemi fragili: sii prudente, metodico e paziente;
- limita gli esperimenti e le personalizzazioni (per le istanze il file config)
- non installare dozzine di installazioni solo per vedere come sono;
- usa le applicazioni non ufficiali con prudenza, e evita di usare quelle 'in progress', 'not working' o che hanno un livello 0;
- se qualcosa dovesse rompersi, pensate due volte prima di cercare di riparare da soli se non sapete quello che state facendo. <small>(Per esempio, non tentate di ricreare da soli l'utente admin solo perché sembra che sia misteriosamente scomparso...)</small>
## Keep it simple !
## Keep it simple
YunoHost è progettato per funzionare in casi d'uso generici e semplici. Deviare da queste condizioni renderà le cose più difficili e avrai bisogno di conoscenze tecniche perché tutto funzioni. Per esempio,
- non provare ad eseguire YunoHost in un contesto dove non puoi controllare le porte 80 e 443 (o senza Internet del tutto);
- non provare a hostare cinque server dietro la stessa connessione Internet se non sei un utente esperto;
- non cadere nei capricci dei nerd che vogliono sostituire NGINX con Apache (o farli girare tutti e due insieme);
@ -45,7 +47,7 @@ Se ospiti dei servizi e dei dati che sono importanti per i tuoi utenti, è impor
Come amministratore, dovrai configurare un client di posta per controllare le mail inviate a `root@your.domani.tld` (che dovrà essere un alias per il primo utente che aggiungerai) o trasferitele ad un altro indirizzo mail che controlli attivamente. Queste mail possono contenere informazioni riguardo quello che avviene sul tuo server, come i compiti periodici automatici.
## YunoHost è software libero, mantenuto da volontari.
## YunoHost è software libero, mantenuto da volontari
Infine, tieni presente che YunoHost è software libero mantenuto da volontari - e che l'obiettivo di YunoHost (democratizzare il self-hosting) non è semplice! Il software è fornito senza nessuna garanzia. Il team di volontari fa del suo meglio per mantenere e fornire la migliore esperienza possibile - quindi le funzionalità, le applicazioni e YunoHost nel suo insieme sono lontani dall'essere perfetti e presto o tardi incontrerai piccoli o grossi problemi. Quando accadrà potrai [chiedere aiuto sulla chat o nel forum, o segnalare il problema](/help) :)!

4
pages/02.administer/15.admin_guide/05.guidelines/guidelines.md
View file

@ -14,15 +14,17 @@ This page lists some advice and guidelines which every YunoHost administrator sh
To put it another way: your server is either a production server (meant to work) or a test server on which you allow yourself to experiment.
If your goal is to run a production server:
- be aware that servers are fragile system. Stay cautious, methodical and patient;
- limit experimentations and customizations (for instance of config file);
- do not install dozens of apps just to see how they look;
- use non-official apps with caution, and do not use apps that are still 'in progress', 'not working' or level 0;
- if something gets broken, think twice about fixing it by yourself if you don't know what you are doing. <small>(For instance, do not attempt to recreate yourself the admin user just because it mysteriously disappeared...)</small>
## Keep it simple!
## Keep it simple
YunoHost is designed to work with general and simple use cases in mind. Deviating from those conditions will make things harder and you will need technical knowledge to make it work. For instance,
- do not try to run YunoHost in a context where you cannot have control over ports 80 and 443 (or no internet at all);
- do not try to host five servers behind the same internet connection if you are not already an advanced user;
- do not fall into nerd whims such as willing to replace NGINX with Apache (or run both at the same time);

2
pages/02.administer/15.admin_guide/10.admin/admin.de.md
View file

@ -11,6 +11,6 @@ YunoHost hat ein Administrator-Webinterface. Die andere Möglichkeit, Ihre YunoH
### Zugang
Sie können auf Ihr Administrator-Webinterface unter folgender Adresse zugreifen: https://example.org/yunohost/admin (ersetzen Sie 'example.org' durch Ihren eigenen Domainnamen)
Sie können auf Ihr Administrator-Webinterface unter folgender Adresse zugreifen: <https://example.org/yunohost/admin> (ersetzen Sie 'example.org' durch Ihren eigenen Domainnamen)
![](image://webadmin.png)

2
pages/02.administer/15.admin_guide/10.admin/admin.es.md
View file

@ -11,6 +11,6 @@ YunoHost tiene una interfaz gráfica de administración. El otro método consist
### Acceso
La interfaz admin está accesible desde tu instancia YunoHost en esta dirección : https://ejemplo.org/yunohost/admin (reemplaza ejemplo.org por tu nombre de dominio)
La interfaz admin está accesible desde tu instancia YunoHost en esta dirección : <https://ejemplo.org/yunohost/admin> (reemplaza ejemplo.org por tu nombre de dominio)
![](image://webadmin.png)

3
pages/02.administer/15.admin_guide/10.admin/admin.fr.md
View file

@ -11,7 +11,6 @@ YunoHost est fourni avec une interface graphique d’administration (aussi appel
### Accès
L’interface d'administration web est accessible depuis votre instance YunoHost à l’adresse https://exemple.org/yunohost/admin (remplacez exemple.org par la bonne valeur)
L’interface d'administration web est accessible depuis votre instance YunoHost à l’adresse <https://exemple.org/yunohost/admin> (remplacez exemple.org par la bonne valeur)
![](image://webadmin_fr.png)

3
pages/02.administer/15.admin_guide/10.admin/admin.it.md
View file

@ -11,7 +11,6 @@ YunoHost ha un'interfaccia web di amministrazione. L'altro metodo è quello di u
### Accesso
L'interfaccia di amministrazione è accessibile all'indirizzo https://example.org/yunohost/admin (sostituisci 'example.org' con il tuo dominio)
L'interfaccia di amministrazione è accessibile all'indirizzo <https://example.org/yunohost/admin> (sostituisci 'example.org' con il tuo dominio)
![](image://webadmin.png)

2
pages/02.administer/15.admin_guide/10.admin/admin.md
View file

@ -11,6 +11,6 @@ YunoHost has an administrator web interface. The other way to administrate your
### Access
You can access your administrator web interface at this address: https://example.org/yunohost/admin (replace 'example.org' with your own domain name)
You can access your administrator web interface at this address: <https://example.org/yunohost/admin> (replace 'example.org' with your own domain name)
![](image://webadmin.png)

6
pages/02.administer/15.admin_guide/15.command_line/command_line.de.md
View file

@ -22,6 +22,7 @@ page-toc:
Solltest du auf einem VPS installieren, dann hat der VPS Provider die IP-Adresse, die du bei ihm erfragen solltest.
Wenn du Zuhause installierst (z.B. auf einem Raspberry Pi oder OLinuXino), dann musst du herausfinden, welche IP-Adresse dein Router dem System zugewiesen hat. Hierfür existieren mehrere Wege:
- Öffne ein Terminal und tippe `sudo arp-scan --local` ein, um eine Liste der aktiven IP-Adressen deines lokalen Netzwerks anzuzeigen;
- wenn dir der arp-scan eine zu unübersichtliche Zahl an Adressen anzeigt, versuche mit `nmap -p 22 192.168.**x**.0/24` nur die anzuzeigen, deren SSH-Port 22 offen ist. (passe das **x** deinem Netzwerk an);
- Prüfe die angezeigten Geräte in der Benutzeroberfläche deines Routers, ob du das Gerät findest;
@ -39,11 +40,11 @@ Es wird nach einem Passwort gefragt. Handelt es sich um einen VPS, sollte der VP
! Seit YunoHost 3.4 kann man sich nach dem Ausführen der Postinstallation nicht mehr als `root` anmelden. **Stattdessen sollte man sich mit dem `admin` Benutzer anmelden!** Für den Fall, dass der LDAP-Server defekt und der `admin` Benutzer nicht verwendbar ist, kann man sich eventuell trotzdem noch mit `root` über das lokale Netzwerk anmelden.
#### Ändere das Passwort!
#### Ändere das Passwort
Nach dem allerersten Login sollte man das root Passwort ändern. Der Server könnte dazu automatisch auffordern. Falls nicht, ist der Befehl `passwd` zu benutzen. Es ist wichtig, ein einigermaßen starkes Passwort zu wählen. Beachte, dass das root Passwort durch das admin Passwort überschrieben wird, wenn man die Postinstallation durchführt.
#### Auf ans Konfigurieren!
#### Auf ans Konfigurieren
Wir sind nun bereit, mit der [Postinstallation](/postinstall) zu beginnen.
@ -103,7 +104,6 @@ N.B.: `fail2ban` sperrt deine IP für 10 Minuten, wenn du 5 fehlgeschlagene Logi
Eine ausführlichere Diskussion über Sicherheit & SSH findest du auf der [dedicated page](/security).
## YunoHost Kommandozeile
!!! Ein vollständiges Tutorial über die Kommandozeile würde den Rahmen der YunoHost-Dokumentation sprengen: Lies dazu am besten ein spezielles Tutorial wie [dieses](https://ryanstutorials.net/linuxtutorial/) oder [dieses](http://linuxcommand.org/). Aber sei versichert, dass du kein CLI-Experte sein musst, um es zu benutzen!

6
pages/02.administer/15.admin_guide/15.command_line/command_line.es.md
View file

@ -41,11 +41,10 @@ Ahora te piden una contraseña. Si es un VPS, tu proveedor ya te hará comunicad
! Desde YunoHost 3.4, después de la post-instalación ya no es posible conectarse con el usuario `root`. En lugar de eso, hace falta **conectarse con el usuario `admin`**. Incluso si el servidor LDAP fuera quebrado (haciendo que el usuario `admin` ya no fuera utilizable) todavía deberías poder conectarte con el usuario `root` desde la red local.
#### ¡ Cambiar la contraseña root !
#### ¡ Cambiar la contraseña root
Después de haberte conectado por primera vez, tienes que cambiar la contraseña `root`. Tal vez el servidor te pida automáticamente que lo hagas. Si no es el caso, hay que utilizar el comando `passwd`. Es muy importante que elijas una contraseña bastante complicada. Nota que esta contraseña luego estará reemplazada por la contraseña admin elegida durante la post-instalación.
## En una instancia que ya está instalada
Si instalaste tu servidor en casa y que quieres conectarte desde fuera de la red local, asegúrate que hayas previamente redirigido el puerto 22 de tu router / caja hacia tu servidor (con el usuario `admin` !)
@ -77,16 +76,19 @@ ssh -p 2244 admin@tu.dominio.tld
Por defecto, sólo el usuario `admin` puede conectarse en SSH en una instancia YunoHost.
Los usuarios YunoHost creados vea la interfaz de administración están administrados por la base de datos LDAP. Por defecto, no pueden conectarse en SSH por razones de seguridad. Si necesitas absolutamente que uno de estos usuarios disponga de un acceso SSH, puedes utilizar el comando :
```bash
yunohost user permission add ssh.main <username>
```
Del mismo modo, es posible cancelar el acceso SSH de un usuario con el comando :
```bash
yunohost user permission remove ssh.main <username>
```
Finalmente, es posible añadir, suprimir y listar llaves SSH, para mejorar la seguridad del acceso SSH, con estos comandos :
```bash
yunohost user ssh add-key <username> <key>
yunohost user ssh remove-key <username> <key>

18
pages/02.administer/15.admin_guide/15.command_line/command_line.fr.md
View file

@ -18,6 +18,7 @@ page-toc:
L'interface en ligne de commande (CLI) est, en informatique, la manière originale (et plus technique) d'interagir avec un ordinateur, comparée aux interfaces graphiques. La ligne de commande est généralement considérée comme plus complète, puissante et efficace que les interfaces graphiques, bien que plus difficile à apprendre.
## Comment se connecter ?
### Identifiant à utiliser
[ui-tabs position="top-left" active="0" theme="lite"]
@ -38,9 +39,10 @@ Durant la post-installation, vous avez défini un mot de passe d'administration.
### Adresse à utiliser
Si vous hébergez votre serveur **à la maison** (par ex. Raspberry Pi ou OLinuXino ou vieil ordinateur)
- vous devriez pouvoir vous connecter à la machine en utilisant `yunohost.local` (ou `yunohost-2.local`, selon le nombre de serveurs sur le réseau).
- si `yunohost.local` et consorts ne fonctionnent pas, il vous faut [trouver l'IP locale de votre serveur](/finding_the_local_ip).
- si vous avez installé votre serveur à la maison mais essayez d'y accéder depuis l'extérieur du réseau local, assurez-vous d'avoir bien configuré une redirection de port pour le port 22.
- vous devriez pouvoir vous connecter à la machine en utilisant `yunohost.local` (ou `yunohost-2.local`, selon le nombre de serveurs sur le réseau).
- si `yunohost.local` et consorts ne fonctionnent pas, il vous faut [trouver l'IP locale de votre serveur](/finding_the_local_ip).
- si vous avez installé votre serveur à la maison mais essayez d'y accéder depuis l'extérieur du réseau local, assurez-vous d'avoir bien configuré une redirection de port pour le port 22.
S'il s'agit d'une machine distante (VPS), votre fournisseur devrait vous avoir communiqué l'IP de votre machine.
@ -87,6 +89,7 @@ Si vous souhaitez ajouter une clé publique SSH à l'utilisateur, vous devez le
[/ui-tab]
[ui-tab title="À partir de la ligne de commande"]
Pour autoriser un utilisateur ou un groupe à accéder en SFTP ou en SSH :
```bash
# SFTP
yunohost user permission add sftp <username>
@ -95,6 +98,7 @@ yunohost user permission add ssh <username>
```
Pour enlever la permission :
```bash
# SFTP
yunohost user permission remove sftp <username>
@ -103,11 +107,13 @@ yunohost user permission remove ssh <username>
```
Enfin, il est possible d'ajouter, de supprimer et de lister des clés SSH, pour améliorer la sécurité de l'accès SSH, avec les commandes :
```bash
yunohost user ssh add-key <username> <key>
yunohost user ssh remove-key <username> <key>
yunohost user ssh list-keys <username>
```
[/ui-tab]
[/ui-tabs]
@ -143,25 +149,31 @@ yunohost user create --help
vont successivement lister toutes les catégories disponibles, puis les actions de la catégorie `user`, puis expliquer comment utiliser l'action `user create`. Vous devriez remarquer que l'arbre des commandes YunoHost suit une structure similaire aux pages de la webadmin.
### La commande `yunopaste`
Cette commande est utile lorsque vous voulez communiquer à une autre personne le retour d'une commande.
Exemple :
```bash
yunohost tools diagnosis | yunopaste
```
### Quelques commandes utiles
Si votre interface web d'administration indique que l'API est injoignable, essayez de démarrer `yunohost-api` :
```bash
systemctl start yunohost-api
```
Si vous ne parvenez plus à vous connecter avec l'utilisateur `admin` via SSH et via l'interface web, le service `slapd` est peut-être éteint, essayez de le redémarrer :
```bash
systemctl restart slapd
```
Si vous avez des configurations modifiées manuellement et souhaitez connaître les modifications :
```bash
yunohost tools regen-conf --with-diff --dry-run
```

1
pages/02.administer/15.admin_guide/15.command_line/command_line.it.md
View file

@ -22,6 +22,7 @@ page-toc:
Se stai installando su un VPS allora il provider dovrebbe averti indicato il tuo indirizzo IP.
Se stai installando su un computer casalingo (ad esempio un Raspberry Pi o un OLinuXino) devi individuare l'indirizzo IP che è stato attribuito al computer dopo averlo collegato al router. Questi sono alcuni sistemi:
- avvia un terminale e dai il comando `sudo arp-scan --local` per elencare gli indirizzi IP sulla rete locale;
- usa l'interfaccia del router per vedere la lista dei computer collegati o controllane i log;
- collega un monitor al tuo server YunoHost, fai login e digita `hostname --all-ip-address`.

19
pages/02.administer/15.admin_guide/15.command_line/command_line.md
View file

@ -18,8 +18,8 @@ page-toc:
The command line interface (CLI) is, in the computer world, the original (and more technical) way of interacting with a computer compared to graphical interface. Command line interfaces are generally said to be more complete, powerful or efficient than a graphical interface, though also more difficult to learn.
## How to connect
### Login credentials
### Login credentials
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="Before running the initial configuration (post-installation)"]
@ -39,16 +39,15 @@ During the postinstall, you've been asked to choose an administration password.
### Address to use
If you are **installing at home** (e.g. on a Raspberry Pi or OLinuXino or old computer):
- you should be able to connect to your server using `yunohost.local` (or `yunohost-2.local`, depending on how many servers are on your network).
- if `yunohost.local` and the like do not work, your need to [find out the local IP of the server](/finding_the_local_ip).
- if you installed a server at home but are attempting to connect from outside your local network, make sure port 22 is correctly forwarded to your server.
- you should be able to connect to your server using `yunohost.local` (or `yunohost-2.local`, depending on how many servers are on your network).
- if `yunohost.local` and the like do not work, your need to [find out the local IP of the server](/finding_the_local_ip).
- if you installed a server at home but are attempting to connect from outside your local network, make sure port 22 is correctly forwarded to your server.
If your server is a remote server (VPS), your provider should have communicated you the IP address of the machine
In any cases, if you already configured a domain name pointing to the appropriate IP, it's much better to use `yourdomain.tld` instead of the IP address.
### Connecting
The SSH command typically looks like:
@ -90,6 +89,7 @@ If you want to add an SSH public key to the user, you have to do it from the com
[/ui-tab]
[ui-tab title="From the command line"]
To allow a user or group to access via SFTP or SSH:
```bash
# SFTP
yunohost user permission add sftp <username>
@ -98,6 +98,7 @@ yunohost user permission add ssh <username>
```
To remove permission:
```bash
# SFTP
yunohost user permission remove sftp <username>
@ -106,15 +107,16 @@ yunohost user permission remove ssh <username>
```
Finally, it is possible to add, delete and list SSH keys, to improve SSH access security, using the commands:
```bash
yunohost user ssh add-key <username> <key>
yunohost user ssh remove-key <username> <key>
yunohost user ssh list-keys <username>
```
[/ui-tab]
[/ui-tabs]
## Security and SSH
A more extensive discussion about security & SSH can be found on the [dedicated page](/security).
@ -147,9 +149,11 @@ yunohost user create --help
will successively list all the categories available, then the actions available in the `user` category, then the usage of the action `user create`. You might notice that the YunoHost command tree is built with a structure similar to the YunoHost admin pages.
### The `yunopaste` command
This command allow you to share with an other person the output of a command.
Example:
```bash
yunohost tools diagnosis | yunopaste
```
@ -165,16 +169,19 @@ ynh-vpnclient-loadcubefile.sh -u <username> -p <password> -c <path>.cube
### Some useful commands
If your administration web interface indicates that the API is unreachable, try starting `yunohost-api`:
```bash
systemctl start yunohost-api
```
If you can no longer connect with the user `admin` via SSH and via the web interface, the `slapd` service may be down, try restarting it:
```bash
systemctl restart slapd
```
If you have manually modified configurations and want to know the changes:
```bash
yunohost tools regen-conf --with-diff --dry-run
```

32
pages/02.administer/15.admin_guide/20.users/05.groups_and_permissions/groups_and_permissions.fr.md
View file

@ -19,17 +19,18 @@ L'utilisation de groupes est cependant utile pour la sémantique, par exemple si
Il est également possible de définir des alias mail pour un groupe, afin que les mails envoyés à `groupe@domain.tld` soient redirigés vers tous les membres du groupe.
### Groupes par défaut
Par défaut, deux groupes spéciaux sont créés :
- `all_users`, qui contient tous les utilisateurs enregistrés sur YunoHost,
- `visitors`, c'est-à-dire les personnes qui consultent le serveur sans être connectées.
- `admins`, apparut depuis Yunohost 11.1, ce groupe permet de gérer les administrateurs de la machine, chaque utilisateur aura alors (selon la configuration du serveur) accès en SSH ainsi que la webadmin.
Vous ne pouvez pas changer le contenu de ces groupes, seulement les permissions qui leur sont accordées.
### Lister les groupes existants
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="À partir de l'interface web"]
Les groupes existants sont listés en haut de la page *groupes et autorisations*.
@ -40,7 +41,6 @@ Les groupes existants sont listés en haut de la page *groupes et autorisations*
[ui-tab title="À partir de la ligne de commande"]
Pour obtenir la liste des groupes existants en ligne de commande :
```shell
$ yunohost user group list
groups:
@ -51,10 +51,12 @@ groups:
- charlie
- delphine
```
[/ui-tab]
[/ui-tabs]
### Créer un nouveau groupe
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="À partir de l'interface web"]
Pour créer un nouveau groupe, il suffit de cliquer sur le bouton "Nouveau groupe" en haut de la page. Vous ne pouvez choisir qu'un nom formé de lettres (majuscules et minuscules) et d'espaces. Le groupe est créé vide et sans aucune permission.
@ -66,12 +68,14 @@ Pour créer un nouveau groupe, il suffit de cliquer sur le bouton "Nouveau group
Dans la ligne de commande, pour créer un nouveau groupe appelé `yolo_crew`, il faut utiliser
```shell
$ yunohost user group create yolo_crew
yunohost user group create yolo_crew
```
[/ui-tab]
[/ui-tabs]
### Mettre à jour un groupe
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="À partir de l'interface web"]
Ajoutons un premier utilisateur à ce groupe : dans le panneau du groupe, cliquez sur le bouton "Ajouter un utilisateur" et faites défiler jusqu'à l'utilisateur souhaité, puis cliquez dessus.
@ -87,7 +91,7 @@ Pour supprimer un utilisateur, cliquez sur la croix à côté de son nom d'utili
En ligne de commande, utilisez la commande suivante pour ajouter `charlie` et `delphine` au groupe `yolo_crew` :
```shell
$ yunohost user group add yolo_crew charlie delphine
yunohost user group add yolo_crew charlie delphine
```
(De même, `remove` peut être utilisé pour retirer des membres d'un groupe.)
@ -108,6 +112,7 @@ groups:
- charlie
- delphine
```
[/ui-tab]
[/ui-tabs]
@ -125,8 +130,9 @@ Pour supprimer un groupe, cliquez sur la croix rouge en haut à droite du pannea
Pour supprimer le groupe `yolo_crew` en ligne de commande, vous pouvez exécuter :
```shell
$ yunohost user group delete yolo_crew
yunohost user group delete yolo_crew
```
[/ui-tab]
[/ui-tabs]
@ -145,6 +151,7 @@ La page des groupes liste les permissions données à chaque groupe, y compris l
[/ui-tab]
[ui-tab title="À partir de la ligne de commande"]
Pour répertorier les permissions et les accès correspondants en ligne de commande :
```shell
$ yunohost user permission list
permissions:
@ -157,6 +164,7 @@ permissions:
xmpp.main:
allowed: all_users
```
Ici, nous constatons que tous les utilisateurs enregistrés peuvent utiliser le mail, XMPP, et accéder au blog WordPress. Cependant, personne ne peut accéder à l'interface d'administration de WordPress.
Plus de détails peuvent être affichés en ajoutant l'option `--full` qui affichera la liste des utilisateurs correspondant aux groupes autorisés, ainsi que les adresses web associées à une permission (pertinent pour les applications web).
@ -182,13 +190,13 @@ Notez que, par exemple, si nous voulons restreindre la permission pour le mail a
Pour permettre à un groupe d'accéder à l'interface d'administration de WordPress via la ligne de commande :
```shell
$ yunohost user permission update wordpress.admin --add yolo_crew
yunohost user permission update wordpress.admin --add yolo_crew
```
Vous pouvez également autoriser un seul utilisateur :
```shell
$ yunohost user permission update wordpress.admin --add alice
yunohost user permission update wordpress.admin --add alice
```
Et maintenant, nous pouvons voir que YoloCrew et Alice ont tous deux accès à l'interface d'administration de WordPress :
@ -206,7 +214,7 @@ $ yunohost user permission list
Pour permettre seulement à Bob d'accéder aux emails en ligne de commande :
```shell
$ yunohost user permission update mail --remove all_users --add bob
yunohost user permission update mail --remove all_users --add bob
```
[/ui-tab]
@ -235,11 +243,12 @@ En ligne de commande, le même genre de chose peut être fait avec :
# Activer la tuile pour l'interface d'admin de WordPress
$ yunohost user permission update wordpress.admin --show_tile True
```
[/ui-tab]
[/ui-tabs]
### Gérer les alias des groupes
Chaque groupe peut utiliser des alias de mail, bien que leur configuration se fasse actuellement uniquement depuis la CLI. Par défaut, le groupe `admins` dispose ainsi de `admins@domain.tld`, `root@domain.tld` ... : les messages envoyés à ces adresses sont redirigés vers tous les membres du groupe `admins`.
L'utilisation de la commande `yunohost user group info` permet de lister tous les alias pour le groupe renseigné.
@ -258,6 +267,7 @@ $ yunohost user group info admins
```
Il est possible de les ajouter avec l'action `add-mailalias` ou de les enlever avec `remove-mailalias`.
```shell
$ yunohost user group add-mailalias <groupe> <adresse@domaine.tld>
yunohost user group add-mailalias <groupe> <adresse@domaine.tld>
```

25
pages/02.administer/15.admin_guide/20.users/05.groups_and_permissions/groups_and_permissions.md
View file

@ -20,10 +20,10 @@ Using groups is however useful for semantics, for example if you host multiple g
It's also possible to define mail aliases for a group, such that mails sent to `groupe@domain.tld` will be dispatched to all members of the group.
### Default groups
By default, two special groups are created:
- `all_users`, that contain all users registered on YunoHost,
- `visitors`, that applies to people viewing the server while not logged in.
@ -52,6 +52,7 @@ groups:
- charlie
- delphine
```
[/ui-tab]
[/ui-tabs]
@ -68,8 +69,9 @@ To create a new group, simply click on the "New Group" button at the top of the
In CLI, to create a new group called `yolo_crew`
```shell
$ yunohost user group create yolo_crew
yunohost user group create yolo_crew
```
[/ui-tab]
[/ui-tabs]
@ -90,7 +92,7 @@ To remove a user, click on the cross next to their username, in the group panel.
In CLI, use the following command to add `charlie` and `delphine`to the `yolo_crew` group:
```shell
$ yunohost user group add yolo_crew charlie delphine
yunohost user group add yolo_crew charlie delphine
```
(similarly, `remove` can be used to remove members from a group)
@ -111,6 +113,7 @@ groups:
- charlie
- delphine
```
[/ui-tab]
[/ui-tabs]
@ -127,8 +130,9 @@ To delete a group, click on the red cross on the top right of the group panel. Y
To delete the group `yolo_crew` in CLI, you may run
```shell
$ yunohost user group delete yolo_crew
yunohost user group delete yolo_crew
```
[/ui-tab]
[/ui-tabs]
@ -184,13 +188,13 @@ Note that you can also allow a single user, by using the specific panel at the b
To allow a group to access the WordPress admin interface in CLI:
```shell
$ yunohost user permission update wordpress.admin --add yolo_crew
yunohost user permission update wordpress.admin --add yolo_crew
```
Note that you can also allow a single user, by using the specific panel at the bottom of the page.
```shell
$ yunohost user permission update wordpress.admin --add alice
yunohost user permission update wordpress.admin --add alice
```
And now we may see that both the YoloCrew and Alice have access to the WordPress admin interface:
@ -208,8 +212,9 @@ $ yunohost user permission list
Note that, for example, if we want to restrict permission for email so that only Bob is allowed to email, we should also remove `all_users` from the permission, by deleting it from the `all_users` group panel, or in CLI:
```shell
$ yunohost user permission update mail --remove all_users --add bob
yunohost user permission update mail --remove all_users --add bob
```
[/ui-tab]
[/ui-tabs]
@ -235,11 +240,12 @@ In command line, this may be done with:
# Enable the tile for the WordPress admin interface
$ yunohost user permission update wordpress.admin --show_tile True
```
[/ui-tab]
[/ui-tabs]
### Config alias group
Each group can use mail aliases, but their configuration is only available from the CLI so far. For example, the `admins` group is configured with aliases such as `admins@domain.tld`, `root@domain.tld` ... : mail sent to these addresses will be dispatched to all members of the `admins` group.
The command `yunohost user group info` will list them.
@ -258,6 +264,7 @@ $ yunohost user group info admins
```
To add a new mail, use the action `add-mailalias` or `remove-mailalias` to delete it.
```shell
$ yunohost user group add-mailalias <group> <address@domaine.tld>
yunohost user group add-mailalias <group> <address@domaine.tld>
```

1
pages/02.administer/15.admin_guide/20.users/users.fr.md
View file

@ -34,4 +34,3 @@ Voir [cette page de documentation dédiée](/groups_and_permissions).
## Accès SSH
Voir [cette page de documentation dédiée](/ssh).

2
pages/02.administer/15.admin_guide/25.domains/01.certificate/certificate.de.md
View file

@ -91,5 +91,3 @@ manschmal die Einstellungen verweigern. In diesem Fall ist es notwendig :
- die Parameter `127.0.0.1 Ihre.domain.tld` auf der Datei `/etc/hosts` des Webserver hinzufügen.
Wenn es immer noch nicht funktionsfähig ist, also die Überprüfungen deaktivieren mit `--no-checks` nach dem Befehl `cert-install`.

1
pages/02.administer/15.admin_guide/25.domains/01.certificate/certificate.it.md
View file

@ -35,7 +35,6 @@ Recatevi nella sezione 'Domini' dell'interfaccia di amministrazione, scegliete l
![](image://domain-certificate-button.png)
Nella sezione 'Certificati SSL' potere visualizzare lo stato attuale del
certificato. Se avete appena creato il dominio, esso disporrà di un certificato
auto firmato.

1
pages/02.administer/15.admin_guide/25.domains/01.certificate/certificate.md
View file

@ -83,4 +83,3 @@ If YunoHost thinks that your domain is badly configured despite the fact that yo
- add a line `127.0.0.1 your.domain.tld` to the file `/etc/hosts` on your server;
- if the certificate installation still doesn't work, you can disable the checks with `--no-checks` after the `cert-install` command.

7
pages/02.administer/15.admin_guide/25.domains/domains.it.md
View file

@ -49,10 +49,3 @@ YunoHost può generare una configurazione DNS raccomandata per ogni dominio che
## Certificati SSL/HTTPS
Un altro importante aspetto della configurazione dei domini è quello riguardante il certificato SSL/HTTPS. YuhoHost integra Let's Encrypt, potete installare il certificato e impostare il rinnovo automatico. La documentazione relativa e altre informazioni si trovano alla pagina [certificati](/certificate).

10
pages/02.administer/15.admin_guide/25.domains/domains.md
View file

@ -26,6 +26,7 @@ Domains can be managed in the 'Domain' section of the webadmin, or through the `
In order to make self-hosting as accessible as possible, the YunoHost Project provides a *free* and *automatically configured* domain name service. By using this service, you won't have to [configure DNS records](/dns_config) yourself, which can be tedious and technical.
The following (sub)domains are offered:
- `whateveryouwant.nohost.me`;
- `whateveryouwant.noho.st`;
- `whateveryouwant.ynh.fr`.
@ -46,8 +47,8 @@ To get one of this domain you simply need to choose `I don't have a domaine name
[ui-tab title="Your own domains"]
Having your own domain brings several advantages:
* more control and autonomy
* simpler domain name (for example directly in .net or .org)
- more control and autonomy
- simpler domain name (for example directly in .net or .org)
However, you have to pay for it each year (about 15€/year) and you have to do some extra configuration to [setup a correct DNS zone](/dns_config). Our diagnosis tool can trigger alert to help you to do this configuration.
@ -55,10 +56,8 @@ If you already have your own domain, you can simply click "I already have a doma
![Here a screenshot of the "Add domain" page where you can choose "I already have a domain name"](image://webadmin_domain_owndomain.png)
[Know more on DNS zone configuration](/dns_config)
[/ui-tab]
[ui-tab title="Local domains (only reachable in your local network)"]
@ -80,11 +79,11 @@ The number may change depending on which server starts first, so do not rely on
! Unfortunately, Android devices before version 12 (released in 2021) do not seem to be listening to mDNS protocol.
! To be able to reach `.local` domains on your Android devices, you will have to add in their DNS settings your YunoHost server's local IP address.
[/ui-tab]
[/ui-tabs]
## The main domain
The domain chosen during the initial configuration (post-install) is defined as the main (or default) domain of the server : this is where [the user portal (SSO)](/users) will be available. The main domain can later be changed through the web admin in Domains > (the domain) > Set default, or with the command line `yunohost tools maindomain`.
More technically, the main domain is also used as hostname by SMTP protocol to send email (EHLO) and determine which value should be configured in the reverse DNS bind to your public IP. If this 2 values are mis-configured, the diagnosis tool will trigger you an alert.
@ -98,7 +97,6 @@ More technically, the main domain is also used as hostname by SMTP protocol to s
If your domain has special, non-latin characters, it will be transformed by YunoHost into its [internationalized version](https://en.wikipedia.org/wiki/Internationalized_domain_name) through [Punycode](https://en.wikipedia.org/wiki/Punycode). So when you use the command line, you have to use the punycode format return for example by `yunohost domain list`.
## SSL/HTTPS certificates
Another important aspect of domain configuration is the SSL/HTTPS certificate. YunoHost is integrated with Let's Encrypt, so once your server is correctly reachable from anybody on the internet through the domain name, the administrator can request a Let's Encrypt certificate. See the documentation about [certificates](/certificate) for more information.

1
pages/02.administer/15.admin_guide/30.apps/apps.fr.md
View file

@ -47,6 +47,7 @@ L'accès aux applications peut être limité à certains utilisateurs seulement.
À partir de YunoHost v11.1.21.4, si vous avez besoin d'exécuter des commandes avec le binaire de l'application, ou des commandes PHP, etc., vous pouvez exécuter la commande `yunohost app shell <app>`.
Cela aura pour effet de :
- ouvrir un nouveau shell Bash en tant qu'utilisateur système de l'application
- ouvrir le répertoire de travail de l'application (par exemple `/var/www/<app>`)
- précharger l'environnement avec des variables provenant du service de l'application, s'il existe

15
pages/02.administer/15.admin_guide/30.apps/apps.it.md
View file

@ -21,7 +21,6 @@ Le applicazioni possono essere installate e gestite tramite l'interfaccia di amm
<center><a href="/apps" style="background: orange; border-color: orange;" class="btn btn-lg btn-error"><i class="fa fa-cubes"></i>Lista applicazioni</a></center>
! Siate ragionevoli sul numero di programmi che installate. Ogni programma aumenta le possibilità
di errori e attacchi dall'esterno. È preferibile, se desiderate effettuare dei test, utilizzare una [macchina virtuale](https://yunohost.org/en/install/hardware:virtualbox) con un'altra istanza.
@ -72,7 +71,6 @@ rss.yolo.com : TinyTiny RSS (a RSS reader)
wiki.yolo.com : DokuWiki (a wiki)
```
!!! Molte applicazioni integrano una caratteristica che permette di cambiare l'URL dell'applicazione. La scelta fra sotto-directory e sotto-dominio in alcuni casi può essere cambiata con una semplice modifica nell'interfaccia di amministrazione.
### Gestione accessi utente e applicazioni pubbliche
@ -141,7 +139,7 @@ Alcune applicazioni includono un *pannello di configurazione* che contiene azion
Dalla riga di comando è possibile elencare le impostazione del pannello di configurazione con il comando `yunohost app config get <app>`
```
```bash
$ yunohost app config get my_webapp
main.php_fpm_config.phpversion:
ask: PHP version
@ -165,10 +163,11 @@ La parola `<key>` è il nome dell'impostazione come nell'esempio sopra `main.sft
Dalla versione di YunoHost v11.1.21.4 è possibile eseguire un comando con il binario dell'applicazione o comandi PHP con il comando `yunohost app shell <app>`.
In questo modo:
- verrà avviata una shell Bash come l'utente di sistema dell'applicazione
- verrà aperta la directory di lavoro dell'applicazione (ad esempio `/var/www/<app>`)
- carico di tutte le variabili d'ambiente come da file service dell'applicazione se queste esistono
- verrà il usata la versione di `php` usata dall'applicazione
* verrà avviata una shell Bash come l'utente di sistema dell'applicazione
* verrà aperta la directory di lavoro dell'applicazione (ad esempio `/var/www/<app>`)
* carico di tutte le variabili d'ambiente come da file service dell'applicazione se queste esistono
* verrà il usata la versione di `php` usata dall'applicazione
## Packaging delle applicazioni
@ -180,6 +179,4 @@ Test automatici sono regolarmente eseguiti per controllare l'integrazione e la q
Alcuni risultati sono disponibili su [questa pagina](https://dash.yunohost.org/appci/branch/stable).
Solo i programmi con una qualità sufficiente sono inseriti nell'elenco delle applicazioni installabili. Nel caso i test dovessero segnalare una diminuzione dell'indice di qualità, gli aggiornamenti saranno sospesi e le nuove installazioni non saranno possibili fino alla soluzione del problema che ha causato l'abbassamento dell'indice.

14
pages/02.administer/15.admin_guide/30.apps/apps.md
View file

@ -21,10 +21,8 @@ The application catalog and its categories can be browsed directly from the weba
<center><a href="/apps" style="background: orange; border-color: orange;" class="btn btn-lg btn-error"><i class="fa fa-cubes"></i> Applications catalog</a></center>
! Be careful and stay reasonable on the number of installed applications. Each additional installation increases the attack surface and the risk of failure. Ideally, if you want to test, do it with another instance for example in [a virtual machine](/install/hardware:virtualbox).
## Installing an app
Let's say you want to install a *Custom Webapp*. Before actually running the installation steps, YunoHost will usually have you fill in a form to properly set it up for you.
@ -137,7 +135,7 @@ The configuration panels are accessible in the webadmin in their operations page
From the command line, you can list the configuration panel settings with the following command: `yunohost app config get <app>`
```
```bash
$ yunohost app config get my_webapp
main.php_fpm_config.phpversion:
ask: PHP version
@ -161,10 +159,11 @@ The `<key>` is the setting name, for example `main.sftp.with_sftp` from above.
Starting YunoHost v11.1.21.4, if you need to execute commands with the app's binary, or PHP commands, etc., you can execute the command `yunohost app shell <app>`.
It will:
- open a new Bash shell as the app's system user
- open the app's working directory (e.g. `/var/www/<app>`)
- preload the environment with variables taken from the app's service, if it exists
- override `php`, so that it points to the PHP version used by the app
* open a new Bash shell as the app's system user
* open the app's working directory (e.g. `/var/www/<app>`)
* preload the environment with variables taken from the app's service, if it exists
* override `php`, so that it points to the PHP version used by the app
## Applications packaging
@ -177,4 +176,3 @@ If you want to learn or contribute to app packaging, please check the [contribut
Automated tests are being run regularly to test the integration and quality of all apps who were declared to be `working` by packagers. The result is a level between 0 and 8, whose meaning is detailed on [this page](/packaging_apps_levels). Some tests results may also be available [on this dashboard](https://dash.yunohost.org/appci/branch/stable).
By default, only applications of sufficient quality are offered. When the quality of an application drops and until the problem is reolved, the app is hidden from the catalog to prevent its installation and its upgrades are put on hold.

2
pages/02.administer/15.admin_guide/35.nginx/nginx.md
View file

@ -16,9 +16,7 @@ Most of the web applications installed with YunoHost will automatically have the
Generally, you should refrain from manually tinkering and installing apps, except if you are sure they will not interfere with your server. YunoHost proposes two generic apps to help you out:
- If you already have a website ready to be deployed, consider using a **Custom Webapp**. It allows you to easily setup a directory into which you can upload your HTML, PHP, CSS, JS files with SFTP, and a database if needed.
- If you want to use YunoHost as a reverse proxy, i.e. serve an app from another server or an internal web server (think NodeJS, Ruby, Python, ...), you can use the **Redirect app** in proxy mode.
- The **Redirect app** can also simply run in redirect mode, for example to create shortcuts for your users in their SSO page, or redirect `www.yourdomain.tld` to `yourdomain.tld`.
For more information on these apps, and for more application use cases, have a look to the [Tutorials](/tutorials) section.

1
pages/02.administer/15.admin_guide/45.emails/email.de.md
View file

@ -47,4 +47,3 @@ Es ist möglich, dass die von Ihrer YunoHost-Instanz gesendeten E-Mails von den
## Eine Migration von E-Mails von einem E-Mail-Provider zu einer YunoHost-Instanz
Siehe [diese Seite](https://yunohost.org/#/email_migration).

1
pages/02.administer/15.admin_guide/45.emails/email.es.md
View file

@ -16,6 +16,7 @@ Este ecosistema comprende un servidor SMTP (postfix), un servidor IMAP (Dovecot)
Los emails son un ecosistema complicado y una multitud de detalles puedes impedir que funcionen correctamente.
Para validar que tu configuración es correcta :
- si te alojas en casa y que no tienes VPN, asegúrate de que [tu proveedor de Internet no esté bloqueando el puerto 25](/isp) ;
- redirige los puertos siguiendo [esta documentación](/isp_box_config) ;
- configura con cuidado los registros DNS del correo electrónico siguiendo [esta documentación](/dns_config) ;

1
pages/02.administer/15.admin_guide/45.emails/email.fr.md
View file

@ -16,6 +16,7 @@ Cet écosystème comprend un serveur SMTP (postfix), un serveur IMAP (Dovecot),
Les emails sont un écosystème compliqué et un grand nombre de détails peuvent les empêcher de fonctionner correctement.
Pour valider que votre configuration est correcte :
- si vous vous hébergez chez vous et n'utilisez pas de VPN, assurez-vous que [votre FAI ne bloque pas le port 25](/isp) ;
- routez les ports selon [cette documentation](/isp_box_config) ;
- configurez soigneusement les enregistrements DNS du courrier électronique selon [cette documentation](/dns_config) ;

2
pages/02.administer/15.admin_guide/45.emails/email.md
View file

@ -16,6 +16,7 @@ The mail stack includes a SMTP server (postfix), an IMAP server (Dovecot), an an
Email is a complicated ecosystem and quite a few details can prevent it from working properly.
To validate your setup:
- if you are self-hosting at home and not using a VPN, ensure [your ISP won't block port 25](/isp) ;
- route ports according to [this documentation](/isp_box_config) ;
- carefully configure mail DNS records according to [this documentation](/dns_config) ;
@ -40,6 +41,7 @@ Groups also can use alias features, by default the group `admins` have `root@<do
If your server becomes unavailable, emails sent to your server will stay in a pending queue on the sender's side for as long as ~5 days. The sender's host will regularly try to resend the email, until it drops it if it was unable to send it.
## Forms to remove its IP address from the blacklist
It is possible that the emails sent from your YunoHost instance are considered as spam by the big email services.
Is it possible that the IP address from your server have been previously been used to sent spam or that these email services consider your server as a spam sender.
To ensure that your servers’ IP address isn't on these blacklists and to remove it from them, follow this [link](/blacklist_forms).

32
pages/02.administer/15.admin_guide/50.backups/backup.fr.md
View file

@ -29,7 +29,6 @@ La méthode de sauvegarde actuelle consiste à créer des archives `.tar` qui co
Vous pouvez facilement créer des archives depuis la webadmin en allant dans `Sauvegardes > Archives locales` et en cliquant sur `Nouvelle sauvegarde`. Vous pourrez ensuite sélectionner les éléments à sauvegarder (configuration, données "système", applications).
![Image de l'écran de sauvegarde de YunoHost dans la webadmin](image://backup.png)
[/ui-tab]
@ -38,26 +37,31 @@ Vous pouvez facilement créer des archives depuis la webadmin en allant dans `Sa
Vous pouvez créer de nouvelles archives depuis la ligne de commande. Voici quelques exemples de commandes et leur comportement correspondant :
- Tout sauvegarder (système et apps) :
```bash
yunohost backup create
```
- Sauvegarder seulement les apps :
```bash
yunohost backup create --apps
```
- Sauvegarder seulement deux apps (WordPress et Shaarli) :
```bash
yunohost backup create --apps wordpress shaarli
```
- Sauvegarder seulement les mails :
```bash
yunohost backup create --system data_mail
```
- Sauvegarder les mails et WordPress :
```bash
yunohost backup create --system data_mail --apps wordpress
```
@ -68,6 +72,7 @@ Pour plus d'informations et d'options sur la création d'archives, consultez `yu
[/ui-tabs]
#### Télécharger la sauvegarde
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="À partir de l'interface web"]
Après avoir créé des sauvegardes, il est possible de les lister et de les inspecter grâce aux vues correspondantes dans l'interface d'administration web. Un bouton propose de télécharger l'archive. Si l'archive fait plus de 3Go, il peut être préférable de procéder via SFTP.
@ -101,14 +106,12 @@ scp -P port_ssh admin@votre.domaine.tld:/home/yunohost.backup/archives/<nom_darc
! N'oubliez pas de stocker votre sauvegarde dans un lieu différents de celui ou se trouve votre serveur.
!!! Si vous le souhaitez, vous pouvez connecter un disque externe à votre serveur pour que les archives arrivent directement dessus. Voir ce guide pour [Ajouter un stockage externe à son serveur](/external_storage)
### Tester
Vous devriez tester régulièrement vos sauvegardes à minima en listant le contenu des archives et en vérifiant le poids des données associées. Le mieux est de s'entrainer règulièrement à restaurer.
```bash
# Lister les fichiers
tar -tvf /home/yunohost.backup/archives/ARCHIVE.tar | less
@ -123,6 +126,7 @@ ls -lh /home/yunohost.backup/archives/ARCHIVE.tar
### Restaurer
!!! SPOILER: Plus votre volume de données et le nombre d'applications sont important, plus votre restauration sera complexe.
#### Cas simple : peu de données, archive déjà présente
[ui-tabs position="top-left" active="0" theme="lite"]
@ -132,7 +136,6 @@ Allez dans `Sauvegardes > Archives locales` et sélectionnez l'archive. Vous pou
![](image://restore.png)
[/ui-tab]
[ui-tab title="À partir de la ligne de commande"]
@ -147,6 +150,7 @@ Vous pouvez ensuite exécuter `yunohost backup restore <archivename>` (donc sans
Pour restaurer une application, le domaine sur laquelle elle est installée doit déjà être configuré (ou il vous faut restaurer en même temps la configuration correspondante). Aussi, il n'est pas possible de restaurer une application déjà installée... ce qui veut dire que pour restaurer une sauvegarde d'une app, il vous faut déjà la désinstaller.
#### Téléverser une archive
Dans de nombreux cas, l'archive n'est pas sur le serveur sur lequel on souhaite la restaurer. Il faut donc la téléverser, ce qui selon son poids peut prend plus ou moins de temps.
[ui-tabs position="top-left" active="0" theme="lite"]
@ -175,15 +179,15 @@ scp -P port_ssh /path/to/your/<nom_d'archive>.tar admin@your.domain.tld:/home/yu
Il existe 3 applications YunoHost qui proposent d'étendre YunoHost avec une méthode de sauvegarde automatisées.
* [BorgBackup](/backup/borgbackup)
* [Restic](/backup/restic)
* [Archivist](/backup/archivist)
- [BorgBackup](/backup/borgbackup)
- [Restic](/backup/restic)
- [Archivist](/backup/archivist)
## Aller plus loin
* [Évaluer la qualité de sa sauvegarde](/backup/strategies)
* [Cloner son système de fichier](/backup/clone_filesystem)
* [Éviter une panne matérielle](/backup/avoid_hardware_failure)
* [Inclure/exclure des fichiers](/backup/include_exclude_files)
* [Méthodes personnalisées](/backup/custom_backup_methods)
* [Migrer ou fusionner des serveurs](/backup/migrate_or_merge_servers)
- [Évaluer la qualité de sa sauvegarde](/backup/strategies)
- [Cloner son système de fichier](/backup/clone_filesystem)
- [Éviter une panne matérielle](/backup/avoid_hardware_failure)
- [Inclure/exclure des fichiers](/backup/include_exclude_files)
- [Méthodes personnalisées](/backup/custom_backup_methods)
- [Migrer ou fusionner des serveurs](/backup/migrate_or_merge_servers)

12
pages/02.administer/15.admin_guide/50.backups/backup.it.md
View file

@ -29,7 +29,6 @@ Potete creare gli archivi di backup dalla pagina web di amministrazione andando
Potete fare un nuovo archivio di backup dalla riga di comando. Questi sono alcuni esempi di comandi e i relativi risultati:
- Esecuzione di un backup completo (tutti i componenti del sistema e delle app):
```bash
@ -62,7 +61,6 @@ Potete fare un nuovo archivio di backup dalla riga di comando. Questi sono alcun
Per maggiori informazioni e opzioni sulla creazione di backup leggete `yunohost backup create --help`. Potrete anche elencare le parti del sistema delle quali si può farne il backup con `yunohost hook list backup`.
### Configurazioni specifiche per le app
Alcune app come ad esempio Nextcloud possono contenere grandi quantità di dati. È possibile in questi casi eseguire il backup dell'app senza i dati degli utenti, modalità che viene indicata come "backing up only the core" (delle app).
@ -70,7 +68,6 @@ Eseguendo un aggiornamento, delle app con grandi quantità di dati normalmente v
Per disabilitare esplicitamente il backup di grandi quantità di dati, per le applicazioni che implementano questa possibilità, dovete impostare la variabile `BACKUP_CORE_ONLY` prima di eseguire il comando di backup: `sudo BACKUP_CORE_ONLY=1 yunohost backup create --apps nextcloud`. Fate attenzione però perché dovrete fare il backup di questi dati autonomamente: è possibile eseguire questi backup, di tipo incrementale o differenziale, opzione che però non è ancora provvista da YunoHost.
## Download e upload dei backup
Dopo aver creato gli archivi di backup è possibile elencarli e ispezionarli sia dalla pagina web di amministrazione relativa sia dalla riga di comando con i comandi `yunohost backup list` e `yunohost backup info <archivename>`. Di default i backup sono copiati nella directory `/home/yunohost.backup/archives/`.
@ -79,7 +76,6 @@ Attualmente il modo più semplice per scaricare gli archivi è usando il program
Una soluzione alternativa è quella di installare Nextcloud o un'applicazione simile e configurarle per accedere ai file contenuti in `/home/yunohost.backup/archives/` da un browser.
Un'altra soluzione è quella di usare `scp` (un programma che si basa su [`ssh`](/ssh)) per copiare i file fra due computer usando la riga di comando. In questo modo usando un computer con GNU/Linux potete copiare uno specifico backup con questo comando:
```bash
@ -110,31 +106,26 @@ scp -P porta_ssh /path/to/your/<archivename>.tar admin@your.domain.tld:/home/yun
Dovete andare in Backup > Archivi locali e selezionare il vostro archivio. È possibile selezionare ciò che volete ripristinare e poi cliccare su 'Ripristina'.
![picture of YunoHost's restore pannel](image://restore.png)
### Dalla riga di comando
Dalla riga di comando date il comando `yunohost backup restore <archivename>` (senza il `.tar.gz`) per ripristinare un archivio. Così come `yunohost backup create`, questo comando ripristinerà di default tutto il contenuto dell'archivio; se invece volete ripristinare solo alcuni file potete usare ad esempio il comando `yunohost backup restore --apps wordpress` per ripristinare esclusivamente wordpress.
### Limiti
Per ripristinare una app, il dominio sul quale era stata installata dovrà essere già stato configurato oppure dovrete avere già ripristinato la configurazione di sistema relativa. Inoltre non è possibile ripristinare una app che è già installata ... il che comporta che se volete ripristinare una versione passata della app dovrete prima disinstallarla.
### Ripristino durante il postinstall
È possibile ripristinare un archivio completo *invece* di eseguire il passaggio di postinstall. Questo è utile se volete reinstallare un sistema interamente da un backup preesistente. Per fare questo dovrete copiare l'archivio sul server nella directory `/home/yunohost.backup/archives` e poi, **invece di dare il comando** `yunohost tools postinstall` darete il comando:
```bash
yunohost backup restore <archivename>
```
Nota: se il vostro archivio non si trova in `/home/yunohost.backup/archives` potete specificare il path giusto con:
```bash
yunohost backup restore /path/to/<archivename>
```
@ -145,7 +136,6 @@ yunohost backup restore /path/to/<archivename>
Potete connettere e montare un disco esterno per tenerci gli archivi di backup (oltre a tutto il resto): per fare questo prima spostate gli archivi e poi aggiungete un link simbolico.
```bash
PATH_TO_DRIVE="/media/my_external_drive" # Come esempio, dipende da dove monterete il vostro disco
mv /home/yunohost.backup/archives $PATH_TO_DRIVE/yunohost_backup_archives
@ -169,7 +159,6 @@ chmod +x /etc/cron.weekly/backup-wordpress
Prestate attenzione a ciò di cui fate il backup e quando perché altrimenti è possibile esaurire lo spazio del vostro disco eseguendo, ad esempio, 30 Gb di backup ogni giorno.
#### Backup del server su un server remoto
Potete seguire questo tutorial sul forum per impostare Borg fra due server: <https://forum.yunohost.org/t/how-to-backup-your-yunohost-server-on-another-server/3153>
@ -181,6 +170,7 @@ Alternativamente, la app Archivist permette di impostare un sistema simile: <htt
If you are using an ARM board, another method for doing a full backup can be to create an image of the SD card.
This can be done easily using [USBimager](https://bztsrc.gitlab.io/usbimager/) (N.B. be sure to get the Read-Write version! Not the write-only version!). The process is basically the *reverse* of flashing the SD card.
- Poweroff your server
- Get the SD card and plug it into your computer
- Using USBimager, click the *Read* button to create an image (snapshot) of the sd card. You can use it later to restore the entire system.

24
pages/02.administer/15.admin_guide/50.backups/backup.md
View file

@ -102,12 +102,12 @@ scp -P ssh_port admin@your.domain.tld:/home/yunohost.backup/archives/<archive_na
! Don't forget to store your backup in a different place to your server.
!!! If you want, you can connect an external disk to your server so that the archives arrive directly on it. See this guide to [Adding external storage to your server](/external_storage)
### Testing
You should regularly test your backups by at least listing the contents of the archives and checking the size of the associated data. It is best to practice restoring regularly.
```bash
# List the files
tar -tvf /home/yunohost.backup/archives/ARCHIVE.tar | less
@ -120,9 +120,11 @@ ls -lh /home/yunohost.backup/archives/ARCHIVE.tar
```
### Restoring backups
!!! SPOILER: The larger your data volume and the more applications you have, the more complex your recovery will be.
#### Simple case: little data, archive already present
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="From the webadmin"]
@ -173,17 +175,15 @@ scp -P ssh_port /path/to/your/<archive_name>.tar admin@your.domain.tld:/home/yun
There are 3 YunoHost applications that offer to extend YunoHost with an automated backup method.
* [BorgBackup](/backup/borgbackup)
* [Restic](/backup/restic)
* [Archivist](/backup/archivist)
- [BorgBackup](/backup/borgbackup)
- [Restic](/backup/restic)
- [Archivist](/backup/archivist)
## Go further
* [Evaluate the quality of your backup](/backup/strategies)
* [Clone your file system](/backup/clone_filesystem)
* [Avoid a hardware failure](/backup/avoid_hardware_failure)
* [Include/exclude files](/backup/include_exclude_files)
* [Custom methods](/backup/custom_backup_methods)
* [Migrate or merge servers](/backup/migrate_or_merge_servers)
- [Evaluate the quality of your backup](/backup/strategies)
- [Clone your file system](/backup/clone_filesystem)
- [Avoid a hardware failure](/backup/avoid_hardware_failure)
- [Include/exclude files](/backup/include_exclude_files)
- [Custom methods](/backup/custom_backup_methods)
- [Migrate or merge servers](/backup/migrate_or_merge_servers)

12
pages/02.administer/15.admin_guide/55.upgrade/10.stretch_buster_migration/stretch_buster_migration.fr.md
View file

@ -19,11 +19,11 @@ L'objectif cette page est de décrire le processus de migration d'une instance e
## Procédure de migration
#### Depuis la webadmin
### Depuis la webadmin
Après avoir mis à jour vers la version en 3.8.5.x, allez dans Outils > Migrations pour accéder à l'interface de migration. Il vous faudra ensuite lire l'avertissement attentivement et l'accepter pour lancer la migration.
#### Depuis la ligne de commande
### Depuis la ligne de commande
Après avoir mis à jour vers la version 3.8.5.x, lancez :
@ -41,21 +41,21 @@ Les logs seront affichés dans la barre de message en haut (vous pouvez approche
Notez que même si vous fermez la page d'admin, la migration continuera (par contre l'interface d'admin sera partiellement indisponible).
#### Si la migration a crashé / échoué à un moment.
### Si la migration a crashé / échoué à un moment
Si la migration a échoué a un moment donné, la première chose à faire est de tenter de la relancer. Si cela ne fonctionne toujours pas, il vous faut [trouver de l'aide](/help) (prière de fournir le/les messages correspondants ou tout élément qui vous fait penser que ça n'a pas marché).
## Choses à vérifier après la migration
#### Vérifiez que vous êtes véritablement sous Debian Buster / YunoHost 4.x
### Vérifiez que vous êtes véritablement sous Debian Buster / YunoHost 4.x
Pour cela, vous pouvez aller dans la partie Diagnostic (section Système de base). (Vous pouvez aussi regarder ce qui est affiché à droite dans le pied de page de la webadmin). En ligne de commande, vous pouvez aussi utiliser `lsb_release -a` et `yunohost --version`.
#### Vérifiez que le diagnostic ne rapporte pas de problème particulier
### Vérifiez que le diagnostic ne rapporte pas de problème particulier
Également dans la section Diagnostic de la webadmin, vérifiez qu'il n'y a pas de problème apparu suite à la migration (par exemple un service qui ne tournerais plus...)
#### Vérifiez que les applications fonctionnent
### Vérifiez que les applications fonctionnent
Vérifiez que vos applications installées fonctionnent... Si elles ne fonctionnent pas, il est recommandé de tenter de les mettre à jour. (ou bien de manière générale, il est recommandé de les mettre à jour même si elles fonctionnent !).

12
pages/02.administer/15.admin_guide/55.upgrade/10.stretch_buster_migration/stretch_buster_migration.md
View file

@ -19,11 +19,11 @@ This page is dedicated to help you migrating an instance from YunoHost 3.8.x (ru
## Migration procedure
#### From the webadmin
### From the webadmin
After upgrading to 3.8.5.x, go to Tools > Migrations to access the migrations interface. You will have to read carefully and accept the disclaimer then launch the migration.
#### From the command line
### From the command line
After upgrading to 3.8.5.x, run :
@ -41,21 +41,21 @@ The logs will be shown in the message bar (you can hover it to see the whole his
Note that even if you close the webadmin page for some reason, the migration will continue in the background (but the webadmin will be partially unavailable).
#### If the migration crashed / failed at some point.
### If the migration crashed / failed at some point
If the migration failed at some point, it should be possible to relaunch it. If it still doesn't work, you can try to [get help](/help) (please provide the corresponding messages or whatever makes you tell that it's not working).
## What to do after the upgrade
#### Check that you actually are on Debian Buster and YunoHost 4.x
### Check that you actually are on Debian Buster and YunoHost 4.x
For this, go in Diagnosis (category Base system) or look at the footer of the webadmin. In the command line, you can use `lsb_release -a` and `yunohost --version`.
#### Check that no issue appeared in the diagnosis
### Check that no issue appeared in the diagnosis
Also in the Diagnosis in the webadmin, make sure that no specific issue appeared after running the migration (for example a service that crashed for some reason).
#### Check that your applications are working
### Check that your applications are working
Test that your applications are working. If they aren't, you should try to upgrade them (it is also a good idea to upgrade them even if they are working anyway).

44
pages/02.administer/15.admin_guide/55.upgrade/15.buster_bullseye/buster_bullseye_migration.fr.md
View file

@ -19,11 +19,11 @@ L'objectif cette page est de décrire le processus de migration d'une instance e
## Procédure de migration
#### Depuis la webadmin
### Depuis la webadmin
Après avoir mis à jour vers la version en 4.4.x, allez dans Outils > Migrations pour accéder à l'interface de migration. Il vous faudra ensuite lire l'avertissement attentivement et l'accepter pour lancer la migration.
#### Depuis la ligne de commande
### Depuis la ligne de commande
Après avoir mis à jour vers la version 4.4.x, lancez :
@ -41,53 +41,53 @@ Les logs seront affichés dans la barre de message au centre de la page (vous po
Notez que même si vous fermez la page d'admin, la migration continuera (par contre l'interface d'admin sera partiellement indisponible).
#### Si la migration a crashé / échoué à un moment.
### Si la migration a crashé / échoué à un moment
Si la migration a échoué a un moment donné, la première chose à faire est de tenter de la relancer. Si cela ne fonctionne toujours pas, il vous faut [trouver de l'aide](/help) (prière de fournir le/les messages correspondants ou tout élément qui vous fait penser que ça n'a pas marché).
## Choses à vérifier après la migration
#### Exécuter la migration pour réparer votre application python
### Exécuter la migration pour réparer votre application python
Après la mise à jour, vos applications python devraient être indisponibles car leur environnement virtuel doit être reconstruit.
Pour ce faire, vous pouvez exécuter les migrations en cours dans `Webadmin > Mises à jour`. Les applications ci-dessous ne seront pas réparées automatiquement, vous devez les mettre à jour manuellement avec `yunohost app upgrade -F APP`.
Les applications qui ne seront pas réparées automatiquement et nécessitent une mise à jour forcée :
* calibreweb
* django-for-runners
* ffsync (cette application est en python2 et n'est plus maintenue, aucune garantie)
* jupiterlab
* librephotos
* mautrix
* mediadrop
* mopidy
* pgadmin
* tracim
* synapse
* weblate
- calibreweb
- django-for-runners
- ffsync (cette application est en python2 et n'est plus maintenue, aucune garantie)
- jupiterlab
- librephotos
- mautrix
- mediadrop
- mopidy
- pgadmin
- tracim
- synapse
- weblate
! !! Si nécessaire, vous pouvez désactiver la reconstruction automatique pour une application python spécifique, en supprimant le fichier dédié terminé par `.requirements_backup_for_bullseye_upgrade.txt` avant d'appliquer la migration. Vous pouvez trouver ce fichier près du venv de votre application dans `/opt` ou `/var/www`.
#### Vérifiez que vous êtes véritablement sous Debian Bullseye et YunoHost 11.x
### Vérifiez que vous êtes véritablement sous Debian Bullseye et YunoHost 11.x
Pour cela, vous pouvez aller dans la partie Diagnostic (section Système de base). (Vous pouvez aussi regarder ce qui est affiché à droite dans le pied de page de la webadmin). En ligne de commande, vous pouvez aussi utiliser `lsb_release -a` et `yunohost --version`.
#### Vérifiez que le diagnostic ne rapporte pas de problème particulier
### Vérifiez que le diagnostic ne rapporte pas de problème particulier
Également dans la section Diagnostic de la webadmin, vérifiez qu'il n'y a pas de problème apparu suite à la migration (par exemple un service qui ne tournerais plus...)
#### Vérifiez que les applications fonctionnent
### Vérifiez que les applications fonctionnent
Vérifiez que vos applications installées fonctionnent... Si elles ne fonctionnent pas, il est recommandé de tenter de les mettre à jour. (ou bien de manière générale, il est recommandé de les mettre à jour même si elles fonctionnent !).
Si votre app est cassée et que vous étiez déjà sur la dernière version d'une application, vous pouvez relancer la mise à jour grâce à l'option `--force`:
```
```bash
yunohost app upgrade --force NOM_APP
```
## Soucis (mineurs) connus après la migration
Voir la [page anglaise](https://yunohost.org/en/buster_bullseye_migration#current-known-minor-issues-after-the-migration)

52
pages/02.administer/15.admin_guide/55.upgrade/15.buster_bullseye/buster_bullseye_migration.md
View file

@ -21,11 +21,11 @@ This page is dedicated to help you migrating an instance from YunoHost 4.4.x (ru
## Migration procedure
#### From the webadmin
### From the webadmin
After upgrading to 4.4.x, go to Tools > Migrations to access the migrations interface. You will have to read carefully and accept the disclaimer then launch the migration.
#### From the command line
### From the command line
After upgrading to 4.4.x, run :
@ -43,56 +43,59 @@ The logs will be shown in the message bar (you can hover it to see the whole his
Note that even if you close the webadmin page for some reason, the migration will continue in the background (but the webadmin will be partially unavailable).
#### If the migration crashed / failed at some point.
### If the migration crashed / failed at some point
If the migration failed at some point, it should be possible to relaunch it. If it still doesn't work, you can try to [get help](/help) (please provide the corresponding messages or whatever makes you say that it's not working).
## What to do after the upgrade
#### Check that you actually are on Debian Bullseye and YunoHost 11.x
### Check that you actually are on Debian Bullseye and YunoHost 11.x
For this, go to Diagnosis (category Base system) or look at the footer of the webadmin. In the command line, you can use `lsb_release -a` and `yunohost --version`.
#### Run the migration to repair your python app
### Run the migration to repair your python app
After upgrading, your python apps should be unavailable because their virtual environment (venv) needs to be rebuilt.
To do that you can run the pending migrations in `Webadmin > Update`. The apps below won't be automatically repaired, you need to force-upgrade them manually instead with `yunohost app upgrade -F APP`.
Apps which won't be automatically repaired and need a force upgrade:
* calibreweb
* django-for-runners
* ffsync (this app is in python2 and no longer maintained, no guarantee)
* jupiterlab
* librephotos
* mautrix
* mediadrop
* mopidy
* pgadmin
* tracim
* synapse
* weblate
- calibreweb
- django-for-runners
- ffsync (this app is in python2 and no longer maintained, no guarantee)
- jupiterlab
- librephotos
- mautrix
- mediadrop
- mopidy
- pgadmin
- tracim
- synapse
- weblate
!!! If needed, you can disable the automatic rebuild for a specific python app, by removing the dedicated file ending with `.requirements_backup_for_bullseye_upgrade.txt` before applying the migration. You can find this file near the venv (Python virtual environment) of your app inside `/opt` or `/var/www`.
#### Check that no issue appeared in the diagnosis
### Check that no issue appeared in the diagnosis
Also in the webadmin Diagnosis section, make sure that no specific issue appeared after running the migration (for example a service that crashed for some reason).
If the service `php7.3-fpm` appears to be dead, you should upgrade your PHP apps like the custom web app. Next, you can run `apt autoremove`.
#### Check that your applications are working
### Check that your applications are working
Test that your applications are working. If they aren't, you should try to upgrade them (it is also a good idea to upgrade them even if they are working anyway).
If your app is broken and you were already with the latest version, you can rerun the upgrade thanks to the `-F|--force` option:
```
```bash
yunohost app upgrade --force APP_NAME
```
## Current known issues after the migration
### Can't run the migration due to `libc6-dev : Breaks: libgcc-8-dev issue`.
### Can't run the migration due to `libc6-dev : Breaks: libgcc-8-dev issue`
Note: This issue should be resolved in yunohost_version: 4.4.2.13
You have an app that depends on the `build-essential` package.
@ -107,7 +110,8 @@ We haven't yet found solution for this issue.
! If you have not yet rebooted your server, don't do it (we are looking for a solution). This will avoid you the use of a keyboard and screen.
We found this in the Raspberry Pi documentation
```
```text
when the dhcpcd5 package is updated to the latest version (1:8.1.2-1+rpt1 -> 1:8.1.2-1+rpt2), the Raspberry Pi will fail to obtain a DHCP IP address following the next reboot or startup. This problem can be avoided by disabling and re-enabling the "System Options -> Network at Boot" option using the latest raspi-config after the dhcpcd5 package has been updated and prior to the system being shutdown or rebooted
```
@ -116,9 +120,9 @@ If you are using a Raspberry Pi 4 (or maybe 3), see this [solution](https://foru
### Restore ynh4 backup onto a fresh ynh11
If you can't restore your app but your system has been restored, you probably should use the regen conf to fix the nginx issues:
```
```bash
yunohost tools regenconf nginx --force
```
After that you should be able to restore your apps. Don't forget to force upgrade them if you have 502 errors.

14
pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.fr.md
View file

@ -23,11 +23,11 @@ L'objectif cette page est de décrire le processus de migration d'une instance e
## Procédure de migration
#### Depuis la webadmin
### Depuis la webadmin
Après avoir mis à jour vers la version 2.7.14, allez dans Outils > Migrations pour accéder à l'interface de migration. Il vous faudra ensuite lire l'avertissement attentivement et l'accepter pour lancer la migration. Les logs seront affichés dans la barre de message en haut (vous pouvez approcher la souris dessus pour voir l'historique en entier).
#### Depuis la ligne de commande
### Depuis la ligne de commande
Après avoir mis à jour vers la version 2.7.14, lancez :
@ -43,24 +43,24 @@ En fonction de votre matériel et des paquets installés, la migration peut pren
Notez qu'il est attendu de voir certaines erreurs (en particulier à propos de Fail2Ban) pendant la migration - ne vous en inquiétez pas trop.
#### Si la migration a crashé / échoué à un moment.
### Si la migration a crashé / échoué à un moment
Si la migration a échoué a un moment donné, la première chose à faire est de tenter de la relancer. Si cela ne fonctionne toujours pas, il vous faut [trouver de l'aide](/help) (prière de fournir le/les messages correspondants ou tout élément qui vous fait penser que ça n'a pas marché).
## Choses à vérifier après la migration
#### Vérifiez que vous êtes véritablement sous Debian Stretch / YunoHost 3.0
### Vérifiez que vous êtes véritablement sous Debian Stretch / YunoHost 3.0
Pour cela, allez dans Outils > Diagnostique. (Vous pouvez aussi regarder ce qui est affiché dans le pied de page). En ligne de commande, vous pouvez aussi utiliser `lsb_release -a` et `yunohost --version`.
#### Vérifiez que Fail2Ban et le pare-feu sont actifs.
### Vérifiez que Fail2Ban et le pare-feu sont actifs
Vous devriez voir que Fail2Ban et le firewall sont actifs. Depuis la webadmin, dans Services (chercher 'fail2ban' et 'yunohost-firewall'). Depuis la ligne de commande, faites `yunohost service status fail2ban yunohost-firewall` : les deux devraient être en `active: active`.
#### Vérifiez que les applications fonctionnent
### Vérifiez que les applications fonctionnent
Vérifiez que vos applications installées fonctionnent... Si elles ne fonctionnent pas, il est recommandé de tenter de les mettre à jour. (ou bien de manière générale, il est recommandé de les mettre à jour même si elles fonctionnent !).
#### Si vous utilisez les mails : vérifiez votre score
### Si vous utilisez les mails : vérifiez votre score
Si vous utilisez les emails (en particulier les envois), vérifiez que votre score est toujours bon via [mail-tester](https://www.mail-tester.com/) par exemple.

14
pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.md
View file

@ -23,11 +23,11 @@ This page is dedicated to help you migrating an instance from YunoHost 2.7.x (ru
## Migration procedure
#### From the webadmin
### From the webadmin
After upgrading to 2.7.14, go to Tools > Migrations to access the migrations interface. You will have to read carefully and accept the disclaimer then launch the migration. The logs will be shown in the message bar (you can hover it to see the whole history).
#### From the command line
### From the command line
After upgrading to 2.7.14, run:
@ -43,24 +43,24 @@ Depending on your hardware and packages installed, the migration might take up t
Note that it is expected to see some errors (in particular about Fail2Ban) during the migration, so don't worry too much about them.
#### If the migration crashed / failed at some point.
### If the migration crashed / failed at some point
If the migration failed at some point, it should be possible to relaunch it. If it still doesn't work, you can try to [get help](/help) (please provide the corresponding messages or whatever makes you tell that it's not working).
## What to do after the upgrade
#### Check that you actually are on Debian Stretch and YunoHost 3.0
### Check that you actually are on Debian Stretch and YunoHost 3.0
You should be able to see this from the webadmin Tools > Diagnosis, and also in the footer of the page. On the command line, you can use `lsb_release -a` and `yunohost --version`.
#### Check that Fail2Ban and the firewall are active
### Check that Fail2Ban and the firewall are active
You should be able to see that Fail2Ban and the firewall are active. From the webadmin in Services (look for 'fail2ban' and 'yunohost-firewall'). From the command line, run `yunohost service status fail2ban yunohost-firewall`. They should both have `active: active`.
#### Check that your applications are working
### Check that your applications are working
Test that your applications are working. If they aren't, you should try to upgrade them (it is also a good idea to upgrade them even if they are working anyway).
#### Mail users: check your mail score
### Mail users: check your mail score
If you are using mails (especially sending them), check that your score is still good by using [mail-tester](https://www.mail-tester.com/) for example.

1
pages/02.administer/15.admin_guide/admin_guide.de.md
View file

@ -10,7 +10,6 @@ routes:
Diese Seite bietet eine Übersicht über das Ökosystem eines YunoHost-Servers. Diese Übersicht macht mehrere Vereinfachungen und zielt wesentlich darauf ab, ein globales Bild zu vermitteln, bevor tiefer auf die verschiedenen Aspekte eingegangen wird.
![](image://ecosystem.png)
Alles beginnt mit dem speziellen **admin** Benutzer. Dies ist der Administrator des Computers, der Dinge auf dem Server über die Webverwaltungsoberfläche oder über SSH und die Befehlszeilenschnittstelle installieren, konfigurieren und verwalten kann. *(Wenn du bereits mit GNU / Linux vertraut bist, ist dies root ziemlich ähnlich. YunoHost hat diesen zusätzlichen 'Admin'-Benutzer aus verschiedenen technischen Gründen.)*

Some files were not shown because too many files have changed in this diff Show more