From f14b11710f04cac885679f4e2ddf3fd58d188a21 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?F=C3=A9lix=20Pi=C3=A9dallu?= Date: Sun, 24 Sep 2023 13:49:30 +0200 Subject: [PATCH 1/8] Document antifeatures in the manifest.toml --- .../10.packaging_apps/10.manifest/docs.md | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/pages/06.contribute/10.packaging_apps/10.manifest/docs.md b/pages/06.contribute/10.packaging_apps/10.manifest/docs.md index 4e0e226f..20abfbd2 100644 --- a/pages/06.contribute/10.packaging_apps/10.manifest/docs.md +++ b/pages/06.contribute/10.packaging_apps/10.manifest/docs.md @@ -84,6 +84,26 @@ ram.runtime = "1M" - `ram.build` (size) : an *estimate* minimum ram requirement when building the app (this may be way different than `ram.runtime` because some apps have a peak 1~2G RAM when building sometimes...). For example: 50M, 400M, 1G, ... - `ram.runtime` (size) : an *estimate* minimum ram requirement when the app is active and running. For example: 50M, 400M, 1G, ... +## Antifeatures + +This section is completely optional and, for most apps, doesn't exist at all. + +Some applications have limitations, they might be due to non-free dependencies, arbitrary limitations, etc. Yunohost provides UI in the catalog to show such antifeatures. + +The declaration of antifeatures is a 3-steps process: + +- Find the relevant antifeature in [the list of supported antifeatures](https://github.com/YunoHost/apps/blob/master/antifeatures.toml) +- Declare the app's antifeature in the [app catalog](https://github.com/YunoHost/apps/blob/master/apps.toml) +- Describe the app's antifeature in its `manifest.toml`: + + ```toml + [antifeatures] + arbitrary-limitations.en = "Some description about the specific limitations of this app." + ``` + +The format of this section is a `dict` where keys are antifeature IDs, and the values +are translated strings (`dict` of `lang code`->`str`). + ## Install questions From a9aa91b55423b98dc27ae912b0ee0031efdf9aeb Mon Sep 17 00:00:00 2001 From: Alexandre Aubin Date: Mon, 25 Sep 2023 17:10:16 +0200 Subject: [PATCH 2/8] Redirect app catalog and wishlist to the new apps.yunohost.org --- pages/04.applications/05.catalog/apps.de.md | 134 ------- pages/04.applications/05.catalog/apps.fr.md | 134 ------- pages/04.applications/05.catalog/apps.md | 131 +----- .../99.wishlist/apps_wishlist.md | 373 +----------------- 4 files changed, 2 insertions(+), 770 deletions(-) delete mode 100644 pages/04.applications/05.catalog/apps.de.md delete mode 100644 pages/04.applications/05.catalog/apps.fr.md diff --git a/pages/04.applications/05.catalog/apps.de.md b/pages/04.applications/05.catalog/apps.de.md deleted file mode 100644 index d21a53d6..00000000 --- a/pages/04.applications/05.catalog/apps.de.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: Anwendungskatalog -template: docs -taxonomy: - category: docs -routes: - default: '/apps' -twig_first: true -process: - twig: true ---- - -
-Für diese Seite muss JavaScript aktiviert sein, damit sie korrekt angezeigt werden kann :s. -
- -
- - -
- -!!! Das Packaging-Team für Anwendungen freut sich, Ihre Kommentare zu bekommen! ! Wenn Sie Probleme oder mögliche Verbesserungen durch die Installation einer Anwendung finden, zögern Sie nicht, mit Meldung von Fehlern direkt auf dem entsprechenden Code-Repository beizutragen. - -! Die markierten Anwendungen schlechte Qualität funktionieren wahrscheinlich, aber respektieren Sie keine guten Verpackungspraktiken oder unterstützen Sie keine bestimmten Funktionen wie Backups / Datenwiederherstellung oder die einmalige Authentifizierung. Seien Sie vorsichtig, wenn Sie sie installieren. - -{% set catalog = read_file('/var/www/app_yunohost/apps/builds/default/doc_catalog/apps.json')|json_decode(true) %} - -
-{% for app_id, infos in catalog.apps %} - -{% if grav.language.getActive in infos.description %} - {% set descr_lang = grav.language.getActive %} -{% else %} - {% set descr_lang = 'en' %} -{% endif %} - -
-
-{% if infos.good_quality %} - -{% endif %} -{{ infos.name }} -{{infos.category}} -{% if infos.broken %} -gebrochen -{% else %} -{% if infos.bad_quality %} -schlechte Qualität -{% endif %} -{% endif %} -
-
{{ infos.description[descr_lang] }}
-
-
- - Code - Doc - Install - -
-
-
-{% endfor %} -
- -! Wenn Sie keine bestimmte Anwendung finden, nach der Sie suchen, können Sie es der [gewünschten Apps-Liste](/apps_wishlist) hinzufügen. - - - - diff --git a/pages/04.applications/05.catalog/apps.fr.md b/pages/04.applications/05.catalog/apps.fr.md deleted file mode 100644 index 1e3c36c7..00000000 --- a/pages/04.applications/05.catalog/apps.fr.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: Catalogue d'applications -template: docs -taxonomy: - category: docs -routes: - default: '/apps' -twig_first: true -process: - twig: true ---- - -
-Cette page requiert que JavaScript soit activé pour s'afficher correctement :s. -
- -
- - -
- -!!! L'équipe de packaging d'applications sera heureuse de recevoir vos commentaires ! Si vous trouvez des problèmes ou des améliorations possibles en installant une app, n'hésitez pas à contribuer en créant un ticket (issue) directement sur le dépôt de code. - -! Les applications étiquettées mauvaise qualité fonctionnent peut-être, mais ne respectent pas les bonnes pratiques de packaging ou ne supportent pas certaines fonctionnalités comme les sauvegardes/restauration ou l'authentication unifiée. Soyez prudent si vous les installez. - -{% set catalog = read_file('/var/www/app_yunohost/apps/builds/default/doc_catalog/apps.json')|json_decode(true) %} - -
-{% for app_id, infos in catalog.apps %} - -{% if grav.language.getActive in infos.description %} - {% set descr_lang = grav.language.getActive %} -{% else %} - {% set descr_lang = 'en' %} -{% endif %} - -
-
-{% if infos.good_quality %} - -{% endif %} -{{ infos.name }} -{{infos.category}} -{% if infos.broken %} -cassée -{% else %} -{% if infos.bad_quality %} -mauvaise qualité -{% endif %} -{% endif %} -
-
{{ infos.description[descr_lang] }}
-
-
- - Code - Doc - Install - -
-
-
-{% endfor %} -
- -! Si vous ne trouvez pas une application précise que vous recherchez, vous pouvez l'ajouter à la [liste d'apps souhaitées](/apps_wishlist). - - - - diff --git a/pages/04.applications/05.catalog/apps.md b/pages/04.applications/05.catalog/apps.md index 421795f8..97230d7b 100644 --- a/pages/04.applications/05.catalog/apps.md +++ b/pages/04.applications/05.catalog/apps.md @@ -1,136 +1,7 @@ --- title: Application catalog template: docs -taxonomy: - category: docs +redirect: 'https://apps.yunohost.org/catalog' routes: default: '/apps' -twig_first: true -process: - twig: true --- - -
-This page requires JavaScript enabled to display properly :s. -
- -
- - -
- -!!! The application packaging team will welcome your feedback! If you install an app and find issues or possible improvements, do not hesitate to contribute by reporting your issues directly on the corresponding code repositories. - -! Applications flagged as low quality may be working, but they may not respect good packaging practices or lack integration of some features like backup/restore or single authentication. Be cautious when installing them. - -{% set catalog = read_file('/var/www/app_yunohost/apps/builds/default/doc_catalog/apps.json')|json_decode(true) %} - -
-{% for app_id, infos in catalog.apps %} - -{% if grav.language.getActive in infos.description %} - {% set descr_lang = grav.language.getActive %} -{% else %} - {% set descr_lang = 'en' %} -{% endif %} - -
-
-{% if infos.good_quality %} - -{% endif %} -{{ infos.name }} -{{infos.category}} -{% if infos.broken %} -broken -{% else %} -{% if infos.bad_quality %} -low quality -{% endif %} -{% endif %} -
-
{{ infos.description[descr_lang] }}
-
-
- - Code - Doc - Install - -
-
-
-{% endfor %} -
- -! If you don't find the app you are looking for, you can add it to the [apps wishlist](/apps_wishlist). - - - - - - diff --git a/pages/04.applications/99.wishlist/apps_wishlist.md b/pages/04.applications/99.wishlist/apps_wishlist.md index 292a3592..97e8a4c1 100644 --- a/pages/04.applications/99.wishlist/apps_wishlist.md +++ b/pages/04.applications/99.wishlist/apps_wishlist.md @@ -1,378 +1,7 @@ --- title: Apps wishlist template: docs -taxonomy: - category: docs +redirect: 'https://apps.yunohost.org/wishlist' routes: default: '/apps_wishlist' --- - -The following list is a compiled wishlist of applications that would be nice-to-have. - -You can [contribute to this list by adding something you'd like to be packaged](/write_documentation), or learn more on [how to package applications](/packaging_apps) to create a new package or improve a package draft. - -! Before adding an app in this wish-list, please check your app is not [already available in YunoHost's app catalogue](/apps) or [about to be added into it](https://github.com/YunoHost/apps/pulls) - -| Name | Description | Upstream | Package draft | -| ------ | ----------- | -------- | ------------- | -| 10er10 | 10er10 is an HTML5 audio jukebox | [Upstream](https://github.com/dready92/10er10) | | -| [Access to Memory (AtoM)](https://www.accesstomemory.org/) | Web-based, open source application for standards-based archival description and access in a multilingual, multi-repository environment. | [Upstream](https://github.com/artefactual/atom) | | -| adhocserver | An ad hoc server for the Sony PSP | | [Package Draft](https://github.com/matlink/adhocserver_ynh) | -| [Ajenti](https://ajenti.org) | Ajenti is a Linux & BSD modular server admin panel | [Upstream](https://github.com/ajenti/ajenti/) | | -| Akaunting | Manage payments/invoices/expenses | [Upstream](https://github.com/akaunting/akaunting) | | -| [Amara](https://amara.org/) | Collaborative translation of subtitles for videos. | [Upstream](https://gitlab.com/hanklank/amara-archive) | | -| Anki Sync Server | a personal Anki server |[Upstream](https://github.com/ankicommunity/anki-sync-server) | | -| [AnonAddy](https://anonaddy.com/) | Anonymous email forwarding - Create Unlimited Email Aliases For Free | [Upstream](https://github.com/anonaddy/anonaddy) | | -| [Ansible Matrix Docker Deploy](https://github.com/spantaleev/matrix-docker-ansible-deploy) | Full Featured Matrix Server Setup with All Bridges and Integrations | [Upstream](https://github.com/spantaleev/matrix-docker-ansible-deploy) | | -| [Apache Superset](https://superset.apache.org/) | Apache Superset is a Data Visualization and Data Exploration Platform | [Upstream](https://github.com/apache/superset) | | -| [Appflowy.IO](https://appflowy.io/) | Open-source alternative to Notion | [Upstream](https://github.com/AppFlowy-IO/appflowy) | | -| [askbot](https://askbot.com/) | Questions and answers | | [Package Draft](https://github.com/zamentur/askbot_ynh) | -| [Archivematica](https://www.archivematica.org/) | Mature digital preservation system designed to maintain standards-based, long-term access to collections of digital objects. | [Upstream](https://github.com/artefactual/archivematica) | | -| [ArchivesSpace](https://archivesspace.org/) | Archives information management application for managing and providing Web access to archives, manuscripts and digital objects. | [Upstream](https://github.com/archivesspace/archivesspace) | | -| [Asqatasun.org](https://asqatasun.org/) | website analyser for web accessibility and SEO | [Upstream](https://gitlab.com/asqatasun/Asqatasun) | | -| [ass](https://github.com/tycrek/ass) | ass is a self-hosted ShareX upload server written in Node.js. |[Upstream](https://github.com/tycrek/ass)| | -| [Astral](https://astralapp.com/) | Organize Your GitHub Stars With Ease |[Upstream](https://github.com/astralapp/astral)| | -| [Azuracast](https://azuracast.com/) | A Simple, Self-Hosted Web Radio Management Suite |[Upstream](https://github.com/AzuraCast/AzuraCast)| | -| [Backstage.io](https://backstage.io/) | Open source Enterprise Developer Portal with Eco-System | [Upstream](https://github.com/backstage/backstage) | | -| [Baserow](https://baserow.io/) | Open source no-code database tool and Airtable alternative. | [Upstream](https://gitlab.com/bramw/baserow) | | -| [Beatbump](https://beatbump.ml/home) | An alternative frontend for YouTube Music | [Upstream](https://github.com/snuffyDev/Beatbump) | | -| [Beeper](https://www.beeper.com/) | A unified inbox for 15 chat networks. | [Upstream](https://gitlab.com/beeper) | | -| [Belenios Voting](https://www.belenios.org/) | Verifiable, lean, trustable online voting system | [Upstream](https://github.com/glondu/belenios/) | | -| [BigBlueButton](https://bigbluebutton.org) | Web conferencing system | [Upstream](https://github.com/bigbluebutton/bigbluebutton) | | -| [BitcartCC](https://bitcartcc.com) | BitcartCC is a self-hosted, open-source cryptocurrency all-in-one solution | [Upstream](https://github.com/bitcartcc/bitcart) | | -| [Bitmessage](https://bitmessage.org/) | P2P communication protocol used to send encrypted messages | [Upstream](https://github.com/Bitmessage/PyBitmessage) | | -| Blynk | | [Upstream](https://github.com/blynkkk/blynk-library) | | -| [Bolt](https://bolt.cm/) | Content Management Tool | | [Package Draft](https://github.com/realitygaps/bolt_ynh) | -| [BorgWarehouse](https://borgwarehouse.com/) | A fast and modern WebUI for a BorgBackup's central repository server. | [Upstream](https://github.com/ravinou/borgwarehouse) | | -| [Budibase](https://budibase.com/) | Low code platform for creating internal apps, workflows, and admin panels in minutes. | [Upstream](https://github.com/Budibase/budibase) | | -| [BTCPay Server](https://btcpayserver.org) | BTCPay Server is a free and open-source Bitcoin payment processor | [Upstream](https://github.com/btcpayserver/btcpayserver) | | -| [Cactus Comments](https://cactus.chat/) | Federated comment system, to embed into your webpages, based on the Matrix protocol. | [Upstream](https://gitlab.com/cactus-comments) | [Package Draft](https://github.com/h3ndrik/cactus-comments_ynh) | -| [Cagette](https://www.cagette.net/) | A marketplace for local farmers and producers | [Upstream](https://github.com/CagetteNet/cagette) | | -| [Cal.com](https://cal.com/) | Formerly Calendso. Volunteer shift management and meeting scheduling. "The open source Calendly alternative." | [Upstream](https://github.com/calcom/cal.com) | | -| [Caliopen](https://www.caliopen.org) | A unified inteface for all your private communications | | | -| [cgit](https://git.zx2c4.com/cgit/about) | | | | -| Chaskiq | A full featured Live Chat, Support & Marketing platform, alternative to Intercom, Drift, Crisp | [Upstream](https://github.com/chaskiq/chaskiq) | | -| changedetection.io | Self-hosted open source change monitoring of web pages | [Upstream](https://github.com/dgtlmoon/changedetection.io) | | -| [Chatterbox](https://element.io/solutions/chatterbox-embedded-live-chat-for-customer-service) | Embedded live chat for customer service | [Upstream]([https://github.com/sourcegraph/checkup](https://github.com/vector-im/chatterbox)) | | -| [Chatwoot](https://www.chatwoot.com/docs/self-hosted/) | Open-source customer engagement suite, an alternative to Intercom, Zendesk, Salesforce Service Cloud | [Upstream](https://github.com/chatwoot/chatwoot) | | -| [CheckUp](https://sourcegraph.github.io/checkup) | | [Upstream](https://github.com/sourcegraph/checkup) | | -| [Checkmk](https://checkmk.com/) | Checkmk provides powerful monitoring of networks, servers, clouds, containers and applications | [Upstream](https://github.com/tribe29/checkmk) | | -| [Citadel-suite](https://www.citadel.org) | Groupware platform | | | -| [CKAN](https://ckan.org/) | A tool for making open data websites | [Upstream](https://github.com/ckan/ckan) | | -| [CloudTube](https://tube.cadence.moe/) | CloudTube front-end for YouTube | [Upstream](https://git.sr.ht/~cadence/cloudtube) | | -| [Commafeed](https://www.commafeed.com/) | Self-hosted RSS reader | [Upstream](https://github.com/Athou/commafeed) | | -| [Congressus](https://congressus.partipirate.org/about.php) | A meeting management tool with decision-making based on a voting pool. | [upstream](https://github.com/PartiPirate/congressus) | | -| cops | Calibre OPDS | | [Package Draft](https://github.com/YunoHost-Apps/cops_ynh) | -| [Coquelicot](https://coquelicot.potager.org/) | A “one-click” file sharing web application | | [Package Draft](https://github.com/YunoHost-Apps/coquelicot_ynh) | -| [Cozy](https://cozy.io/en/) | | | | -| Croodle | Vote for a schedule / polling | [Upstream](https://github.com/jelhan/croodle) | | -| [Cusdis](https://cusdis.com/) | A lightweight, privacy-friendly comment system alternative to Disqus. |[Upstream](https://github.com/djyde/cusdis)| | -| [Darkwire.io](https://darkwire.io/) | End-to-end encrypted instant web chat | [Upstream](https://github.com/seripap/darkwire.io) | | -| [Dataverse](https://dataverse.org) | Open source research data repository software | [Upstream](https://github.com/IQSS/dataverse) | | -| [DavMail](http://davmail.sourceforge.net/) | Gateway from OWA and O365 to IMAP, POP, and CalDav for email and calendars | [Upstream](https://github.com/mguessan/davmail) | | -| [democracyOS](https://democracyos.org/) | Vote / make decisions in a collective | | [Package Draft](https://github.com/YunoHost-Apps/democracyos_ynh) | -| [diasporadocker](https://diasporafoundation.org/) | A open and powerfull social network | | [Package Draft](https://github.com/aymhce/diasporadocker_ynh) | -| Django_app | Skeleton for django apps | | [Package Draft](https://github.com/Jojo144/django_app_ynh) | -| Docker_container | Deploy applications with Docker | | [Package Draft](https://github.com/scith/docker_container_ynh) | -| Docker_rstudio | A web development environment for statistics with R | | [Package Draft](https://github.com/scith/docker_rstudio_ynh) | -| Docker-registry | | [Upstream](https://github.com/docker/distribution/) | [Package Draft](https://github.com/plopoyop/docker-registry_ynh) | -| DockerUI | Deploy applications with Docker | | [Package Draft](https://github.com/YunoHost-Apps/dockerui_ynh) | -| Docspell | Simple document organizer | [Upstream](https://github.com/eikek/docspell) | | -| Docusaurus | Static site generator/SPA to build documentations | [Upstream](https://github.com/facebook/docusaurus) | | -| [DomainMOD](https://domainmod.org) | Domain portfolio management application | | | -| DrakonHub | Online editor for Drakon diagrams | [Upstream](https://github.com/stepan-mitkin/drakonhub) | | -| [Drawpile](https://drawpile.net) | Collaborative drawing program that allows multiple users to sketch on the same canvas simultaneously | [Upstream](https://github.com/drawpile/Drawpile) | | -| [Earthstar-Project Server](https://earthstar-project.org/tutorials/run-a-server) | Run and configure an Earthstar server capable of syncing with other peers | [Upstream](https://github.com/earthstar-project/earthstar) | | -| [Element Call](https://element.io/blog/element-call-beta-2-encryption-spatial-audio-walkie-talkie-mode-and-more/) | Showcase for full mesh video chat powered by Matrix | [Upstream](https://github.com/vector-im/element-call) | | -| [Elk](https://elk.zone) | A nimble Mastodon web client. It also works with other Fediverse servers like Pleroma or GotoSocial | [upstream](https://github.com/elk-zone/elk) | | -| Endlessh | SSH Tarpit | [upstream](https://github.com/skeeto/endlessh) | | -| [erine.email](https://erine.email/) | | [Upstream](https://gitlab.com/mdavranche/erine.email) | | -| [ERPnext](https://erpnext.com/) | | [Upstream](https://github.com/frappe/erpnext) | | -| [EteSync](https://www.etesync.com/) | | [Upstream](https://github.com/etesync) | | -| [Excalibur](https://excalibur-py.readthedocs.io/en/master/) | A web interface to extract tabular data from PDFs (based on Camelot) | [Upstream](https://github.com/camelot-dev/excalibur) | | -| [Farside](https://farside.link/) | A redirecting service for FOSS alternative frontends | [Updtream](https://github.com/benbusby/farside) | | -| [Federated wiki](http://fed.wiki.org/view/welcome-visitors/view/federated-wiki) | Farm for fedwiki sites | [Upstream](https://github.com/fedwiki) | | -| [Ferdi server](https://getferdi.com) | Messaging aggregation | [Upstream](https://github.com/getferdi/server) | | -| [FEX](https://fex.rus.uni-stuttgart.de/) | | | | -| [Firefly-III Data Importer](https://docs.firefly-iii.org/data-importer) | Import data from banks to Firefly | [Upstream](https://github.com/firefly-iii/data-importer) | [Draft Package](https://github.com/marcoil/firefly-iii-di_ynh) | -| [Filestash](https://www.filestash.app/) | | [Upstream](https://github.com/mickael-kerjean/filestash) | | -| [fishnet](https://lichess.org/get-fishnet) | Distributed Stockfish analysis for lichess.org | [Upstream](https://github.com/niklasf/fishnet) | | -| FlareSolverr | Proxy server to bypass Cloudflare protection | [Upstream](https://github.com/FlareSolverr/FlareSolverr) | | -| Flask | Skeleton for flask apps | | [Package Draft](https://github.com/YunoHost-Apps/flask_ynh) | -| [foodsoft](https://foodcoops.github.io/foodsoft-hosting/) | Manage a non-profit food cooperative | | [Package Draft](https://github.com/YunoHost-Apps/foodsoft_ynh) | -| [Forem](https://www.forem.com/) | Forem is open source software for building communities. | [Upstream](https://github.com/forem/selfhost) | | -| [Fossil](https://www.fossil-scm.org) | | | | -| [Fractale](https://fractale.co/) | Fractale is a platform for self-organization.| [Upstream](https://github.com/fractal6/fractal6.go) | | -| full-text-rss | | [Upstream](https://bitbucket.org/fivefilters/full-text-rss/src/master/) | | -| Framaestro | Online service aggregator | [Upstream](https://framagit.org/framasoft/framaestro) | [Package Draft](https://github.com/YunoHost-Apps/framaestro_ynh) | -| Framaestro_hub | Online service aggregator hub | [Upstream](https://github.com/mozilla/togetherjs.git) | [Package Draft](https://github.com/YunoHost-Apps/framaestro_hub_ynh) | -| [freeboard](https://freeboard.io/) | A real-time dashboard builder for IOT | | [Package Draft](https://github.com/YunoHost-Apps/freeboard_ynh) | -| [freepbx](https://freepbx.org) | VOIP | | [Package Draft](https://github.com/YunoHost-Apps/freepbx_ynh) | -| [Freescout](https://freescout.net/) | Helpdesk & Shared Mailbox | [Upstream](https://github.com/freescout-helpdesk/freescout) | | -| [ftssolr](https://wiki.dovecot.org/Plugins/FTS/Solr) | Full-text search via IMAP through a Solr indexing server | | [Package Draft](https://github.com/YunoHost-Apps/ftssolr_ynh) | -| [Gancio](https://gancio.org/) | | [Upstream](https://framagit.org/les/gancio) | | -| [Garage](https://garagehq.deuxfleurs.fr) | A self-hostable distributed storage service (S3 compatible) | [Upstream](https://git.deuxfleurs.fr/Deuxfleurs/garage) | | -| gateone | HTML5-powered terminal emulator and SSH client | | [Package Draft](https://github.com/Kloadut/gateone_ynh) | -| [Gatsby](https://www.gatsbyjs.com/) | Build blazing fast, modern apps and websites with React | [Upstream](https://github.com/gatsbyjs/gatsby) | | -| [Geneweb](https://geneweb.tuxfamily.org) | | [Upstream](https://github.com/geneweb/geneweb) | | -| gitolite | Git server | | [Package Draft](https://github.com/matlink/gitolite_ynh) | -| gitrepositories | | | [Package Draft](https://github.com/YunoHost-Apps/gitrepositories_ynh) | -| gitweb | Git forge (c.f. Gitolite) | | [Package Draft](https://github.com/matlink/gitweb_ynh) | -| gnusocial | Create a federated comunication node | | [Package Draft](https://github.com/YunoHost-Apps/gnusocial_ynh) | -| [Goaccess](https://goaccess.io) | Web log analyzer | [Upstream](https://github.com/allinurl/goaccess) | | -| [GoatCounter](https://www.goatcounter.com/) | privacy-friendly web analytics | [Upstream](https://github.com/arp242/goatcounter) | | -| gogs_webhost | Turn a Gogs repository to static web hosting | | [Package Draft](https://github.com/YunoHost-Apps/gogs_webhost_ynh) | -| Gollum | A simple Git-powered wiki | [Upstream](https://github.com/gollum/gollum) | [Package Draft](https://github.com/YunoHost-Apps/gollum_ynh) | -| Goploader | | [Upstream](https://github.com/Depado/goploader) | | -| [gocd](https://go.cd) | CI/CD server | [Upstream](https://github.com/gocd/gocd) | | -| Granary | | [Upstream](https://github.com/snarfed/granary) | | -| [Graphhopper](https://www.graphhopper.com/) | | [Upstream](https://github.com/graphhopper/graphhopper) | | -| [Greenlight](https://blabla.aquilenet.fr/b) | A really simple end-user interface for your BigBlueButton server | [Upstream](https://github.com/bigbluebutton/greenlight) | | -| [Grist](https://www.getgrist.com/) | The evolution of spreadsheets | [Upstream](https://github.com/gristlabs/grist-core/) | [Package Draft](https://github.com/ketsapiwiq/grist_ynh) | -| [Habitica](https://habitica.com/) | | [Upstream](https://github.com/HabitRPG/habitica) | | -| [Hashbase](https://github.com/beakerbrowser/hashbase/tree/master/docs) | A public peer service for Dat archives, provides a HTTP-accessible interface for creating an account and uploading Dats. | [Upstream](https://github.com/beakerbrowser/hashbase) | | -| Helpy | | [Upstream](https://github.com/helpyio/helpy) | | -| [Hexo](https://hexo.io/) | | [Upstream](https://github.com/hexojs/hexo) | | -| [HistoPad](https://github.com/24eme/histopad) | Web application for logging pads (etherpad) and archiving them in a git repository. | [Upstream](https://github.com/24eme/histopad) | | -| Hometown | A Mastodon fork with local-only posting, support for more content types, and other features and tweaks. | [Upstream](https://github.com/hometown-fork/hometown) | | -| [htpc-manager](https://htpc.io) | Manage your HTPC from anywhere | | [Package Draft](https://github.com/scith/htpc-manager_ynh) | -| [hyperion](https://docs.hyperion-project.org/) | Ambient lightning software | [Upstream](https://github.com/hyperion-project/hyperion.ng) | | -| [Hypothes.is](https://hypothes.is) | Web Annotation server (and client) to crate and share highlights and notes | [Hypothes.is server](https://github.com/hypothesis/h) | | -| [Icecast 2](https://www.icecast.org) | | [Upstream](https://gitlab.xiph.org/xiph/icecast-server/) | | -| [ikiwiki](https://ikiwiki.info) | | | | -| [InfCloud](https://inf-it.com/open-source/clients/infcloud/) | A contacts, calendar and tasks web client for CalDAV and CardDAV | [Upstream](https://inf-it.com/open-source/download/InfCloud_0.13.1.zip) | | -| [Inginious](https://inginious.org) | Secure and automated exercises assessment platform using your own tests, also providing a pluggable interface with your existing LMS. | [Upstream](https://github.com/UCL-INGI/INGInious) || -| [Inventaire](https://inventaire.io) | a libre collaborative resource mapper powered by open-knowledge, starting with books! 📚 | [Upstream](https://github.com/inventaire/inventaire) | | -| [InvoicePlane](https://invoiceplane.com) | | [Upstream](https://github.com/InvoicePlane/InvoicePlane) | | -| [IPFS](https://ipfs.io) | | [Upstream](https://github.com/ipfs/ipfs) | [Package Draft](https://github.com/YunoHost-Apps/ipfs_ynh) | -| jappix_mini | Jappix Mini XMPP chat website integration | | [Package Draft](https://github.com/YunoHost-Apps/jappix_mini_ynh) | -| [Joplin](https://joplin.cozic.net/) | | [Upstream](https://github.com/laurent22/joplin) | | -| Joplin-web | | [Upstream](https://github.com/foxmask/joplin-web) | | -| [JS Bin](https://jsbin.com/) | | [Upstream](https://github.com/jsbin/jsbin) | | -| [Karaoke-forever](https://www.karaoke-forever.com/) | Organize karaoke parties | [Upstream](https://github.com/bhj/karaoke-forever) | | -| Kenoma | Pleroma frontend | [Upstream](https://git.pleroma.social/lambadalambda/kenoma) | | -| Keyoxide | Keyoxide is a privacy-friendly tool to create and verify decentralized online identities. | [Upstream](https://codeberg.org/keyoxide) | | -| [Kill the newsletter](https://kill-the-newsletter.com/) | Convert email newsletters to RSS feeds | [Upstream](https://github.com/leafac/kill-the-newsletter.com) | | -| [Kitchenowl](https://kitchenowl.org/) | grocery list and recipe manager | [Upstream](https://github.com/TomBursch/kitchenowl) | | -| [Klaxon](https://newsklaxon.org) | Easily create alerts for changes on the web | [Upstream](https://github.com/themarshallproject/klaxon) | | -| [Known](https://withknown.com) | | [Upstream](https://github.com/idno/known) | | -| [Koha](https://koha-community.org/) | The world's first free and open source library system | [Upstream](https://git.koha-community.org/Koha-community/Koha) | | -| Kontalk | | [Upstream](https://github.com/kontalk) | | -| [Koozip](https://koozic.net) | | [Upstream](https://github.com/DocMarty84/koozic) | | -| L'atelier | | [Upstream](https://github.com/jbl2024/latelier) | | -| [LBCAlerte](https://alerte.ilatumi.org/) | | | [Package Draft](https://github.com/YunoHost-Apps/LBCAlerte_ynh) | -| lektor | A static website generator | | [Package Draft](https://github.com/YunoHost-Apps/lektor_ynh) | -| [LessPass](https://www.lesspass.com/) | | [Upstream](https://github.com/lesspass/lesspass) | | -| [Lessy](https://lessy.io) | | [Upstream](https://github.com/lessy-community/lessy) | | -| [Librarian](https://lbry.bcow.xyz/) | An alternative frontend for LBRY/Odysee | [Upstream](https://codeberg.org/librarian/librarian) | | -| Lichen | Gemtext to HTML translator | [Upstream](https://git.sensorstation.co/lichen.git) | | -| [Lila](https://lichess.org/) | Online chess game server | [Upstream](https://github.com/ornicar/lila) | | -| [LiquidSoap](https://www.liquidsoap.info/) | Audio and video streaming language | [Upstream](https://github.com/savonet/liquidsoap) | | -| LocomotiveCMS | | [Upstream](https://github.com/locomotivecms/engine) | | -| [Logitech Media Server](https://en.wikipedia.org/wiki/Logitech_Media_Server) | (formerly SlimServer, SqueezeCenter and Squeezebox Server) is a streaming audio server | [Debian package](http://mysqueezebox.com/download) [Source](https://github.com/Logitech/slimserver) | [Package Draft](https://github.com/lunarok/squeezebox_ynh) | -| [Loomio](https://www.loomio.org) | | [Upstream](https://github.com/loomio/loomio/) | | -| [MaidSafe](https://maidsafe.net) | | [Upstream](https://github.com/maidsafe) | | -| [Mailpile](https://www.mailpile.is) | | [Upstream](https://github.com/mailpile/Mailpile) | | -| [Mailtrain](https://mailtrain.org/) | | [Upstream](https://github.com/Mailtrain-org/mailtrain) | | -| [Maloja](https://maloja.krateng.ch) | Self-hosted music scrobble database, alternative to Last.fm | [Upstream](https://github.com/krateng/maloja) | | -| [mautrix-discord](https://github.com/mautrix/discord) | Matrix bridge for discord | [Upstream](https://github.com/mautrix/discord) | [Package Draft](https://github.com/YunoHost-Apps/mautrix_whatsapp_ynh) | -| [Tileserver-GL](https://maps.earth/) | Tile server light SVG for map service | [Upstream](https://github.com/maptiler/tileserver-gl) | | -| [Mealie](https://hay-kot.github.io/mealie/) | Recipe manager and meal planner | [Upstream](https://github.com/hay-kot/mealie/) | | -| [Mediagoblin](https://mediagoblin.org/) | Video streaming platform | [Upstream](https://savannah.gnu.org/projects/mediagoblin) | [Package Draft](https://github.com/YunoHost-Apps/mediagoblin_ynh) | -| [medusa](https://pymedusa.com/) | Automatic TV shows downloader | | [Package Draft](https://github.com/YunoHost-Apps/medusa_ynh) | -| [Megaglest](https://megaglest.org/) | realtime stategy game | [Upstream](https://megaglest.org/linux-packages.html) | | -| microblog.pub | | [Upstream](https://github.com/tsileo/microblog.pub) | | -| [Meshery](https://meshery.io/) | Cloudnative solution to bind multiple Service-Meshes together, not only K8s | [Upstream](https://github.com/meshery/meshery) | | -| meteor-movielist | An open source web app for managing movie lists built with self-hosting in mind. Movie information is fetched from TMDb. | [Upstream](https://github.com/nunof07/meteor-movielist) | | -| [Mindustry](https://mindustrygame.github.io/) | A sandbox tower-defense game | [Upstream](https://github.com/Anuken/Mindustry) | | -| [Mirakel](https://mirakel.azapps.de/taskwarrior.html) | | [Upstream](https://github.com/GothenburgBitFactory/taskwarrior) | | -| modernpaste | A modern, feature-rich Pastebin alternative | [Upstream](https://github.com/LINKIWI/modern-paste) | [Package Draft](https://github.com/YunoHost-Apps/modernpaste_ynh) | -| [Modoboa](https://modoboa.org) | | [Upstream](https://github.com/modoboa/) | | -| [MongoPassion](https://mongopassion.24eme.fr/demo/) | Web-based project for management of MongoDB databases | [Upstream](https://github.com/24eme/MongoPassion) | | -| MotionEye | | [Upstream](https://github.com/ccrisan/motioneye) | | -| morss | Get full text RSS feeds | [Upstream](https://github.com/pictuga/morss) | | -| mumble_admin_plugin | Mumble-server web interface | | [Package Draft](https://github.com/matlink/mumble_admin_plugin_ynh) | -| munin | Resource monitoring tool | | [Package Draft](https://github.com/YunoHost-Apps/munin_ynh) | -| Museek+ | | [Upstream](https://github.com/eLvErDe/museek-plus) | | -| mycryptochat | Encrypted IM | | [Package Draft](https://github.com/mrtino/mycryptochat_ynh) | -| mx-puppet-discord | A bridge between Matrix and Discord | [Upstream](https://github.com/matrix-discord/mx-puppet-discord) | | -| [Nautilus](https://myactivity.stream/) | Turn your website into an ActivityPub profile | [Upstream](https://github.com/aaronpk/Nautilus) | | -| [Nebula](https://nebula.defined.net/docs/) | Scalable overlay networking tool with a focus on performance, simplicity and security. | [Upstream](https://github.com/slackhq/nebula) | | -| Netrunner | | [Upstream](https://github.com/mtgred/netrunner) | | -| [Netbird](https://netbird.io/) | Create an overlay peer-to-peer network connecting machines regardless of their location | [Upstream](https://github.com/netbirdio/netbird) | | -| [nostr](https://nostr.com/) | The simplest open protocol that is able to create a censorship-resistant global "social" network once for all. | [Upstream](https://github.com/nostr-protocol/nostr) || -| [Netlify CMS](https://netlifycms.org/) | A CMS for any static site generator that connects to a Gitlab/Github repo (requires netlify/gotrue) | [Upstream](https://github.com/netlify/netlify-cms) | | -| [NewsBlur](https://www.newsblur.com) | This is the most complete RSS reader that exists to date | [Upstream](https://github.com/samuelclay/NewsBlur) | | -| nexusoss | Sonatype Nexus Repository manager OSS | | [Package Draft](https://github.com/YunoHost-Apps/nexusoss_ynh) | -| [ntopng](https://www.ntop.org/) | | | [Package Draft](https://github.com/YunoHost-Apps/ntopng_ynh) | -| OhMyForm | | [Upstream](https://github.com/ohmyform) | | -| Ombi | | [Upstream](https://github.com/tidusjar/Ombi) | | -| [Omnivore](https://omnivore.app) | Omnivore is a complete, open source read-it-later solution for people who like reading. | [Upstream](https://github.com/omnivore-app/omnivore) | | -| [OpenBazaar](https://openbazaar.org) | | [Upstream](https://github.com/openbazaar) | | -| [OpenCart](https://www.opencart.com) | | [Upstream](https://github.com/opencart/opencart) | | -| [OpenEats](https://open-eats.github.io/) | | [Upstream](https://github.com/open-eats/OpenEats) | | -| [openHAB](https://www.openhab.org/) | Smart home platform | [Upstream](https://github.com/openhab) | | -| openid-simplesamlphp | OpenID provider based on SimpleSAMLphp | | [Package Draft](https://github.com/julienmalik/openid-simplesamlphp_ynh) | -| OpenSourceBilling | | [Upstream](https://github.com/vteams/open-source-billing) | | -| [osmw](https://www.openstreetmap.org/) | Cartography software | | [Package Draft](https://github.com/YunoHost-Apps/osmw_ynh) | -| OSRM | | [Upstream](https://github.com/Project-OSRM/osrm-backend) | | -| [OX Open-Xchange](https://www.open-xchange.com) | Linux groupware solution | [Upstream](https://github.com/open-xchange/) | | -| [pd3f](https://pd3f.com/) | PDF text extraction (OCR) pipeline using machine-learning | [Upstream](https://github.com/pd3f/pd3f) | | -| [Padloc](https://padloc.app/) | Simple, secure password and data management for individuals and teams | [Upstream](https://github.com/padloc/padloc) | | -| [Paperwork](https://paperwork.cloud) | | [Upstream](https://github.com/paperwork/paperwork) | | -| [Passbolt](https://www.passbolt.com) | Password manager | [Upstream](https://github.com/passbolt) | | -| Pelias | | [Upstream](https://github.com/pelias/pelias) | | -| [Penpot](https://penpot.app/) | Design Freedom for Teams | [Upstream](https://github.com/penpot) | | -| personal-management-system | Your web application for managing personal data. | [Upstream](https://github.com/Volmarg/personal-management-system) | | -| [PHPList](https://www.phplist.com) | | [Upstream](https://github.com/phpList) | | -| [Phraseanet](https://docs.phraseanet.com/3.8/fr/index.html#) | | [Upstream](https://github.com/alchemy-fr/Phraseanet-Docs) | | -| [pia](https://github.com/LINCnil/pia) | A tool to help carrying out Privacy Impact Assessments | | [Package Draft](https://github.com/YunoHost-Apps/pia_ynh) | -| [PicApport](https://www.picapport.de/) | Self-hosted private photo server | | | -| [Picsur](https://picsur.org/) | Simple open-source image host | [Upstream](https://github.com/rubikscraft/Picsur) | | -| [Pinry](https://docs.getpinry.com/) | Open source tiling image board | [Upstream](https://github.com/pinry/pinry/) | | -| [Piped](https://github.com/TeamPiped/Piped/wiki/Instances) | An open-source alternative frontend for YouTube which is efficient by design. | [Upstream](https://github.com/TeamPiped/Piped) | | -| Pol | RSS generator website | [Upstream](https://github.com/taroved/pol) | | -| [Planka](https://planka.app/) | Free open source kanban board for workgroups. | [Upstream](https://github.com/plankanban/planka) | | -| [Plausible Analytics](https://plausible.io) | Simple, Open Source, and privacy-friendly web analytics alternative to Google Analytics. | [Upstream](https://github.com/plausible/analytics) | | -| Playmaker | | [Upstream](https://github.com/NoMore201/playmaker) | | -| [plonecms](plone.org) | Create a modern website with a CMS written in Python | | [Package Draft](https://github.com/YunoHost-Apps/plonecms_ynh) | -| [Presentator](https://presentator.io/) | A design collaboration platform | | | -| [Privoxy](https://www.privoxy.org) | | | | -| [ProcessMaker](https://www.processmaker.com) | | | | -| proftpd | | | [Package Draft](https://github.com/abeudin/proftpd_ynh) | -| [ProtonMail Bridge](https://proton.me/mail/bridge) | Use Proton Mail with your email client | [Upstream](https://github.com/ProtonMail/proton-bridge) | | -| ProtonMail’s WebClient | | [Upstream](https://github.com/ProtonMail/WebClient) | | -| [Psono](https://psono.com/) | Password Manager for Teams | [Upstream](https://gitlab.com/psono/psono-server) | | -| [pterodactyl](https://pterodactyl.io/) | | | [Package Draft](https://github.com/YunoHost-Apps/pterodactyl_ynh) | -| Pump.io | File sharing and synchronization | [Upstream](https://github.com/pump-io/pump.io) | | -| [qBit MatUI](https://qbit-material-webui-demo.herokuapp.com/) | A WebUI for qBittorrent | [Upstream](https://github.com/bill-ahmed/qbit-matUI) | | -| [QGis server](https://qgis.org/fr/site/) | QGis server allows to publish QGis desktop projets and maps as OGC-compliant services, that can be used in openlayers, leaflet etc. | [Upstream](https://github.com/qgis/QGIS) | | -| [QWC2](https://github.com/qgis/qwc2) | QWC (Qgis Web Client) is a react and openlayers-based web UI to publish and display qgis desktop projects. | [Upstream](https://github.com/qgis/qwc2) | | -| [racktables](https://racktables.org) | | [Upstream](https://github.com/RackTables/racktables) | | -| Race for the galaxy | | [Upstream](https://github.com/bnordli/rftg) | | -| [Raindrop](https://raindrop.io) | All-in-one bookmark manager | [Upstream](https://github.com/raindropio/app) | | -| [Raspap](https://raspap.com/) | | [Upstream](https://github.com/RaspAP/raspap-webgui) | | -| Readarr | Book Manager and Automation (Sonarr for Ebooks) | [Upstream](https://github.com/Readarr/Readarr) | | -| Redash | Connect to any data source, easily visualize, dashboard and share your data. | [Upstream](https://github.com/getredash/redash) | | -| remoteStorage | A remoteStorage server implementation written in PHP | [Upstream](https://github.com/fkooman/php-remote-storage) | [Package Draft](https://github.com/YunoHost-Apps/RemoteStorage_ynh) | -| [Renovate](https://www.mend.io/renovate/) | Bot for automating dependency updates on Gitlab / Gitea / Forgejo | [Upstream](https://github.com/renovatebot/renovate) | | -| [Request Tracker](https://bestpractical.com) | | [Upstream](https://github.com/bestpractical/rt) | | -| [Restya](https://restya.com) | | [Upstream](https://github.com/RestyaPlatform/board/) | | -| [Retroshare](https://retroshare.cc/) | | [Upstream](https://github.com/RetroShare/RetroShare) | | -| [Revolt](https://revolt.chat/) | Chat software similar to Discord | [Upstream](https://github.com/revoltchat) | | -| [Rimgo](https://i.bcow.xyz/) | An alternative frontend for Imgur | [Upstream](https://codeberg.org/video-prize-ranch/rimgo) | | -| [roadiz](https://www.roadiz.io) | Create a modern website | | [Package Draft](https://github.com/YunoHost-Apps/roadiz_ynh) | -| rs-short | An URL shortener | [Upstream](https://git.42l.fr/42l/rs-short) | | -| RSS-proxy | RSS-proxy allows you to do create an RSS or ATOM feed of almost any website, just by analyzing just the static HTML structure. | [Upstream](https://github.com/damoeb/rss-proxy) | | -| RSSHub | open source, easy to use, and extensible RSS feed generator. It's capable of generating RSS feeds from pretty much everything | [Upstream](https://github.com/DIYgod/RSSHub) | | -| [RustDesk](https://rustdesk.com/server 'RustDesk Server') | [TeamViewer](https://teamviewer.com) alternative | [Upstream](https://github.com/rustdesk/rustdesk-server 'RustDesk Server on GitHub') and [easy install script](https://github.com/dinger1986/rustdeskinstall) | | -| rutorrent | Torrent client | | [Package Draft](https://github.com/CotzaDev/rutorrent_ynh) | -| rwtxt | Minimalist CMS | [Upstream](https://github.com/schollz/rwtxt) | | -| [SABnzbd](https://sabnzbd.org/) | The automated Usenet download tool | [Upstream](https://github.com/sabnzbd/sabnzbd) | | -| [sat](https://salut-a-toi.org) | An all-in-one tool to manage all your communications | | [Package Draft](https://github.com/YunoHost-Apps/sat_ynh) | -| [satdress] | Federated Lightning addresses server | | [Upstream](https://github.com/nbd-wtf/satdress) | -| [ScenariChain-server](https://download.scenari.software/SCENARIchain-server/) | | | | -| [Schleuder](https://schleuder.org/schleuder/docs/concept.html) | A GPG-enabled mailing list manager | | | -| scm-manager | Share and manage Git, Mercurial and Subversion repositories | | [Package Draft](https://github.com/drfred1981/scm-manager_ynh) | -| [Screego](https://screego.net/) | Screen sharing webrtc | [Upstream](https://github.com/screego/server) | | -| [Scribe](https://scribe.rip/) | An alternative frontend to Medium | [Upstream](https://git.sr.ht/~edwardloveall/scribe) | | -| [Scuttlebutt Pub](https://www.scuttlebutt.nz/contributing) | | | | -| [seenthis](https://www.seenthis.net/) | Short-blogging destiné à la veille d’actualité | | [Package Draft](https://github.com/magikcypress/seenthis_ynh) | -| [Semantic MediaWiki](https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki) | lets you store and query data with­in the [MediaWiki](https://en.wikipedia.org/wiki/MediaWiki)'s pages | [Upstream](https://github.com/SemanticMediaWiki/SemanticMediaWiki) | | -| [shadowsocks](https://shadowsocks.org) | A SOCKS5 proxy to protect your Internet traffic | | [Package Draft](https://github.com/YunoHost-Apps/shadowsocks_ynh) | -| shinken | A flexible and scalable monitoring framework | [Upstream](https://github.com/naparuba/shinken) | [Package Draft](https://github.com/YunoHost-apps/shinken_ynh) | -| sickbeard | Automatic TV show downloader | | [Package Draft](https://github.com/YunoHost-Apps/sickbeard_ynh) | -| Semaphore | A fediverse (Mastodon-API compatible) accessible, simple and fast web client client | [Upstream](https://github.com/NickColley/semaphore) | | -| [sickrage](https://sickchill.github.io/) | Automatic TV shows downloader | | [Package Draft](https://github.com/YunoHost-Apps/sickrage_ynh) | -| [Signal Proxy](https://signal.org/blog/help-iran-reconnect/) | Fight censorship and bypass traffic securely to the Signal service | [Upstream](https://github.com/signalapp/Signal-TLS-Proxy) | | -| simpad | Simple markdown editor | [Upstream](https://github.com/beli3ver/SiMPad) | [Package Draft](https://github.com/YunoHost-Apps/simpad_ynh) | -| [SimpleLogin](https://simplelogin.io) | Privacy-first e-mail forwarding and identity provider service | [Upstream](https://github.com/simple-login/app) | | -| [SimplyTranslate-Web](https://simplytranslate.org/) | This is a simple web interface for SimplyTranslate | [Upstream](https://codeberg.org/SimpleWeb/SimplyTranslate-Web) | | -| [smokeping](https://oss.oetiker.ch/smokeping/) | | [Upstream](https://github.com/oetiker/SmokePing) | | -| [SocialHome](https://socialhome.network) | A federated personal profile | [Upstream](https://github.com/jaywink/socialhome) | | -| [SparkleShare (Dazzle)](https://www.sparkleshare.org/) | SparkleShare host | [Upstream](https://github.com/hbons/Dazzle) | | -| sphinx | | [Upstream](https://github.com/sphinx-doc/sphinx) | [Package Draft](https://github.com/YunoHost-Apps/sphinx_ynh) | -| Spreed standalone signaling server (Nextcloud Talk HPB) | | [Upstream](https://github.com/strukturag/nextcloud-spreed-signaling) | | -| [Stackedit](https://stackedit.io) | | [Upstream](https://github.com/benweet/stackedit) | | -| [Storj](https://www.storj.io/node) | | [Upstream](https://github.com/storj/storj) | | -| [Strapi](https://strapi.io) | Open source Node.js Headless CMS to easily build customisable APIs | [Upstream](https://github.com/strapi/strapi) | | -| Streisand | | [Upstream](https://github.com/jlund/streisand) | | -| [Stremio](https://strem.io) Web | a modern media center. | [Upstream frontend](https://github.com/Stremio/stremio-web) [Upstream backend](https://github.com/Stremio/stremio-core-web) | | -| studs | A survey tool, the ancestor of OpenSondage | | [Package Draft](https://github.com/YunoHost-Apps/studs_ynh) | -| subsonic | Subsonic is an open source, web-based media server | | [Package Draft](https://github.com/drfred1981/subsonic_ynh) | -| Subspace | A simple WireGuard VPN server GUI | [Upstream](https://github.com/subspacecloud/subspace) | | -| SuiteCRM | An open-source CRM | [Upstream](https://github.com/salesagility/SuiteCRM) | | -| Superalgos | Free, open-source crypto trading bot, automated bitcoin / cryptocurrency trading software, algorithmic trading bots. | [Upstream](https://github.com/Superalgos/Superalgos) | | -| Sydent | Identity-serverfor matrix | [Upstream](https://github.com/matrix-org/sydent) | | -| [sympa](https://www.sympa.org/) | Mailing List manager | | [Package Draft](https://github.com/YunoHost-Apps/sympa_ynh) | -| [Syspass](https://www.syspass.org/) | | [Upstream](https://github.com/nuxsmin/sysPass) | | -| [Tahoe-LAFS](https://tahoe-lafs.org/) | Decentralized cloud storage system | [Upstream](https://github.com/tahoe-lafs/tahoe-lafs) | | -| [Taiga](https://taiga.io) | | [Upstream](https://github.com/taigaio/) | | -| [Tailscale](https://tailscale.com/) | [Wireguard](https://www.wireguard.com/)-based Mesh-VPN | [Upstream](https://github.com/tailscale/tailscale) | | -| [Takahē](https://jointakahe.org) | An efficient ActivityPub Server, for small installs with multiple domains | [Upstream](https://github.com/jointakahe/takahe) | | -| [Taskwarrior](https://taskwarrior.org) | | [Upstream](https://github.com/GothenburgBitFactory/taskwarrior) | | -| [Technitium DNS](https://technitium.com/dns/) | | [Upstream](https://github.com/TechnitiumSoftware/DnsServer) | | -| [Teddy.io](https://teedy.io/) | Document manager | [Upstream](https://github.com/sismics/docs) | | -| telegram_chatbot | Telegram chatbot - mini chatbot for Telegram | | [Package Draft](https://github.com/YunoHost-Apps/telegram_chatbot_ynh) | -| [Teleport](https://goteleport.com/) | Multi-protocol access proxy which understands SSH, HTTPS, RDP, Kubernetes API, MySQL, MongoDB and PostgreSQL wire protocols. | [Upstream](https://github.com/gravitational/teleport) | | -| TellForm | | [Upstream](https://github.com/tellform/tellform) | | -| [tes3mp](https://tes3mp.com/) | | | [Package Draft](https://github.com/YunoHost-Apps/tes3mp_ynh) | -| [Theia-IDE](https://theia-ide.org/) | VS Code-like cloud IDE |[Upstream](https://hub.docker.com/r/theiaide/theia-full)| | -| Thredded | | [Upstream](https://github.com/thredded/thredded) | | -| [Timetagger](https://timetagger.app/) | An open source time-tracker with an interactive user experience and powerful reporting. |[Upstream](https://github.com/almarklein/timetagger/)| | -| Tinylist | | [Upstream](https://github.com/baggachipz/tinylist) | | -| [TMate](https://tmate.io/) | | [Upstream](https://github.com/tmate-io/tmate) | | -| torrelay | | | [Package Draft](https://github.com/matlink/torrelay_ynh) | -| Traccar | Modern GPS Tracking Platform | [Upstream](https://github.com/traccar/traccar) | | -| transpay | Interface to receive and manage donations with Stripe | | [Package Draft](https://github.com/YunoHost-Apps/transpay_ynh) | -| transwhat | A gateway to WhatsApp from Jabber | | [Package Draft](https://github.com/Josue-T/transwhat_ynh) | -| [Tryton](https://www.tryton.org/) | A solid ERP system | | | -| [trivy](https://www.aquasec.com/products/trivy/) | OSS Vulnerability and Misconfiguration Scanning. |[Upstream](https://github.com/aquasecurity/trivy) | | -| tubesync | Syncs YouTube channels and playlists to a locally hosted media server | [Upstream](https://github.com/meeb/tubesync) | | -| tutao | End-to-end encrypted e-mail client | [Upstream](https://github.com/tutao/tutanota/) | [Package Draft](https://github.com/YunoHost-Apps/tutao_ynh) | -| [Twake](https://twake.app/fr)| All of the organizational tools you need to make your projects succeed brought together on one platform.| | | -| Twister | | [Upstream](https://github.com/miguelfreitas/twister-core/) | | -| [TwitRSS.me](https://twitrss.me/) | Create RSS feeds from Twitter | [Upstream](https://github.com/ciderpunx/twitrssme) | | -| [ultrasonics](https://github.com/XDGFX/ultrasonics) | Sync music playlists between all your music services: Spotify, Deezer, Apple Music, Plex, etc. | [Upstream](https://github.com/XDGFX/ultrasonics) | | -| [umap](https://umap.openstreetmap.fr/) | Cartography software | | [Package Draft](https://github.com/YunoHost-Apps/umap_ynh) | -| [unbound](https://nlnetlabs.nl/projects/unbound/about/) | | | [Package Draft](https://github.com/YunoHost-Apps/unbound_ynh) | -| [upmpdcli](https://www.lesbonscomptes.com/upmpdcli/) | UPNP-server and -renderer. Serves local files, internet-radio (radio-browser.info), BBC-Radio, Deezer, HighresAudio, Qobuz, Spotify and Tidal | [Upstream](https://framagit.org/medoc92/upmpdcli) | | -| [Uwazi](https://www.uwazi.io/) | | [Upstream](https://github.com/huridocs/uwazi) | | -| [Volumio](https://volumio.org) | | [Upstream](https://github.com/volumio) | | -| [Webhook.site](https://docs.webhook.site/) | | [Upstream](https://github.com/fredsted/webhook.site) | | -| [WebODF](https://webodf.org) | | [Upstream](https://github.com/webodf/WebODF) | | -| Webterminal | A web-based Jump Host / Bastion, supports VNC, SSH, RDP, Telnet, SFTP... | [Upstream](https://github.com/jimmy201602/webterminal/) | | -| [WebThings Gateway](https://iot.mozilla.org/gateway/) | | [Upstream](https://github.com/mozilla-iot/) | | -| [wg-access-server](https://github.com/freifunkMUC/wg-access-server) | VPN Server OIDC ipv4 ipv6 | [Upstream](https://github.com/freifunkMUC/wg-access-server) | | -| Whisparr | Adult movie collection manager for Usenet and BitTorrent users | [Upstream](https://github.com/Whisparr/Whisparr) | | -| Whoogle | A metasearch engine | [Upstream](https://github.com/benbusby/whoogle-search) | | -| [Wikiless](https://wikiless.org/) | A free open source alternative Wikipedia front-end focused on privacy. | [Upstream](https://codeberg.org/orenom/wikiless) | | -| [WikiSuite](https://wikisuite.org/Software) | The most comprehensive and integrated Open Source enterprise solution. | [Upstream](https://gitlab.com/wikisuite) | | -| [Winter CMS](https://wintercms.com/) | Powerful Laravel based CMS | | | -| [wildfly](https://wildfly.org) | | | [Package Draft](https://github.com/YunoHost-Apps/wildfly_ynh) | -| Wisemapping | An online mind mapping editor | [Upstream](https://bitbucket.org/wisemapping/wisemapping-open-source) | [Package Draft](https://github.com/YunoHost-Apps/wisemapping_ynh) | -| WildDuck | Opinionated email server | [Upstream](https://github.com/nodemailer/wildduck) | | -| WorkAdventure | A web-based collaborative workspace for small to medium teams | [Upstream](https://github.com/thecodingmachine/workadventure) | | -| [xBrowserSync](https://www.xbrowsersync.org/) | A self-hosted bookmark sync tool, with browser plugins and mobile clients available | [Upstream](https://github.com/xbrowsersync/api) | | -| Xibo | A FLOSS digital signage solution | [Upstream](https://github.com/xibosignage) | | -| [Xonotic](https://xonotic.org) | | [Upstream](https://gitlab.com/xonotic) | | -| [Yggdrasil](https://yggdrasil-network.github.io/) | | [Upstream](https://github.com/yggdrasil-network/yggdrasil-go) | | -| your_spotify | Self hosted Spotify tracking dashboard | [Upstream](https://github.com/Yooooomi/your_spotify) | | -| youtube-dl-webui | Web interface for youtube-dl | | [Package Draft](https://github.com/YunoHost-Apps/youtube-dl-webui_ynh) | -| yunofav | A page of favorite links | | [Package Draft](https://github.com/YunoHost-Apps/yunofav_ynh) | -| [yunohost](https://yunohost.org) | YunoHost in YunoHost, crazy :D ! | | [Package Draft](https://github.com/aymhce/yunohost_ynh) | -| [Zammad](https://zammad.org) | Zammad is a web-based, open source user support/ticketing solution | [Upstream](https://github.com/zammad/zammad) | | -| [zigbee2mqtt.io](https://www.zigbee2mqtt.io/) | [Zigbee](https://en.wikipedia.org/wiki/Zigbee)-to-[MQTT](https://en.wikipedia.org/wiki/MQTT) software-bridge supporting [more than 1000 Zigbee devices](https://www.zigbee2mqtt.io/information/supported_devices.html) | [Upstream](https://github.com/koenkk/zigbee2mqtt) | | -| [Zola](https://www.getzola.org/) | Static site generator | | | -| zomburl | An URL shortening service | | [Package Draft](https://github.com/courgette/zomburl_ynh) | -| Zoneminder | | [Upstream](https://github.com/ZoneMinder/zoneminder) | | -| [Zulip](https://zulipchat.com/) | | [Upstream](https://github.com/zulip/zulip) | | - - -### Other references listing self-hosted applications - -- [List of awesome selfhosted apps](https://github.com/Kickball/awesome-selfhosted) -- [List of awesome sysadmin apps](https://github.com/kahun/awesome-sysadmin) -- [List of awesome Node.js projects](https://github.com/sqreen/awesome-nodejs-projects) -- [List of SIP softwares/applications](https://en.wikipedia.org/wiki/List_of_SIP_software#Free_and_open-source_license) -- [Awesomeopensource.com](https://awesomeopensource.com) : topic-based list of open source projects sorted by github-stars From 0060c468bf734a22048e51eca8609365ccab189a Mon Sep 17 00:00:00 2001 From: Alexandre Aubin Date: Mon, 25 Sep 2023 22:06:13 +0200 Subject: [PATCH 3/8] apps: add an intermediate dummy 'applications' page otherwise the first page redirects to the new catalog and the menu is not displayed --- pages/04.applications/applications.md | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 pages/04.applications/applications.md diff --git a/pages/04.applications/applications.md b/pages/04.applications/applications.md new file mode 100644 index 00000000..22ca4a88 --- /dev/null +++ b/pages/04.applications/applications.md @@ -0,0 +1,10 @@ +--- +title: Applications +template: chapter +taxonomy: + category: docs +routes: + default: /applications +--- + +# Applications From 5659fee04d5dc1a627033cf5e919b95ff20b9e70 Mon Sep 17 00:00:00 2001 From: Alex Date: Thu, 28 Sep 2023 22:21:18 +0700 Subject: [PATCH 4/8] translation into Russian (#2349) * add docs.ru.md * update docs.ru.md * add overview.ru.md * update overview.md * update overview.md * update overview.ru.md * add try_yunohost.ru.md * update try_yunohost.ru.md * update try_yunohost.ru.md * update try_yunohost.ru.md * add admindoc.ru.md * update admindoc.ru.md * add how_to_host_yourself.ru.md * update how_to_host_yourself.ru.md * update how_to_host_yourself.ru.md * update how_to_host_yourself.ru.md * some updates * some fixes * (Grav GitSync) Automatic Commit from exituser * Revert "update overview.md" This reverts commit 1691a5072b902f87772caae8721cdb66231477c8. * Revert "update overview.md" This reverts commit 19eb5002ca0f743c234fd4bdf5bca1715f947471. * Revert "update overview.md" This reverts commit 1691a5072b902f87772caae8721cdb66231477c8. * Revert "update overview.md" This reverts commit 19eb5002ca0f743c234fd4bdf5bca1715f947471. * Delete pages/01.home directory * ooh.. * here we go again --------- Co-authored-by: exituser --- pages/00.home/docs.ru.md | 35 + .../05.self_hosting/self_hosting.ru.md | 46 +- .../what_is_yunohost.ru.md | 14 +- .../15.try_yunohost/try_yunohost.ru.md | 24 + pages/01.overview/overview.ru.md | 10 + .../how_to_host_yourself.ru.md | 89 ++ .../10.install/05.images/images.ru.md | 79 ++ .../finding_the_local_ip.ru.md | 62 ++ .../15.isp_box_config/isp_box_config.ru.md | 59 ++ .../10.install/20.dns_config/dns_config.ru.md | 118 +++ pages/02.administer/10.install/install.ru.md | 795 ++++++++++++++++++ pages/02.administer/admindoc.ru.md | 12 + pages/error/error.ru.md | 16 + 13 files changed, 1320 insertions(+), 39 deletions(-) create mode 100644 pages/00.home/docs.ru.md create mode 100644 pages/01.overview/15.try_yunohost/try_yunohost.ru.md create mode 100644 pages/01.overview/overview.ru.md create mode 100644 pages/02.administer/05.how_to_host_yourself/how_to_host_yourself.ru.md create mode 100644 pages/02.administer/10.install/05.images/images.ru.md create mode 100644 pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.ru.md create mode 100644 pages/02.administer/10.install/15.isp_box_config/isp_box_config.ru.md create mode 100644 pages/02.administer/10.install/20.dns_config/dns_config.ru.md create mode 100644 pages/02.administer/10.install/install.ru.md create mode 100644 pages/02.administer/admindoc.ru.md create mode 100644 pages/error/error.ru.md diff --git a/pages/00.home/docs.ru.md b/pages/00.home/docs.ru.md new file mode 100644 index 00000000..6428ad0f --- /dev/null +++ b/pages/00.home/docs.ru.md @@ -0,0 +1,35 @@ +--- +title: Добро пожаловать! +template: docs +taxonomy: + category: docs +routes: + default: '/docs' + aliases: + - '/' +visible: false +--- + +Это документация для [YunoHost, свободной операционной системы, направленной на упрощение администрирования сервера и демократизацию самостоятельного хостинга](/whatsyunohost). + +Как будущий администратор вашего собственного сервера, перейдите к [Руководству администратора](/admindoc), чтобы узнать больше о самостоятельном хостинге, о том, как установить сервер YunoHost и ваши первые приложения. + +Вы можете ознакомиться с [каталогом приложений](/apps), чтобы просмотреть приложения, которые могут быть установлены на сервере (хотя вы также можете ознакомиться с ним непосредственно из своего интерфейса администратора!) + +[Сообщество](/community) здесь для вас, если вам нужна помощь: присоединяйтесь к нам в [чат](/chat_rooms) или свяжитесь с нами на [форуме](/community/forum)! + +[center] + + Гайды для администраторов + Приложения + Сообщество + Присоединиться + +[/center] + + +[center] + Вернуться на главную +[/center] + +!!!! Для навигации по этой документации вы можете использовать клавиши со стрелками влево и вправо. Перейдите непосредственно к нужному разделу с помощью боковой панели [fa=bars /] или с помощью окна поиска [fa=search /]. Наслаждайтесь! diff --git a/pages/01.overview/05.self_hosting/self_hosting.ru.md b/pages/01.overview/05.self_hosting/self_hosting.ru.md index 8453bd6c..7f3d6802 100644 --- a/pages/01.overview/05.self_hosting/self_hosting.ru.md +++ b/pages/01.overview/05.self_hosting/self_hosting.ru.md @@ -1,5 +1,5 @@ --- -title: Самостоятельное развертывание (свой хостинг) +title: Самостоятельная развёртка template: docs taxonomy: category: docs @@ -7,44 +7,26 @@ routes: default: '/selfhosting' --- -#### Значение -**Свой хостинг** - это сервер, расположенный у вас дома и предназначенный для размещения информации для личных нужд. +Самостоятельный хостинг - это деятельность по созданию и администрированию вашего собственного сервера, как правило, дома, для самостоятельного размещения ваших персональных данных и сервисов вместо того, чтобы полагаться исключительно на третьих лиц. Например, вы можете самостоятельно разместить свой блог, чтобы он "жил" на компьютере, который вы контролируете, вместо того, чтобы размещать его на чьем-то другом компьютере (он же Облако) в обмен на деньги, рекламу или личные данные. -#### Обязанности администратора -Свой хостинг создает для вас определенные обязанности, если вы хотите разместить на нём сайт, [e-mail](/email), а также запустить [систему мгновенных сообщений](/XMPP), ваш сервер должен работать и оставаться онлайн 24/7. +Самостоятельный хостинг подразумевает владение сервером. Сервер - это компьютер, который обычно доступен в сети 24/7 и обычно не имеет экрана или клавиатуры (вместо этого он управляется удаленно). Вопреки распространенному мнению, сервер - это не обязательно огромная и сверхмощная машина: в настоящее время для самостоятельного размещения вполне достаточно небольшой платы ARM стоимостью ~ 30 долларов. -Распространенные проблемы, по причине которых сервер может быть недоступен включают в себя: отсутствие электроэнергии, потеря доступа к Интернету, итд. +Самостоятельный хостинг не предназначен для того, чтобы сделать "ваш Интернет" более безопасным, и сам по себе не обеспечивает анонимности. Вместо этого речь идет о том, чтобы быть автономным и контролировать свои сервисы и данные, что также означает нести за них ответственность. -К примеру, если вы используете [e-mail](/email) и ваш сервер по какой-то причине становится недоступен, отправленные на него сообщения будут отправлены снова только по прошествии от 3 до 7 дней. +## Почему вы должны принимать гостей сами? -#### Минусы своего хостинга -* Медленная передача данных. При использовании ADSL, скорость загрузки составляет 1/10 от скорости закачки. К примеру при скорости загрузки 1Мб/с скорость загрузки будет около 100Кб/с; -* Сервер должен быть доступен 24/7; -* Перенос данных; +- **Вы верите в свободный, открытый и децентрализованный Интернет.** В централизованном Интернете частные компании и правительство могут шпионить, анализировать людей и влиять на них, диктуя, как они взаимодействуют друг с другом, и фильтруя контент. YunoHost разработан сообществом, которое верит в открытый и децентрализованный Интернет, и мы надеемся, что вы тоже верите! -#### Плюсы своего хостинга -* Анонимность, приватность; -* Вы - единственный хозяин ваших данных и сервисов; -* Возможность децентрализации и использования распределенных сетей; +- **Вы хотите иметь контроль над своими данными и сервисами.** Вашим фотографиям, сообщениям в чате, истории посещенных страниц и тексту, который вы пишете для школы, нечего делать на чужом сервере (он же Облако). Они являются частью вашей личной жизни, но также и частью жизни вашей семьи, жизни вашего друга и так далее. Этими данными должны управлять * вы*, а не случайная компания в США, которая хочет, чтобы ваши данные анализировались и продавались результаты. -![](image://networks.png?resize=500) +- **Вы хотите узнать о том, как работают компьютеры и Интернет.** Управление собственным сервером - довольно хороший контекст для понимания основных механизмов, лежащих в основе операционных систем и Интернета. Возможно, вам придется иметь дело с интерфейсом командной строки, сетевой архитектурой, конфигурацией DNS, SSH и так далее. -#### Другие проекты, предназначенные для самостоятельного развертывания -##### В активной разработке -- [Cloudron](https://cloudron.io) -- [Cozy](https://cozy.io) -- [FreedomBox](https://wiki.debian.org/FreedomBox) -- [Libre.sh](https://github.com/indiehosters/libre.sh) -- [Puffin](http://puffin.rocks) -- [Sandstorm](https://sandstorm.io/) -- [Sovereign](https://github.com/al3x/sovereign) -- [UBOS](http://ubos.net) +- **Вы хотите исследовать новые возможности и настраивать вещи.** Вы когда-нибудь мечтали запустить сервер Minecraft для своих друзей или постоянный IRC или XMPP-клиент? Имея свой собственный сервер, вы можете вручную установить и запустить практически любую программу, которую пожелаете, и настроить все до мелочей. -##### Неподдерживаемые -- [ArkOS](http://web.archive.org/web/20170603213149/https://arkos.io/) -- [Host@home](http://web.archive.org/web/20160206150730/http://yeuxdelibad.net/Programmation/Hostathome.html) +## Почему вы * не должны* принимать гостей сами? +- **Самостоятельный хостинг требует некоторой работы и терпения.** Самостоятельный хостинг немного похож на выращивание собственного сада или овощей: это требует работы и терпения. В то время как YunoHost стремится выполнить всю тяжелую работу за вас, самостоятельный хостинг по-прежнему требует, чтобы вы потратили время на изучение и настройку нескольких вещей для правильной настройки вашего сервера. Вам также нужно будет время от времени выполнять задачи технического обслуживания (например, обновления) или обращаться за поддержкой, если что-то выйдет из строя. -#### Узнать больше -* [Decentralized Web Summit](http://www.decentralizedweb.net/) -* [Feudal Security](https://www.schneier.com/blog/archives/2012/12/feudal_sec.html) Bruce Schneier, famous security expert exposes the risks of a centralized web and the importance of civic action. +- **С отличными серверами приходит большая ответственность.** Эксплуатация сервера означает, что вы несете ответственность за данные, которые размещаете. Никто не сможет восстановить их для вас, если они потеряются. YunoHost предоставляет функции резервного копирования, которые вы должны регулярно использовать для резервного копирования нужных вам конфигураций и данных. Вам также следует следить за новостями и рекомендациями по безопасности, чтобы ваш сервер или критически важные данные не были скомпрометированы. + +- **Качество и производительность, вероятно, будут не так хороши, как услуги премиум-класса.** YunoHost (и большинство приложений, упакованных для него) - это бесплатное программное обеспечение с открытым исходным кодом, разработанное сообществами людей в свободное время и на основе наилучших усилий. Нет абсолютной гарантии, что программное обеспечение будет работать при любых возможных обстоятельствах. Производительность вашего автономного сервера также зависит от его центрального процессора и оперативной памяти, а также от доступного подключения к Интернету. \ No newline at end of file diff --git a/pages/01.overview/10.what_is_yunohost/what_is_yunohost.ru.md b/pages/01.overview/10.what_is_yunohost/what_is_yunohost.ru.md index ce471acf..c0925cf0 100644 --- a/pages/01.overview/10.what_is_yunohost/what_is_yunohost.ru.md +++ b/pages/01.overview/10.what_is_yunohost/what_is_yunohost.ru.md @@ -13,30 +13,30 @@ YunoHost это **операционная система** позволяюща ## Фичи -- ![](image://icon-debian.png?resize=32&classes=inline) Основан Debian; +- ![](image://icon-debian.png?resize=32&classes=inline) Основан на Debian; - ![](image://icon-tools.png?resize=32&classes=inline) Администрируй свой сервер через **простой веб-интерфейс** ; - ![](image://icon-package.png?resize=32&classes=inline) Развертывание **приложение за пару секунд**; - ![](image://icon-users.png?resize=32&classes=inline) Редактируй **пользователей** (основано на LDAP); - ![](image://icon-globe.png?resize=32&classes=inline) Управляй **доменными именами**; -- ![](image://icon-medic.png?resize=32&classes=inline) Создавай и восстанавливай **Бэкапы**; +- ![](image://icon-medic.png?resize=32&classes=inline) Создавай и восстанавливай **бэкапы**; - ![](image://icon-door.png?resize=32&classes=inline) Соединяй все приложения в **пользовательском портале** (NGINX, SSOwat); -- ![](image://icon-mail.png?resize=32&classes=inline) Включает **полный стэк электронной почты** (Postfix, Dovecot, Rspamd, DKIM); -- ![](image://icon-messaging.png?resize=32&classes=inline)... так-же хорошо как **встроенный сервер сообщений** (XMPP); +- ![](image://icon-mail.png?resize=32&classes=inline) Включает **полный набор для работы электронной почты** (Postfix, Dovecot, Rspamd, DKIM); +- ![](image://icon-messaging.png?resize=32&classes=inline)... более известный как **встроенный сервер сообщений** (XMPP); - ![](image://icon-lock.png?resize=32&classes=inline) Управляй **SSL сертификатами** (Основано на Let's Encrypt) ; - ![](image://icon-shield.png?resize=32&classes=inline)... и **системами безопасности** (Fail2ban, yunohost-firewall); ## История -YunoHost был создан в Феврале 2012 после чего-то типа: +YunoHost был создан в Феврале 2012 после чего-то вроде:

"Блин, Я слишком ленив чтобы перенастроить мой почтовый сервер... Beudbeud, как вам удалось запустить свой малеький сервер LDAP?"

Kload, Февраль 2012
-Всё что было нужно - админ панель для сервера Beudbeud-а чтобы сделать что-то юзабельное, поэтому Kload решил её разработать. В итоге, после автоматизации нескольких конфигураций и упаковки некоторых Веб-приложений, YunoHost v1 быз завершён. +Всё что было нужно - админ панель для сервера Beudbeud-а чтобы сделать что-то юзабельное, поэтому Kload решил её разработать. В итоге, после автоматизации нескольких конфигураций и упаковки некоторых Веб-приложений, YunoHost v1 был завершён. Заметив большое внимание вокруг YunoHost и своими серверами, первоначальные разработчики вместе с новыми помощниками решили начать работу над версией 2. Более универсальной, более мощной, более простой и всё такое. -Название **YunoHost** пришло из жаргонного "Y U NO Host". Этот [интернет мем](https://en.wikipedia.org/wiki/Internet_meme) должен проиллюстрировать это: +Название **YunoHost** пришло из жаргонного "Y U NO Host". Этот [интернет мем](https://ru.wikipedia.org/wiki/%D0%98%D0%BD%D1%82%D0%B5%D1%80%D0%BD%D0%B5%D1%82-%D0%BC%D0%B5%D0%BC) должен проиллюстрировать это: ![](image://dude_yunohost.jpg) ## Чем не является YunoHost? diff --git a/pages/01.overview/15.try_yunohost/try_yunohost.ru.md b/pages/01.overview/15.try_yunohost/try_yunohost.ru.md new file mode 100644 index 00000000..25b41708 --- /dev/null +++ b/pages/01.overview/15.try_yunohost/try_yunohost.ru.md @@ -0,0 +1,24 @@ +--- +title: Попробовать YunoHost +template: docs +taxonomy: + category: docs +routes: + default: '/try' +--- + +! Этот демонстрационный сервер может время от времени отключаться, но, по крайней мере, вы можете протестировать, и это действительно круто :) + +[center] +[columns] +[[fa=user /] Пользовательский интерфейс](https://demo.yunohost.org/?target=_blank&classes=btn,btn-lg,btn-success) +Логин: demo +Пароль: demo + +[[fa=cog /] Панель администратора](https://demo.yunohost.org/yunohost/admin/?target=_blank&classes=btn,btn-lg,btn-primary) +Пароль: demo + +[/columns] +[/center] + +!!!! **Демонстрационный сервер, любезно предоставленный [Gitoyen](https://www.gitoyen.net?target=_blank) [fa=heart /]** diff --git a/pages/01.overview/overview.ru.md b/pages/01.overview/overview.ru.md new file mode 100644 index 00000000..018d2fc4 --- /dev/null +++ b/pages/01.overview/overview.ru.md @@ -0,0 +1,10 @@ +--- +title: Обзор +template: chapter +taxonomy: + category: docs +routes: + default: /overview +--- + +# Обзор diff --git a/pages/02.administer/05.how_to_host_yourself/how_to_host_yourself.ru.md b/pages/02.administer/05.how_to_host_yourself/how_to_host_yourself.ru.md new file mode 100644 index 00000000..6ffe5c3c --- /dev/null +++ b/pages/02.administer/05.how_to_host_yourself/how_to_host_yourself.ru.md @@ -0,0 +1,89 @@ + +title: Выберите метод самостоятельной развёртки и провайдера +template: docs +taxonomy: + category: docs +routes: + default: '/howtohostyourself' +--- + +Вы можете разместить его у себя дома (на небольшом компьютере) или на удаленном сервере. У каждого решения есть свои плюсы и минусы: + +### Дома, например, на плате ARM или старом компьютере + +Вы можете запустить YunoHost у себя дома с помощью платы ARM или переоборудованного обычного компьютера, подключенного к вашему домашнему роутеру. +- **Плюсы** : у вас будет физический контроль над машиной, и вам нужно будет только купить оборудование; +- **Минусы** : вам придется [вручную настроить свой роутер](/isp_box_config) и [возможные ограничения вашим провайдером](/isp). + +### Дома, используя VPN + +VPN - это зашифрованный туннель между двумя компьютерами. На практике это делает все "как если бы" вы были напрямую, локально, подключены к своему серверному компьютеру, но на самом деле откуда-то еще в Интернете. Это позволяет вам по-прежнему разместить сервер у себя дома, обходя возможные ограничения вашего интернет-провайдера. Смотрите также [проект Internet Cube](https://internetcu.be/) и [FFDN](https://www.ffdn.org/). + +- **Плюсы** : у вас будет физический контроль над машиной, а VPN скрывает ваш трафик от вашего интернет-провайдера и позволяет вам обойти его ограничения; +- **Минусы** : вам придется оплатить ежемесячную подписку на VPN. +- +### На удалённом сервере (VPS или выделенный) + +Вы можете арендовать виртуальный частный сервер (VPS) или выделенную машину у [ассоциации](https://db.ffdn.org/) или [коммерческие](/providers/server) облачные провайдеры. + +- **Плюсы** : ваш сервер и его подключение к Интернету будут быстрыми; +- **Минусы** : вам придется платить ежемесячно за сервер и у вас не будет физического контроля над вашим сервером. + +### Суммарно + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Дома
(допустим ARM платы или старый компьютер)		Дома
используя ВПН		На удалённом сервере
(VPS или выделенный)
Стоимость оборудованияоколо 50€
(используя Raspberry Pi)		Ничего
Цена за месяцНезначительно
(только за электричество)		около 5€
(VPN)		около 3€
(VPS)
Физический контроль
к компьютеру		ДаДаНет
Требуется ли ручное управление
портами		ДаНетНет
Возможные ограничения провайдераДа
(подробнее здесь)		Обходится с помощью VPNОбычно нет
ЦПОколо ~1 GHz~2 GHz
(Сервер от Digital Ocean)
ОЗУОбычно 500 Мб или 1 ГбRelated to server cost
Интернет соединенреЗависит от домашнего ИнтернетаОбычно достаточно хорошее
\ No newline at end of file diff --git a/pages/02.administer/10.install/05.images/images.ru.md b/pages/02.administer/10.install/05.images/images.ru.md new file mode 100644 index 00000000..6c7ef88d --- /dev/null +++ b/pages/02.administer/10.install/05.images/images.ru.md @@ -0,0 +1,79 @@ +--- +title: Предустановленные образы +template: docs +taxonomy: + category: docs +routes: + default: '/images' +--- + + +Для правильного отображения этой страницы требуется включить Javascript :s. +
+
+ + +!!! Даже если изображение не соответствует последней версии YunoHost, вы все равно можете использовать его и выполнить обычное обновление системы после настройки! + +!!! Если вы хотите проверить достоверность наших подписанных изображений, вы можете [скачать наш открытый ключ](https://forge.yunohost.org/yunohost.asc). + +
+
+
+
+ + + + + diff --git a/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.ru.md b/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.ru.md new file mode 100644 index 00000000..cf90aa61 --- /dev/null +++ b/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.ru.md @@ -0,0 +1,62 @@ +--- +title: Поиск локального IP-адреса вашего сервера +template: docs +taxonomy: + category: docs +routes: + default: '/finding_the_local_ip' +--- + +При установке дома ваш сервер, как правило, должен быть доступен с использованием домена `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` +- `10.0.0.0` -> `10.0.255.255` +- `172.16.0.0` -> `172.31.255.255` + +!!! **Советы**: +!!! - вы можете сделать отсортировать по ping, как показано на этом скриншоте, чтобы легко увидеть используемый IP. +!!! - обычно ваш сервер должен отображаться как прослушивающий на портах 80 и 443 +!!! - в случае сомнений просто введите `https://192.168.x.y " в вашем браузере, чтобы проверить, является ли это YunoHost или нет. + +![](image://angryip.png?class=inline) + +[/ui-tab] +[ui-tab title="С вашим интернет-маршрутизатором"] +Подключитесь к интерфейсу вашего маршрутизатора, чтобы просмотреть список подключенных компьютеров. +[/ui-tab] +[ui-tab title="С помощью arp-scan"] +Если вы используете Linux, вы можете открыть терминал и использовать `sudo arp-scan --local`, чтобы вывести список IP-адресов в вашей локальной сети (это также может работать в Windows).; + +Если команда `arp-scan` отображает непонятное количество устройств, вы можете проверить, какие из них открыты для SSH с помощью `nmap -p 22 192.168.1.0/24`, чтобы разобраться в них (адаптируйте диапазон IP к вашей локальной сети). +[/ui-tab] +[ui-tab title="С прямым доступом к серверу"] +Подключите экран к своему серверу, войдите в систему и введите `hostname --all-ip-address`. + +Учетные данные по умолчанию (перед постустановкой!) для входа в систему: +- логин: root +- пароль: yunohost + +(Если вы используете необработанный образ Armbian вместо предустановленного образа YunoHost, учетные данные - root / 1234) + +[/ui-tab] +[/ui-tabs] + +## Я все еще не могу найти свой локальный IP-адрес + +Если вы не можете найти свой сервер, используя какой-либо из предыдущих приемов, возможно, ваш сервер загрузился неправильно: + +- Убедитесь, что ваш сервер правильно подключен; +- Если вы используете SD-карту, убедитесь, что разъем не слишком запылился; +- Подключите экран к вашему серверу и попробуйте перезагрузиться, чтобы проверить, правильно ли он загружается; +- Убедитесь, что ваш кабель Ethernet исправен и правильно подключен; \ No newline at end of file diff --git a/pages/02.administer/10.install/15.isp_box_config/isp_box_config.ru.md b/pages/02.administer/10.install/15.isp_box_config/isp_box_config.ru.md new file mode 100644 index 00000000..10390dcb --- /dev/null +++ b/pages/02.administer/10.install/15.isp_box_config/isp_box_config.ru.md @@ -0,0 +1,59 @@ +--- +title: Настройка переадресации портов +template: docs +taxonomy: + category: docs +routes: + default: '/isp_box_config' + aliases: + - '/port_forwarding' +--- + +Если вы самостоятельно размещаетесь дома и у вас нет VPN, вам необходимо перенаправить порты на вашем домашнем маршрутизаторе. В приведенном ниже наброске предпринята попытка кратко описать роль и необходимость переадресации портов при настройке сервера дома. + +[figure caption="Иллюстрация важности переадресации портов"]![](image://portForwarding_en.png)[/figure] + +### 0. Диагностировать открытые порты + +Новый инструмент диагностики, представленный в версии 3.8, можно использовать для диагностики правильности открытия портов. + +### 1. Получите доступ к интерфейсу администрирования вашего маршрутизатора + +Интерфейс администратора вашего маршрутизатора обычно доступен через [http://192.168.0.1](http://192.168.0.1) или [http://192.168.1.1](http://192.168.1.1). Затем вам, вероятно, потребуется ввести логин и пароль к панели роутера, предоставленных вашим провайдером. (P.S. возможно данные указаны на задней стороне роутера) + +### 2. Найдите локальный IP-адрес вашего сервера + +Определите, каков *локальный* IP вашего сервера, либо : +- из вашего интерфейса box / router, в котором может быть список подключенных устройств +- в веб-администраторе YunoHost, в разделе "Диагностика", "Подключение к Интернету", нажмите "Подробности" в отчете IPv4. +- из командной строки на вашем сервере, запустив `hostname -I` + +Локальный IP-адрес обычно выглядит как `192.168.xx.yy` или `10.0.xx.yy` + +Локальный IP-адрес должен быть статичным, чтобы переадресация портов, которую вы собираетесь настроить на следующем шаге, всегда достигала вашего сервера. Вы должны зайти в свой маршрутизатор и убедиться, что локальный IP-адрес вашего сервера является статическим, а не динамическим. + +### 3. Переадресация портов + +В интерфейсе администратора вашего маршрутизатора найдите что-то вроде "конфигурация маршрутизатора" или "переадресация портов". Названия различных типов коробок различаются. + +Открытие перечисленных ниже портов необходимо для работы различных сервисов, доступных в YunoHost. Для каждого из них необходима переадресация "TCP". Некоторые интерфейсы относятся к "внешним" и "внутренним" портам: в нашем случае это одно и то же. + +* Веб: 80 (HTTP), 443 (HTTPS) +* [SSH](/ssh): 22 +* [XMPP](/XMPP): 5222 (клиенты), 5269 (серверы) +* [Почтовые](/email): 25, 587 (SMTP), 993 (IMAP) + +Если вы используете и модем, и маршрутизатор, то вам необходимо выполнить следующее: +1. сначала на модеме (поле, расположенном ближе всего к Интернету) создайте правила для перенаправления вышеуказанных портов на ваш маршрутизатор; +2. затем на маршрутизаторе (поле между модемом и вашими устройствами) создайте правила для пересылки вышеуказанных портов на статический IP-адрес вашего сервера. + +! [fa=exclamation-triangle /] Некоторые интернет-провайдеры по умолчанию блокируют порт 25 (почтовый SMTP) для борьбы со спамом. Некоторые другие интернет-провайдеры не позволяют свободно использовать порт 80/443 (веб), хотя это менее вероятно. В зависимости от провайдера, возможно, удастся открыть их в интерфейсе администратора... Проверьте [this page](/isp) для получения дополнительной информации. + +## Автоматическая переадресация портов / UPnP + +Технология, называемая UPnP, доступна на некоторых интернет-блоках / маршрутизаторах и позволяет автоматически перенаправлять порты тому компьютеру, который в них нуждается. Если UPnP включен в вашей локальной сети, то выполнение этой команды должно автоматически открыть порт для вас : + +```bash +sudo yunohost firewall reload +``` + diff --git a/pages/02.administer/10.install/20.dns_config/dns_config.ru.md b/pages/02.administer/10.install/20.dns_config/dns_config.ru.md new file mode 100644 index 00000000..1e3238c6 --- /dev/null +++ b/pages/02.administer/10.install/20.dns_config/dns_config.ru.md @@ -0,0 +1,118 @@ +--- +title: Конфигурация зоны DNS +template: docs +taxonomy: + category: docs +routes: + default: '/dns_config' + aliases: + - '/dns' +--- + +DNS (система доменных имен) - это система, которая преобразует удобочитаемые адреса +(доменные имена) в адреса, понятные машине (IP). Чтобы ваш сервер был +легко доступен людям, а некоторые службы, такие как почта, работали +должным образом, необходимо настроить DNS. + +Если вы используете [автоматический домен](/dns_nohost_me), предоставляемый проектом YunoHost, настройка должна +выполняться автоматически. Если вы используете свое собственное доменное имя (например, купленное через +регистратора), вам следует вручную настроить свой домен в +интерфейсе вашего регистратора. + +## Рекомендуемая конфигурация DNS + +ПРИМЕЧАНИЕ: В примерах здесь используется заполнитель `your.domain.tld`, вы должны заменить его своим реальным доменом, например `www.yunohost.org`. + +YunoHost предоставляет рекомендуемую конфигурацию DNS, доступную через: +- веб-администратор, Домены > `your.domain.tld` > DNS; +- или в командной строке: `yunohost domain dns-conf your.domain.tld` + +Для конкретных нужд или конкретных настроек, и если вы знаете, что делаете, вы +можете захотеть или быть вынуждены изменить их или добавить дополнительные (например, для обработки +поддоменов). + +Рекомендуемая конфигурация обычно выглядит следующим образом: + +```bash +# +# Базовые ipv4/ipv6 записи +# +@ 3600 IN A 111.222.33.44 +* 3600 IN A 111.222.33.44 + +# (Если ваш сервер поддерживает IPv6, есть несколько записей AAAA) +@ 3600 IN AAAA 2222:444:8888:3333:bbbb:5555:3333:1111 +* 3600 IN AAAA 2222:444:8888:3333:bbbb:5555:3333:1111 + +# +# XMPP +# +_xmpp-client._tcp 3600 IN SRV 0 5 5222 your.domain.tld. +_xmpp-server._tcp 3600 IN SRV 0 5 5269 your.domain.tld. +muc 3600 IN CNAME @ +pubsub 3600 IN CNAME @ +vjud 3600 IN CNAME @ +xmpp-upload 3600 IN CNAME @ + +# +# Почтовые (MX, SPF, DKIM and DMARC) +# +@ 3600 IN MX 10 your.domain.tld. +@ 3600 IN TXT "v=spf1 a mx -all" +mail._domainkey 3600 IN TXT "v=DKIM1; k=rsa; p=someHuuuuuuugeKey" +_dmarc 3600 IN TXT "v=DMARC1; p=none" +``` + +Хотя, возможно, было бы легче понять это, если бы оно отображалось следующим образом: + + +| Тип | Название | Значение | +| :-----: | :--------------------: | :--------------------------------------------------: | +| **A** | **@** | `111.222.333.444` (ваш IPv4) | +| A | * | `111.222.333.444` (ваш IPv4) | +| AAAA | @ | `2222:444:8888:3333:bbbb:5555:3333:1111` (ваш IPv6) | +| AAAA | * | `2222:444:8888:3333:bbbb:5555:3333:1111` (ваш IPv6) | +| **SRV** | **_xmpp-client._tcp** | `0 5 5222 your.domain.tld.` | +| **SRV** | **_xmpp-server._tcp** | `0 5 5269 your.domain.tld.` | +| CNAME | muc | `@` | +| CNAME | pubsub | `@` | +| CNAME | vjud | `@` | +| CNAME | xmpp-upload | `@` | +| **MX** | **@** | `your.domain.tld.` (с приоритетом: 10) | +| TXT | @ | `"v=spf1 a mx -all"` | +| TXT | mail._domainkey | `"v=DKIM1; k=rsa; p=someHuuuuuuugeKey"` | +| TXT | _dmarc | `"v=DMARC1; p=none"` | + +#### Несколько замечаний по поводу этой таблицы + +- Не все эти строки абсолютно необходимы. Для минимальной настройки вам понадобятся только записи, выделенные жирным шрифтом. +- Точка в конце `ваш.домен.tld.` важна ;); +- `@` соответствует `your.domain.tld`, и, например, `muc` соответствует `muc.your.domain.tld`; +- Это примерные значения! Смотрите сгенерированный вами 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 + +### Обратный DNS + +Если ваш интернет-провайдер или VPS-провайдер позволяет вам определить [обратный +поиск DNS](https://ru.wikipedia.org/wiki/%D0%9E%D0%B1%D1%80%D0%B0%D1%82%D0%BD%D1%8B%D0%B9_%D0%BF%D1%80%D0%BE%D1%81%D0%BC%D0%BE%D1%82%D1%80_DNS) для ваших общедоступных IPv4 +и/или IPv6-адресов вы должны настроить его. Это предотвратит пометку вас +антиспам-фильтрами как нежелательные письма. + +**Примечание: обратная настройка DNS выполняется у вашего интернет-провайдера или VPS-провайдера. Это *не* обрабатывается регистратором вашего домена.** + +Если ваш общедоступный IPv4-адрес `111.222.333.444`, а ваш DNS +-домен - `domain.tld`, вы должны получить следующий ответ при использовании +командной строки `nslookup`: + +```shell +$ nslookup 111.222.333.444 +444.333.222.111.in-addr.arpa name = domain.tld. +``` + +Система диагностики, доступная в webadmin, выполняет эту проверку автоматически (в разделе Электронная почта). + +### Динамический IP-адрес + +Если ваш глобальный IP-адрес постоянно меняется, следуйте этому [руководству](/dns_dynamic_ip). diff --git a/pages/02.administer/10.install/install.ru.md b/pages/02.administer/10.install/install.ru.md new file mode 100644 index 00000000..922ab16a --- /dev/null +++ b/pages/02.administer/10.install/install.ru.md @@ -0,0 +1,795 @@ +--- +title: Установка YunoHost +template: docs +taxonomy: + category: docs +never_cache_twig: true +twig_first: true +process: + markdown: true + twig: true +page-toc: + active: true + depth: 2 +routes: + default: '/install' + aliases: + - '/install_iso' + - '/install_on_vps' + - '/install_manually' + - '/install_on_raspberry' + - '/install_on_arm_board' + - '/install_on_debian' + - '/install_on_virtualbox' + - '/plug_and_boot' + - '/burn_or_copy_iso' + - '/boot_and_graphical_install' + - '/postinstall' + - '/hardware' +--- +{% set image_type = 'YunoHost' %} +{% set arm, at_home, regular, rpi34, rpi012, show_legacy_arm_menu, arm_sup, arm_unsup, vps, vps_debian, vps_ynh, virtualbox, wsl, internetcube = false, false, false, false, false, false, false, false, false, false, false, false, false, false %} +{% set hardware = uri.param('hardware') %} + +{% if hardware == 'regular' %} + {% set regular = true %} +{% elseif hardware == 'internetcube' %} + {% set arm, arm_sup, internetcube = true, true, true %} + {% set image_type = 'Internet Cube' %} + {% set show_legacy_arm_menu = true %} +{% elseif hardware == 'rpi34' %} + {% set arm, rpi34 = true, true %} +{% elseif hardware == 'rpi012' %} + {% set arm, arm_unsup, rpi012 = true, true, true %} + {% set image_type = 'Raspberry Pi OS Lite (32-bit, Bullseye)' %} +{% elseif hardware == 'arm_sup' %} + {% set arm, arm_sup = true, true %} + {% set show_legacy_arm_menu = true %} +{% elseif hardware == 'arm' %} + {% set arm, arm_unsup = true, true %} + {% set image_type = 'Armbian' %} +{% elseif hardware == 'arm_unsup' %} + {% set arm, arm_unsup = true, true %} + {% set show_legacy_arm_menu = true %} + {% set image_type = 'Armbian' %} +{% elseif hardware == 'vps_debian' %} + {% set vps, vps_debian = true, true %} +{% elseif hardware == 'vps_ynh' %} + {% set vps, vps_ynh = true, true %} +{% elseif hardware == 'virtualbox' %} + {% set at_home, virtualbox = true, true %} +{% elseif hardware == 'wsl' %} + {% set wsl = true %} +{% endif %} + +{% if arm or regular %} + {% set at_home = true %} +{% endif %} + +Выберите оборудование, на которое вы хотите установить 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) +[/div] + +[div class="flex-child hardware{%if rpi012 or rpi34 %} active{% endif %}"] +[[figure caption="Raspberry Pi"]![](image://raspberrypi.png?height=75)[/figure]](/install/hardware:rpi34) +[/div] + +[div class="flex-child hardware{%if arm_sup or (arm_unsup and not rpi012) or internetcube %} active{% endif %}"] +[[figure caption="ARM платы"]![](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) +[/div] + +[div class="flex-child hardware{%if wsl %} active{% endif %}"] +[[figure caption="WSL"]![](image://wsl.png?height=75)[/figure]](/install/hardware:wsl) +[/div] + +[div class="flex-child hardware{%if vps_debian or vps_ynh %} active{% endif %}"] +[[figure caption="Удалённый сервер"]![](image://vps.png?height=75)[/figure]](/install/hardware:vps_debian) +[/div] + +[/div] +[div class="flex-container pt-2"] + +{% if rpi012 or rpi34 %} +[div class="flex-child hardware{%if rpi34 %} active{% endif %}"] +[[figure caption="Raspberry Pi 3 или 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) +[/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) +[/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) +[/div] + +[div class="flex-child hardware{%if arm_unsup %} active{% endif %}"] +[[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) +[/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) +[/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 +{% elseif rpi012 %} +* Raspberry Pi 0, 1 или 2 с ОЗУ не менее 512 МБ +{% elseif internetcube %} +* Orange Pi PC+ или Olinuxino Lime 1 или 2 +* VPN с выделенным общедоступным IP-адресом и файлом `.cube` +{% elseif arm_sup %} +* Orange Pi PC+ или Olinuxino Lime 1 или 2 +{% elseif arm_unsup %} +* Плата ARM с объемом оперативной памяти не менее 512 МБ +{% elseif vps_debian %} +* Выделенный или виртуальный частный сервер с Debian 11 (Bullseye) (с **kernel >= 3.12**) предустановленный, 512 МБ оперативной памяти и емкость 16 ГБ (не менее) +{% elseif vps_ynh %} +* Выделенный или виртуальный частный сервер с предустановленным YunoHost, 512 МБ оперативной памяти и емкостью не менее 16 ГБ +{% elseif virtualbox %} +* Компьютер x86 с [установленным VirtualBox](https://www.virtualbox.org/wiki/Downloads) и достаточный объем оперативной памяти, чтобы иметь возможность запускать небольшую виртуальную машину с 1024 МБ оперативной памяти и емкостью 8 ГБ (как минимум). +{% endif %} +{% if arm %} +*Источник питания (либо адаптер, либо кабель microUSB) для вашей платы; +* Карта microSD: емкость 16 ГБ (не менее), [класса "A1"](https://club.dns-shop.ru/blog/t-127-kartyi-pamyati/59683-klassyi-skorosti-kart-pamyati-kak-razobratsya-i-chto-brat/#sub_Klass__skorosti__dlya__rabotyi__s__prilojeniyami) настоятельно рекомендуется (например, [эта SanDisk A1 карта](https://www.dns-shop.ru/product/dd976fc32e66ed20/karta-pamati-sandisk-ultra-microsdxc-64-gb-sdsqua4-064g-gn6mn/)); +{% endif %} +{% if regular %} +* USB-накопитель емкостью не менее 1 ГБ или стандартный чистый компакт-диск +{% endif %} +{% if wsl %} +* Windows 10 и выше +* Права администратора +* Подсистема Windows для Linux, устанавливаемая из *Включение или отключение компонентов Windows* +* *Рекомендуется:* Приложение Windows Terminal (предварительный просмотр), установленное из магазина Microsoft Store. Намного лучше, чем стандартный терминал, поскольку он предлагает быстрые пути к дистрибутивам WSL. +{% endif %} +{% if at_home %} +* [хороший Интернет-провайдер](/isp), предпочтительно с хорошей и неограниченной восходящей полосой пропускания +{% if not virtualbox %} +* Кабель Ethernet (RJ-45) для подключения вашего сервера к маршрутизатору. {% if rpi012 %} (Или, для Rasperry Pi Zero: и USB OTG или wifi-адаптер) {% endif %} +{% endif %} +* Компьютер, чтобы прочитать это руководство, прошейте изображение и получите доступ к вашему серверу. +{% else %} +* Компьютер или смартфон, чтобы прочитать это руководство и получить доступ к вашему серверу. +{% endif %} + +{% if virtualbox %} +! Примечание: Установка YunoHost в VirtualBox обычно предназначена для тестирования или разработки. Запускать реальный сервер в долгосрочной перспективе неудобно, потому что машина, на которой он установлен, вероятно, не будет работать круглосуточно, а также потому, что Virtualbox добавляет дополнительный уровень сложности при подключении машины к Интернету. +{% 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. + +! Bear in mind, this setup itself is *not* a container of any kind. If something breaks, there is no rollback capability. +! You may need to delete the Debian distro altogether and restore it whole. + +## Install Debian 11 + +Let's install YunoHost into its own distro, not altering the default one. In a PowerShell terminal: + +```bash +# Let's go in your home directory and prepare the working directories +cd ~ +mkdir -p WSL\YunoHost +# Download the Debian appx package and unzip it +curl.exe -L -o debian.zip https://aka.ms/wsl-debian-gnulinux +Expand-Archive .\debian.zip -DestinationPath .\debian +# Import the Debian base into a new distro +wsl --import YunoHost ~\WSL\YunoHost ~\debian\install.tar.gz --version 2 +# Cleanup +rmdir .\debian -R +``` + +You can now access it: run `wsl.exe -d YunoHost` + +It is under Debian 9 Stretch, so let's upgrade it: + +```bash +# In WSL +sudo sed -i 's/stretch/bullseye/g' /etc/apt/sources.list` +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: + +``` +[network] +generateHosts = false +generateResolvConf = false +``` + +## Force the use of iptables-legacy + +Somehow the YunoHost post-installation does not like `nf_tables`, the new software replacing `iptables`. +We can still explicitely use the good ol' `iptables` though: + +```bash +# In WSL +sudo update-alternatives --set iptables /usr/sbin/iptables-legacy +sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy +``` + +## Install Systemd + +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 +sudo dpkg -i packages-microsoft-prod.deb +sudo apt update +sudo apt install -y apt-transport-https +sudo apt update +sudo apt install -y dotnet-sdk-3.1 +``` + +2. Install [Genie](https://github.com/arkane-systems/genie): +```bash +# In WSL +# Add their repository +echo "deb [trusted=yes] https://wsl-translinux.arkane-systems.net/apt/ /" > /etc/apt/sources.list.d/wsl-translinux.list +# Install Genie +sudo apt update +sudo apt install -y systemd-genie +``` + +## Install YunoHost + +```bash +# In WSL +# Let's switch to the root user, if you were not already +sudo su +# Initialize the Genie bottle to have systemd running +genie -s +# Your hostname should have been appended with "-wsl" +# Install YunoHost +curl https://install.yunohost.org | bash -s -- -a +``` + +### Access the command line + +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: + +``` +cd ~ +wsl --export YunoHost .\WSL\YunoHost.tar.gz +``` + +### In case of crash, delete and restore the whole distro + +``` +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 : + +[div class="flex-container"] + +[div class="flex-child"] +[[figure caption="Alsace Réseau Neutre - FR"]![](image://vps_ynh_arn.png?height=50)[/figure]](https://vps.arn-fai.net) +[/div] +[div class="flex-child"] +[[figure caption="FAImaison - FR"]![](image://vps_ynh_faimaison.svg?height=50)[/figure]](https://www.faimaison.net/services/vm.html) +[/div] +[div class="flex-child"] +[[figure caption="Association ECOWAN - FR"]![](image://vps_ynh_ecowan.png?height=50)[/figure]](https://www.ecowan.fr/vps-linux) +[/div] +[/div] +{% endif %} + + +{% if at_home %} +## [fa=download /] Download the {{image_type}} image + +{% if rpi012 %} +! Support for Rasperry Pi 0, 1 and 2 is unfortunately slowly dropping : building fresh images is complex, and RPi 0, 1 and 2 are ARM-32bit systems which will get more and more deprecated over time. Our pre-installed images are quite old. We recommend instead to [download the official Rasperry Pi OS Lite (**32-bit**, **Bullseye**)](https://downloads.raspberrypi.org/raspios_lite_armhf/images/?C=M;O=D) and installing YunoHost on top [using similar instructions as for other ARM boards](/install/hardware:arm) +{% endif %} + +{% if virtualbox or regular %} +!!! If your host OS is 32 bits, be sure to download the 32-bit image. +{% elseif arm_unsup and not rpi012 %} +[fa=external-link] Download the image for your board on Armbian's website + +!!! N.B.: you should download the image Armbian Bullseye. +{% endif %} + +!!! If you wish to check the validity of our signed images, you can [download our public key](https://forge.yunohost.org/yunohost.asc). + +{% if internetcube or arm_sup %} +! Current images are from Debian Buster (YunoHost v4.x) and will require that you perform a manual apt update command in SSH or CLI to continue updating. +! Answer Yes to the warning about switching from stable to oldstable. +{% endif %} + +
+
+
+
+ + + + + + + + +{% 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 %} + +[ui-tabs position="top-left" active="0" theme="lite"] +[ui-tab title="(Recommended) With Etcher"] + +Download Etcher for your operating system and install it. + +Plug your {% if arm %}SD card{% else %}USB stick{% endif %}, select your image and click "Flash" + +![Etcher](image://etcher.gif?resize=700&class=inline) + +[/ui-tab] +[ui-tab title="With USBimager"] + +Download [USBimager](https://bztsrc.gitlab.io/usbimager/) for your operating system and install it. + +Plug your {% if arm %}SD card{% else %}USB stick{% endif %}, select your image and click "Write" + +![USBimager](image://usbimager.png?resize=700&class=inline) + +[/ui-tab] +[ui-tab title="With dd"] + +If you are on GNU/Linux / macOS and know your way around command line, you may also flash your USB stick or SD card with `dd`. You can identify which device corresponds to your USB stick or SD card with `fdisk -l` or `lsblk`. A typical SD card name is something like `/dev/mmcblk0`. BE CAREFUL and make sure you got the right name. + +Then run : + +```bash +# 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"] +For older devices, you might want to burn a CD/DVD. The software to use depends on your operating system. + +* On Windows, use [ImgBurn](http://www.imgburn.com/) to write the image file on the disc + +* On macOS, use [Disk Utility](http://support.apple.com/kb/ph7025) + +* On GNU/Linux, you have plenty of choices, like [Brasero](https://wiki.gnome.org/Apps/Brasero) or [K3b](http://www.k3b.org/) +[/ui-tab] +{% endif %} +[/ui-tabs] + +{% else %} + +## Create a new virtual machine + +![](image://virtualbox_1.png?class=inline) + +! It's okay if you can only have 32-bit versions, just be sure that you downloaded the 32-bit image previously. + +## Tweak network settings + +! This step is important to properly expose the virtual machine on the network + +Go to **Settings** > **Network**: + +* Select `Bridged adapter` +* Select your interface's name: + **wlan0** if you are connected wirelessly, or **eth0** otherwise. + +![](image://virtualbox_2.png?class=inline) + +{% endif %} + + + + + + + + + +{% if arm %} +## [fa=plug /] Power up the board + +* Plug the ethernet cable (one side on your main router, the other on your board). + * For advanced users willing to configure the board to connect to WiFi instead, see for example [here](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md). +* Plug the SD card in your board +* (Optional) You can connect a screen+keyboard directly on your board if you want to troubleshoot the boot process or if you're more comfortable to "see what happens" or want a direct access to the board. +* Power up the board +* Wait a couple minutes while the board autoconfigure itself during the first boot +* 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. + +![](image://virtualbox_2.1.png?class=inline) + +! 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). +* Boot up your server with the USB stick or a CD-ROM inserted, and select it as **bootable device** by pressing one of the following keys (hardware specific): +``, ``, ``, ``, `` or ``. + * N.B. : if the server was previously installed with a recent version of Windows (8+), you first need to tell Windows, to "actually reboot". This can be done somewhere in "Advanced startup options". +{% endif %} + +{% if regular or virtualbox %} +## [fa=rocket /] Launch the graphical install + +You should see a screen like this: + +[figure class="nomargin" caption="Preview of the ISO menu"] +![](image://virtualbox_3.png?class=inline) +[/figure] +[ui-tabs position="top-left" active="0" theme="lite"] + +[ui-tab title="Installation classique sur un disque entier"] + +!! N.B.: Once you have validated the keyboard layout, the installation will be launched and will completely erase the data on your hard disk! + + 1. Select `Graphical install` + 2. Select your language, your location, your keyboard layout, and eventually your timezone. + 3. The installer will then download and install all required packages. + +[/ui-tab] +[ui-tab title="Installation in expert mode"] + +The YunoHost project simplified the classic installation as much as possible in order to avoid as many people as possible being lost with questions that are too technical or related to specific cases. + +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: + 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. + 4. Specify a possible HTTP proxy to use for the installation of the packages + 5. Specify on which volumes grub should be installed + +### Regarding partitioning + +In general, we recommend against partitioning `/var`, `/opt`, `/usr`, `/bin`, `/etc`, `/lib`, `/tmp` and `/root` on separate partitions. This will prevent you from having to worry about full partitions that could crash your machine, cause app installations to fail, or even corrupt your databases. + +For performance reasons, it is recommended to mount your fastest storage (SSD) on the root `/`. + +If you have one or more hard drives to store data, you can choose to mount it on one of these folders depending on your usage. + +| Path | Contents | +|--------|---| +| `/home` | User folders accessible via SFTP | +| `/home/yunohost.backup/archives` | YunoHost backups to be placed ideally elsewhere than on the disks that manage the data | +| `/home/yunohost.app` | Heavy data from YunoHost applications (nextcloud, matrix...) | +| `/home/yunohost.multimedia` | Heavy data shared between several applications | +| `/var/mail` | User mail + +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 + +[/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} +ln -s /usr/bin/true /usr/bin/metronome +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 +``` + +! 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`. + +``` +ssh root@192.168.x.xxx +``` + +{% endif %} + +{% 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: + +```bash +curl https://install.yunohost.org | bash +``` + +!!! If `curl` is not installed on your system, you might need to install it with `apt install curl`. +!!! Otherwise, if the command does not do anything, you might want to `apt install ca-certificates` + +!!! **Note for advanced users concerned with the `curl|bash` approach:** consider reading ["Is curl|bash insecure?"](https://sandstorm.io/news/2015-09-24-is-curl-bash-insecure-pgp-verified-install) on Sandstom's blog, and possibly [this discussion on Hacker News](https://news.ycombinator.com/item?id=12766350&noprocess). + +{% endif %} + +## [fa=cog /] Proceed with the initial configuration + +!!! If you are in the process of restoring a server using a YunoHost backup, you should skip this step and instead [restore the backup instead of the postinstall step](/backup#restoring-during-the-postinstall). + +[ui-tabs position="top-left" active="0" theme="lite"] +[ui-tab title="From the web interface"] +{%if at_home %} +In an internet browser, type **{% if internetcube %}`https://internetcube.local`{% else %}`https://yunohost.local` (or `yunohost-2.local`, and so on if multiple YunoHost servers are on your network){% endif %}**. + +!!! If this doesn't work, you can [look for the the local IP address of your server](/finding_the_local_ip). The address typically looks like `192.168.x.y`, and you should therefore type `https://192.168.x.y` in your browser's address bar. +{% else %} +You can perform the initial configuration with the web interface by typing in the address bar of your web browser **the public IP address of your server**. Typically, your VPS provider should have provided you with the IP of the server. +{% endif %} + +! During the first visit, you will very likely encounter a security warning related to the certificate used by the server. For now, your server uses a self-signed certificate. {% if not wsl %}You will later be able to add a certificate automatically recognized by web browsers as described in the [certificate documentation](/certificate). {% endif %} For now, you should add a security exception to accept the current certificate. (Though, PLEASE, do not take the habit of blindly accepting this kind of security alert!) + +{% if not internetcube %} +You should then land on this page : + +[figure class="nomargin" caption="Preview of the Web initial configuration page"] +![Initial configuration page](image://postinstall_web.png?resize=100%&class=inline) +[/figure] + +{% endif %} +[/ui-tab] +[ui-tab title="From the command line"] + +You can also perform the postinstallation with the command `yunohost tools postinstall` directly on the server, or [via SSH](/ssh). + +[figure class="nomargin" caption="Preview of the command-line post-installation"] +![Initial configuration with CLI](image://postinstall_cli.png?resize=100%&class=inline) +[/figure] + +[/ui-tab] +[/ui-tabs] + +{% if not internetcube %} + +##### [fa=globe /] Main domain + +This will be the domain used by your server's users to access the **authentication portal**. You can later add other domains, and change which one is the main domain if needed. + +{% if not wsl %} + +* If you're new to self-hosting and do not already have a domain name, we recommend using a **.nohost.me** / **.noho.st** / **.ynh.fr** (e.g. `homersimpson.nohost.me`). Provided that it's not already taken, the domain will be configured automatically and you won't need any further configuration step. Please note that the downside is that you won't have full-control over the DNS configuration. + +* If you already own a domain name, you probably want to use it here. You will later need to configure DNS records as explained [here](/dns_config). + +!!! Yes, you *have to* configure a domain name. If you don't have any domain name and don't want a **.nohost.me** / **.noho.st** / **.ynh.fr** either, you can set up a dummy domain such as `yolo.test` and tweak your **local** `/etc/hosts` file such that this dummy domain [points to the appropriate IP, as explained here](/dns_local_network). + +{% else %} + +You will have to choose a fake domain, since it will not be accessible from outside. +For example, `ynh.wsl`. The tricky part is advertising this domain to your host. + +Alter your `C:\Windows\System32\drivers\etc\hosts` file. You should have a line starting by `::1`, update it or add it if needed to get: + +``` +::1 ynh.wsl localhost +``` + +If you want to create subdomains, do not forget to add them in the `hosts` file too: + +``` +::1 ynh.wsl subdomain.ynh.wsl localhost +``` + +{% endif %} + +##### [fa=key /] First user + +[Since YunoHost 11.1](https://forum.yunohost.org/t/yunohost-11-1-release-sortie-de-yunohost-11-1/23378), the first user is now created at this stage. You should pick a username and a reasonably complex password. (We cannot stress enough that the password should be **robust**!) This user will be added to the Admins group, and will therefore be able to access the user portal, the web admin interface, and connect [via **SSH**](/ssh) or [**SFTP**](/filezilla). Admins will also receive emails sent to `root@yourdomain.tld` and `admin@yourdomain.tld` : these emails may be used to send technical informations or alerts. You can later add additional users, which you can also add to the Admins group. + +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. + +{% if wsl %} +! Reminder: YunoHost in WSL will likely not be reachable from outside, and real domains and certificates won't be able to be assigned to it. +{% endif %} +{% if virtualbox %} +! Reminder: YunoHost in VirtualBox will likely not be reachable from outside without further network configuration in Virtualbox's settings. The diagnosis will probably complain about this. +{% endif %} + +The diagnosis system is meant to provide an easy way to validate that all critical aspects of your server are properly configured - and guide you in how to fix issues. The diagnosis will run twice a day and send an alert if issues are detected. + +!!! N.B. : **don't run away** ! The first time you run the diagnosis, it is quite expected to see a bunch of yellow/red alerts because you typically need to [configure DNS records](/dns_config) (if not using a `.nohost.me`/`noho.st`/`ynh.fr` domain), add a swapfile if not enough ram {% if at_home %} and/or [port forwarding](/isp_box_config){% endif %}. + +!!! If an alert is not relevant (for example because you don't intend on using a specific feature), it is perfectly fine to flag the issue as 'ignored' by going in the webadmin > Diagnosis, and clicking the ignore button for this specifc issue. + +[ui-tabs position="top-left" active="0" theme="lite"] +[ui-tab title="(Recommended) From the web interface"] +To run a diagnosis, go on Web Admin in the Diagnosis section. Click Run initial diagnosis and you should get a screen like this : + +[figure class="nomargin" caption="Preview of the diagnostic panel"] +![](image://diagnostic.png?resize=100%&class=inline) +[/figure] + +[/ui-tab] +[ui-tab title="From the command line"] +``` +yunohost diagnosis run +yunohost diagnosis show --issues --human-readable +``` +[/ui-tab] +[/ui-tabs] + +## [fa=lock /] Get a Let's Encrypt certificate + +Once you configured DNS records and port forwarding (if needed), you should be able to install a Let's Encrypt certificate. This will get rid of the spooky security warning from earlier for new visitors. + +For more detailed instructions, or to lean more about SSL/TLS certificates, see [the corresponding page here](/certificate). + +[ui-tabs position="top-left" active="0" theme="lite"] +[ui-tab title="From the web interface"] + +Go in Domains > Click on your domain > SSL Certificate + +[figure class="nomargin" caption="Preview of the diagnostic panel"] +![](image://certificate-before-LE.png?resize=100%&class=inline) +[/figure] + +[/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! + +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) ! + +{% endif %} +{% endif %} diff --git a/pages/02.administer/admindoc.ru.md b/pages/02.administer/admindoc.ru.md new file mode 100644 index 00000000..db29f4d9 --- /dev/null +++ b/pages/02.administer/admindoc.ru.md @@ -0,0 +1,12 @@ +--- +title: Руководство для администраторов +template: chapter +taxonomy: + category: docs +routes: + default: '/admindoc' +--- + +### Управление + +# Узнайте о самостоятельном хостинге, о том, как установить и использовать YunoHost diff --git a/pages/error/error.ru.md b/pages/error/error.ru.md new file mode 100644 index 00000000..95b049e8 --- /dev/null +++ b/pages/error/error.ru.md @@ -0,0 +1,16 @@ +--- +title: Страница не найдена +robots: noindex,nofollow +template: error +routable: false +http_response_code: 404 +twig_first: true +process: + twig: true +expires: 0 +--- + +## Упс. Похоже, этой страницы не существует... пока! + + Вы можете внести свой вклад в документацию, выполнив +Редактирование этого! From d7f8d84cf9f4729206a877be512b39c3296b4f05 Mon Sep 17 00:00:00 2001 From: Totor <86886856+T-otor@users.noreply.github.com> Date: Thu, 28 Sep 2023 23:12:08 +0200 Subject: [PATCH 5/8] =?UTF-8?q?Mis=20=C3=A0=20jour=20"ECOWAN"=20(#2352)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Retrait du mot association. Ce projet n'est plus une association à loi 1901 --- pages/02.administer/10.install/install.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/02.administer/10.install/install.fr.md b/pages/02.administer/10.install/install.fr.md index e42bba78..7049a442 100644 --- a/pages/02.administer/10.install/install.fr.md +++ b/pages/02.administer/10.install/install.fr.md @@ -189,7 +189,7 @@ Ci-dessous une liste de fournisseurs de VPS supportant nativement YunoHost : [[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="ECOWAN - FR"]![](image://vps_ynh_ecowan.png?height=50)[/figure]](https://www.ecowan.fr/vps-linux) [/div] [/div] {% endif %} From 11e53c8f1c5c1fb2494b3991990d50d7fe0a93dd Mon Sep 17 00:00:00 2001 From: Tio <38043315+tio-trom@users.noreply.github.com> Date: Sat, 30 Sep 2023 23:51:22 +0200 Subject: [PATCH 6/8] A small error Added yunohost.backup for restoring an archive - else people will see an error and cannot extract the archive --- .../20.backups/10.backup_methods/01.borgbackup/borgbackup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.md b/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.md index 0d19b25b..cf19049c 100644 --- a/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.md +++ b/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.md @@ -71,7 +71,7 @@ If the available space is less than the weight of your archive, decompressed dat If restoring app by app is not enough OR if an archive is too big, it may be a good idea to generate a tarball without the "big" data of an app as if it had been generated with the [BACKUP_CORE_ONLY option] (/backup/include_exclude_files#don't-save-large-quantities-of-data). Example with Nextcloud: ``` -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg export-tar -e apps/nextcloud/backup/home/yunohost.app "$(yunohost app setting $app repository)::ARCHIVE" /home/yunohost/archives/ARCHIVE.tar +app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg export-tar -e apps/nextcloud/backup/home/yunohost.app "$(yunohost app setting $app repository)::ARCHIVE" /home/yunohost.backup/archives/ARCHIVE.tar ``` You will then have to extract these data directly with borg From 2aecc02c00a88566c9b261b88e34e8bea7dc5963 Mon Sep 17 00:00:00 2001 From: Totor <86886856+T-otor@users.noreply.github.com> Date: Sun, 1 Oct 2023 12:06:50 +0200 Subject: [PATCH 7/8] Retrait "Association" de Association ECOWNA Changement de Status --- pages/02.administer/10.install/install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/02.administer/10.install/install.md b/pages/02.administer/10.install/install.md index e9555a77..981e410f 100644 --- a/pages/02.administer/10.install/install.md +++ b/pages/02.administer/10.install/install.md @@ -324,7 +324,7 @@ Here are some VPS providers supporting YunoHost natively : [[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="ECOWAN - FR"]![](image://vps_ynh_ecowan.png?height=50)[/figure]](https://www.ecowan.fr/vps-linux) [/div] [/div] {% endif %} From c3275505cb1972bd570cdc567def836f77b0be8c Mon Sep 17 00:00:00 2001 From: Totor <86886856+T-otor@users.noreply.github.com> Date: Sun, 1 Oct 2023 12:07:20 +0200 Subject: [PATCH 8/8] Retrait "Association" de Association Ecowan Changement de Status --- pages/02.administer/10.install/install.ru.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/02.administer/10.install/install.ru.md b/pages/02.administer/10.install/install.ru.md index 922ab16a..060545f1 100644 --- a/pages/02.administer/10.install/install.ru.md +++ b/pages/02.administer/10.install/install.ru.md @@ -324,7 +324,7 @@ Here are some VPS providers supporting YunoHost natively : [[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="ECOWAN - FR"]![](image://vps_ynh_ecowan.png?height=50)[/figure]](https://www.ecowan.fr/vps-linux) [/div] [/div] {% endif %}