Merge branch 'master' into backup_workaround
2
XMPP.md
|
@ -20,7 +20,7 @@ There are several web client built with social network features :
|
|||
|
||||
You can also use a desktop client such as :
|
||||
- [Pidgin](http://pidgin.im/) (multiplatform),
|
||||
- [Gajim](http://gajim.org/) (Linux),
|
||||
- [Gajim](http://gajim.org/) (Linux, Windows),
|
||||
- [Dino](https://dino.im) (Linux),
|
||||
- [Thunderbird](https://www.thundebird.net/) (multiplatform),
|
||||
- [Jitsi](http://jitsi.org/) (multiplatform)
|
||||
|
|
|
@ -20,7 +20,7 @@ Il existe des clients web orientés réseau social, comme :
|
|||
|
||||
Vous pouvez également utiliser un client desktop comme
|
||||
- [Pidgin](http://pidgin.im/) (multiplateforme),
|
||||
- [Gajim](http://gajim.org/index.fr.html) (Linux),
|
||||
- [Gajim](http://gajim.org/index.fr.html) (Linux, Windows),
|
||||
- [Dino](https://dino.im) (Linux),
|
||||
- [Thunderbird](https://www.mozilla.org/fr/thunderbird/) (multiplateforme),
|
||||
- [Jitsi](http://jitsi.org/) (multiplateforme)
|
||||
|
|
|
@ -35,6 +35,7 @@
|
|||
* [Security](/security)
|
||||
* Going further
|
||||
* [Noho.st / nohost.me / ynh.fr domain names](/dns_nohost_me)
|
||||
* [Exchange files with your server using a graphical interface](/filezilla)
|
||||
* [Adding an external storage](/external_storage)
|
||||
* [Migrating emails to YunoHost](/email_migration)
|
||||
* [Hide services with Tor](/torhiddenservice)
|
||||
|
|
|
@ -44,6 +44,7 @@
|
|||
* [SFR](/isp_sfr_fr)
|
||||
* [Orange](/isp_orange_fr)
|
||||
* [Free](/isp_free_fr)
|
||||
* [Échanger des fichiers avec son serveur à l'aide d'une interface graphique](/filezilla)
|
||||
* [Ajouter un stockage externe](/external_storage_fr)
|
||||
* [Migrer ses emails vers YunoHost](/email_migration_fr)
|
||||
* [YunoHost avec un service caché Tor](/torhiddenservice_fr)
|
||||
|
|
15
app_mediawiki.md
Normal file
|
@ -0,0 +1,15 @@
|
|||
# Mediawiki
|
||||
|
||||

|
||||
|
||||
MediaWiki is a free and open source software wiki package written in PHP, originally for use on Wikipedia.
|
||||
|
||||
## Overview
|
||||
|
||||

|
||||
|
||||
## Link
|
||||
|
||||
Mediawiki : https://www.mediawiki.org/
|
||||
FAQ : https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ
|
||||
Support Desk : https://www.mediawiki.org/wiki/Project:Support_desk
|
15
app_mediawiki_fr.md
Normal file
|
@ -0,0 +1,15 @@
|
|||
# Mediawiki
|
||||
|
||||

|
||||
|
||||
MediaWiki est un ensemble wiki à base de logiciels libres Open source, développé à l’origine pour Wikipédia.
|
||||
|
||||
## Aperçu
|
||||
|
||||

|
||||
|
||||
## Liens
|
||||
|
||||
Mediawiki : https://www.mediawiki.org/
|
||||
FAQ : https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ
|
||||
Support Desk : https://www.mediawiki.org/wiki/Project:Support_desk
|
|
@ -31,7 +31,7 @@ systemctl stop nginx
|
|||
Pour l'instant seul root peut y écrire dans `/media/stockage`; ce qui signifie que nginx et nextcloud ne pourront donc pas l'utiliser.
|
||||
|
||||
```bash
|
||||
chown -R nextcloud:www-data /media/stockage
|
||||
chown -R nextcloud:nextcloud /media/stockage
|
||||
chmod 775 -R /media/stockage
|
||||
```
|
||||
|
||||
|
|
|
@ -1,3 +0,0 @@
|
|||
# OpenVPN
|
||||
|
||||
To be written...
|
|
@ -1,3 +0,0 @@
|
|||
# OpenVPN
|
||||
|
||||
À documenter...
|
23
app_pluxml.md
Normal file
|
@ -0,0 +1,23 @@
|
|||
# PluXml
|
||||
|
||||

|
||||
|
||||
PluXml is a blog/CMS storing data in XML and not in a SQL database.
|
||||
|
||||
## Overview
|
||||
|
||||

|
||||
|
||||
## Plugins and themes
|
||||
|
||||
Plugins and themes should respectively be installed in the following folders : `/var/www/pluxml/plugins`, `/var/www/pluxml/themes`.
|
||||
|
||||
## Backup
|
||||
|
||||
To restore your blog, you should keep a copy of the folder `/var/www/pluxml/data`. It is recommended to do this backup before any upgrade.
|
||||
|
||||
## Link
|
||||
|
||||
PluXml : https://www.pluxml.org/
|
||||
Documentation : https://wiki.pluxml.org/
|
||||
Forum : https://forum.pluxml.org/
|
23
app_pluxml_fr.md
Normal file
|
@ -0,0 +1,23 @@
|
|||
# PluXml
|
||||
|
||||

|
||||
|
||||
PluXml est un moteur de blog/CMS stockant ces données en XML et ne nécessitant pas de base de données SQL.
|
||||
|
||||
## Aperçu
|
||||
|
||||

|
||||
|
||||
## Plugins et thèmes
|
||||
|
||||
Les plugins et thèmes doivent être installés manuellement respectivement dans les dossiers `/var/www/pluxml/plugins` et `/var/www/pluxml/themes`.
|
||||
|
||||
## Sauvegarde
|
||||
|
||||
Pour sauvegarder votre blog, il est nécessaire de réaliser une copie du dossier `/var/www/pluxml/data`. Cette procédure de sauvegarde est également recommandée avant toute mise à jour de l'application.
|
||||
|
||||
## Liens
|
||||
|
||||
PluXml : https://www.pluxml.org/
|
||||
Documentation : https://wiki.pluxml.org/
|
||||
Forum : https://forum.pluxml.org/
|
33
app_spip_fr.md
Normal file
|
@ -0,0 +1,33 @@
|
|||
# SPIP for YunoHost
|
||||
|
||||
### SPIP c'est quoi ?
|
||||
|
||||
SPIP est un système de publication pour l’Internet qui s’attache particulièrement au fonctionnement collectif, au multilinguisme et à la facilité d’emploi. C’est un logiciel libre, distribué sous la licence GNU/GPL. Il peut ainsi être utilisé pour tout site Internet, qu’il soit associatif ou institutionnel, personnel ou marchand.
|
||||
|
||||
Source : [spip.net](https://www.spip.net/fr_rubrique91.html)
|
||||
|
||||
### Fonctionnalité de l'application pour Yunohost
|
||||
|
||||
* Installation de la base sans passer par le système d'installation
|
||||
* Support multilingue
|
||||
* Support LDAP
|
||||
|
||||
#### Installation
|
||||
|
||||
```bash
|
||||
$ sudo yunohost app install https://github.com/YunoHost-Apps/spip_ynh.git
|
||||
```
|
||||
|
||||
#### Mise à jour
|
||||
|
||||
```
|
||||
$ sudo yunohost app upgrade --verbose spip -u https://github.com/YunoHost-Apps/spip_ynh.git
|
||||
```
|
||||
|
||||
#### Utilisation
|
||||
|
||||
Accéder à l'administration du site en écrivant l'adresse suivante dans votre navigateur.
|
||||
|
||||
https://www.domain.tld/spip/ecrire
|
||||
|
||||
Faire une demande de "mot de passe oublié" pour changer votre mot de passe, vous recevez un email vous indiquant comment procéder au changement de mot de passe.
|
|
@ -11,7 +11,6 @@ The following list is a compiled wishlist of applications that would be nice-to-
|
|||
- [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)
|
||||
- [10er10](https://github.com/dready92/10er10)
|
||||
- [Airsonic](https://github.com/airsonic/airsonic)
|
||||
- [Airtime](https://www.sourcefabric.org/en/airtime/)
|
||||
- [Ajenti](http://ajenti.org)
|
||||
- [aMule](https://github.com/amule-project/amule)
|
||||
|
@ -21,16 +20,15 @@ The following list is a compiled wishlist of applications that would be nice-to-
|
|||
- [Bitwarden](https://bitwarden.com/)
|
||||
- [Beehive](https://github.com/muesli/beehive)
|
||||
- [Blynk](https://github.com/blynkkk/blynk-library)
|
||||
- [Bolt](http://bolt.cm)
|
||||
- [Bookstack](https://www.bookstackapp.com/)
|
||||
- [Browsepass](http://techualization.blogspot.de/2013/09/introducing-browsepass-keepass-on-web.html)
|
||||
- [Calibre](https://manual.calibre-ebook.com/server.html)
|
||||
- [Caliopen](https://www.caliopen.org)
|
||||
- [Candy](https://candy-chat.github.io/candy)
|
||||
- [CardDavMate](https://www.inf-it.com/open-source/clients/carddavmate)
|
||||
- [cgit](http://git.zx2c4.com/cgit/about)
|
||||
- [CheckUp](https://sourcegraph.github.io/checkup)
|
||||
- [CiviCRM](https://civicrm.org)
|
||||
- [Cloud torrent](https://github.com/jpillora/cloud-torrent)
|
||||
- [Cockpit](http://cockpit-project.org/)
|
||||
- [Commafeed](https://github.com/Athou/commafeed)
|
||||
- [Converse.js](https://conversejs.org)
|
||||
|
@ -42,18 +40,17 @@ The following list is a compiled wishlist of applications that would be nice-to-
|
|||
- [Darkwire.io](https://github.com/seripap/darkwire.io)
|
||||
- [Deluge](http://deluge-torrent.org) (with WebUI)
|
||||
- [DirectoryLister](https://github.com/DirectoryLister/DirectoryLister)
|
||||
- [Discourse](https://discourse.org)
|
||||
- [DNSchain](https://github.com/okTurtles/dnschain)
|
||||
- [Domoticz](https://github.com/domoticz/domoticz)
|
||||
- [Drupal](https://www.drupal.org/)
|
||||
- [Emby](https://emby.media)
|
||||
- [Emoncms](https://github.com/emoncms/emoncms)
|
||||
- [ERPnext](https://erpnext.com/download)
|
||||
- [EteSync](https://www.etesync.com/)
|
||||
- [Ethersheet](https://github.com/ethersheet-collective/EtherSheet)
|
||||
- [Fail2web](https://github.com/Sean-Der/fail2web)
|
||||
- [Ferment](https://github.com/mmckegg/ferment)
|
||||
- [FEX](http://fex.rus.uni-stuttgart.de/)
|
||||
- [FileTea](https://filetea.me)
|
||||
- [FitTrackee](https://github.com/SamR1/FitTrackee)
|
||||
- [FoOlSlide](http://foolcode.github.io/FoOlSlide/) Open source comicbook/manga management software
|
||||
- [Fossil](http://www.fossil-scm.org)
|
||||
- [Framaslides](https://framagit.org/framasoft/framaslides/)
|
||||
|
@ -66,10 +63,9 @@ The following list is a compiled wishlist of applications that would be nice-to-
|
|||
- [Goploader](https://github.com/Depado/goploader)
|
||||
- [Granary](https://github.com/snarfed/granary)
|
||||
- [Guacamole](http://guac-dev.org)
|
||||
- [h5ai](http://larsjung.de/h5ai)
|
||||
- [Habitica](https://habitica.com/)
|
||||
- [HackMD CE](https://github.com/hackmdio/hackmd)
|
||||
- [Hackpad](https://github.com/dropbox/hackpad)
|
||||
- [Headphones](https://github.com/rembo10/headphones)
|
||||
- [Hexo](https://hexo.io/)
|
||||
- [Hi Buddy](https://github.com/tOkeshu/hibuddy) (/!\ last update: 17 Feb 2015)
|
||||
- [Huginn](https://github.com/cantino/huginn)
|
||||
|
@ -78,13 +74,14 @@ The following list is a compiled wishlist of applications that would be nice-to-
|
|||
- [ikiwiki](http://ikiwiki.info)
|
||||
- [img.bi](https://github.com/imgbi/img.bi)
|
||||
- [InfCloud](https://www.inf-it.com/open-source/clients/infcloud)
|
||||
- [Invidious](https://github.com/omarroth/invidious)
|
||||
- [Invoice Ninja](https://www.invoiceninja.com)
|
||||
- [InvoicePlane](https://invoiceplane.com)
|
||||
- [IPFS](https://ipfs.io)
|
||||
- [Joplin](http://joplin.cozic.net/)
|
||||
- [Jellyfin](https://github.com/jellyfin)
|
||||
- [JS Bin](http://jsbin.com/help/2-second-setup)
|
||||
- [Kaiwa](http://getkaiwa.com)
|
||||
- [Keepass](http://keepass.info)
|
||||
- [Kin calendar](https://github.com/KinToday)
|
||||
- [Kinto](https://github.com/Kinto/formbuilder)
|
||||
- [Kiwix](http://www.kiwix.org/) Offline wikipedia
|
||||
|
@ -92,7 +89,6 @@ The following list is a compiled wishlist of applications that would be nice-to-
|
|||
- [Koel](http://koel.phanan.net)
|
||||
- [Kontalk](https://kontalk.org)
|
||||
- [Koozip](http://koozic.net)
|
||||
- [Kresus](https://framagit.org/bnjbvr/kresus)
|
||||
- [KrISS feed](https://github.com/tontof/kriss_feed)
|
||||
- [Koken](http://koken.me)
|
||||
- [Kune](https://en.wikipedia.org/wiki/Kune_%28software%29)
|
||||
|
@ -104,8 +100,8 @@ The following list is a compiled wishlist of applications that would be nice-to-
|
|||
- [Loomio](https://www.loomio.org)
|
||||
- [MaidSafe](http://maidsafe.net)
|
||||
- [Mailpile](https://www.mailpile.is)
|
||||
- [Matomo](https://matomo.org/) (formerly Piwik)
|
||||
- [MediaCrush](https://github.com/MediaCrush/MediaCrush) (/!\ last update: Jan 23, 2015)
|
||||
- [microblog.pub](https://microblog.pub)
|
||||
- [MinigalNano](https://github.com/sebsauvage/MinigalNano) (/!\ last update: Jun 24, 2016)
|
||||
- [Mirakel](http://mirakel.azapps.de/taskwarrior.html) (/!\ SSL-Warning)
|
||||
- [Modoboa](http://modoboa.org)
|
||||
|
@ -115,13 +111,13 @@ The following list is a compiled wishlist of applications that would be nice-to-
|
|||
- [Nibbleblog](http://www.nibbleblog.com)
|
||||
- [Nuage](https://nuage.kerjean.me/login)
|
||||
- [ONLYOFFICE Document Server](http://helpcenter.onlyoffice.com/server/linux/document/linux-installation.aspx) (to be able to use ONLYOFFICE inside Nextcloud)
|
||||
- [ONLYOFFICE](http://onlyoffice.org)
|
||||
- [OpenBazaar](https://openbazaar.org)
|
||||
- [openHAB](https://www.openhab.org/) - Smart home platform.
|
||||
- [OpenJabNab](https://github.com/OpenJabNab/OpenJabNab) (/!\ last update: Apr 30, 2016)
|
||||
- [OX Open-Xchange](https://www.open-xchange.com) Linux groupware solution
|
||||
- [Paperless](https://github.com/danielquinn/paperless)
|
||||
- [Paperwork](http://paperwork.rocks)
|
||||
- [Passbolt] (https://www.passbolt.com)
|
||||
- [pdfy](https://github.com/joepie91/pdfy) (/!\ last update: Aug 5, 2014)
|
||||
- [Pelias](https://github.com/pelias/pelias)
|
||||
- [Peps](https://github.com/MLstate/PEPS)
|
||||
|
@ -131,16 +127,15 @@ The following list is a compiled wishlist of applications that would be nice-to-
|
|||
- [Pico](http://picocms.org)
|
||||
- [Pix](http://pix.toile-libre.org)
|
||||
- [Playmaker](https://github.com/NoMore201/playmaker)
|
||||
- [Pleroma](https://git.pleroma.social/pleroma/pleroma)
|
||||
- [Privoxy](http://www.privoxy.org)
|
||||
- [ProcessMaker](http://www.processmaker.com)
|
||||
- [ProtonMail’s WebClient](https://github.com/ProtonMail/WebClient)
|
||||
- [PyLoad](https://github.com/pyload/pyload)
|
||||
- [Pulse](https://source.ind.ie/project/pulse-swift/tree/master)
|
||||
- [Pump.io](http://pump.io)
|
||||
- [qBittorrent](https://github.com/qbittorrent/qBittorrent)
|
||||
- [racktables](http://racktables.org)
|
||||
- [Redmine](https://www.redmine.org)
|
||||
- [remotestorage-server](https://remotestorage.io/)
|
||||
- [Request Tracker](https://bestpractical.com)
|
||||
- [Respawn 2.0](https://github.com/broncowdd/respawn) ( /!\ last update: 2015)
|
||||
- [Restya](http://restya.com)
|
||||
|
@ -159,7 +154,6 @@ The following list is a compiled wishlist of applications that would be nice-to-
|
|||
- [StandardNotes](https://standardnotes.org) (a clean, simple, E2E-encrypted notes app) -- specifically, the server-side [StandardFile](https://standardfile.org) portion.
|
||||
- [Streama](https://github.com/dularion/streama)
|
||||
- [Streisand](https://github.com/jlund/streisand)
|
||||
- [SVG-Edit](https://github.com/SVG-Edit/svgedit)
|
||||
- [Taiga](https://taiga.io)
|
||||
- [Tania](http://gettania.org/)
|
||||
- [Taskwarrior](https://taskwarrior.org)
|
||||
|
@ -171,17 +165,16 @@ The following list is a compiled wishlist of applications that would be nice-to-
|
|||
- [TwitRSS.me](http://twitrss.me/) ([Github](https://github.com/ciderpunx/twitrssme)) Scrapes Twitter to create RSS feeds.
|
||||
- [Unvis](https://unv.is/) ([Github](https://github.com/lodjuret/unvis.it))
|
||||
- [Vaultier](http://www.vaultier.org)
|
||||
- [Volumio](https://volumio.org)
|
||||
- [Webmpc](https://github.com/ushis/webmpc)
|
||||
- [WebODF](http://webodf.org)
|
||||
- [webSync](http://furier.github.io/websync)
|
||||
- [WebTorrent](https://github.com/feross/webtorrent)
|
||||
- [Wisemapping](http://www.wisemapping.com)
|
||||
- [Xonotic](http://xonotic.org)
|
||||
- [YellowCMS](https://datenstrom.se/yellow)
|
||||
- [YesWiki](https://yeswiki.net)
|
||||
- [ZeroTier](https://github.com/zerotier/ZeroTierOne)
|
||||
- [ZNC](http://wiki.znc.in/ZNC)
|
||||
- [Zone-project](https://github.com/descl/ZONE)
|
||||
- [Zoneminder](https://github.com/ZoneMinder/zoneminder)
|
||||
- [Zulip](https://zulipchat.com/)
|
||||
- [microblog.pub](https://microblog.pub)
|
||||
|
|
26
backup.md
|
@ -56,13 +56,20 @@ For more informations and options about backup creation, consult `yunohost backu
|
|||
|
||||
### Apps-specific configuration
|
||||
|
||||
Some apps such as Nextcloud may be related to a large quantity of data which are not backuped by default. This practice is referred to "backing up only the core" (of the app). However it's possible to enable the backup of all data of this app with `yunohost app setting nextcloud backup_core_only -v 0`. Be careful though that your archive might get huge if there's too much data to be backuped...
|
||||
Some apps such as Nextcloud may be related to a large quantity of data. If you want you can backup the app without the user data. This practice is referred to "backing up only the core" (of the app).
|
||||
|
||||
To enable the backup of all data of this app, you can use `yunohost app setting nextcloud backup_core_only -v ''`. This command add `backup_core_only:` in `etc/yunohost/apps/nextcloud/settings.yml`. Be careful though that your archive might get huge if there's too much data to be backuped...
|
||||
|
||||
To disable the backup of all data, you can use `yunohost app setting nextcloud backup_core_only -v '1'`. This command add `backup_core_only: '1'` in `etc/yunohost/apps/nextcloud/settings.yml`. Be careful though that mean you will have to backup user data yourself. But doing so, you will be able to do incremental or differential backups of this large amount of data (which is not an option provided by yunohost yet).
|
||||
|
||||
|
||||
## Downloading and uploading backups
|
||||
|
||||
After creating backup archives, it is possible to list and inspect them via the corresponding views in the webadmin, or via `yunohost backup list` and `yunohost backup info <archivename>` from the command line. By default, backups are stored in `/home/yunohost.backup/archives/`.
|
||||
|
||||
There is currently no straightfoward way to download or upload a backup archive.
|
||||
Currently, the most accessible way to download archives is to use the program FileZilla as explained in [this page](/filezilla).
|
||||
|
||||
Alternatively, a solution can be to install Nextcloud or a similar app and configure it to be able to access files in `/home/yunohost.backup/archives/` from a web browser.
|
||||
|
||||
One solution consists in using `scp` (a program based on [`ssh`](/ssh)) to copy files between two machines via the command line. Hence, from a machine running Linux, you should be able to run the following to download a specific backup:
|
||||
|
||||
|
@ -76,8 +83,6 @@ Similarly, you can upload a backup from a machine to your server with:
|
|||
scp /path/to/your/<archivename>.tar.gz admin@your.domain.tld:/home/yunohost.backup/archives/
|
||||
```
|
||||
|
||||
Alternatively, a solution can be to install Nextcloud or a similar app and configure it to be able to access files in `/home/yunohost.backup/archives/` from a web browser.
|
||||
|
||||
### Workaround to retrieve the backups
|
||||
|
||||
<div class="alert alert-danger">
|
||||
|
@ -104,14 +109,17 @@ To restore an app, the domain on which it was installed should already be config
|
|||
|
||||
### Restoring during the postinstall
|
||||
|
||||
One specific feature is the ability to restore a full archive *instead* of the postinstall step. This makes it useful when you want to reinstall a system entirely from an existing backup. To be able to do this, you will need to upload the archive on the server and place it in `/home/yunohost.backup/archives`. Then, instead of `yunohost tools postinstall` you can run:
|
||||
One specific feature is the ability to restore a full archive *instead* of the postinstall step. This makes it useful when you want to reinstall a system entirely from an existing backup. To be able to do this, you will need to upload the archive on the server and place it in `/home/yunohost.backup/archives`. Then, **instead of** `yunohost tools postinstall` you can run:
|
||||
|
||||
```bash
|
||||
yunohost backup restore <archivename>
|
||||
```
|
||||
|
||||
Note: Don't start the postinstall step. Decline invite when doing installation
|
||||
via `bash`/`wget`.
|
||||
Note: If your archive isn't in `/home/yunohost.backup/archives`, you can specify where it is like this :
|
||||
|
||||
```bash
|
||||
yunohost backup restore /path/to/<archivename>
|
||||
```
|
||||
|
||||
## To go futher
|
||||
|
||||
|
@ -137,7 +145,7 @@ yunohost backup create --apps wordpress
|
|||
then make it executable :
|
||||
|
||||
```bash
|
||||
chown +x /etc/cron.weekly/backup-wordpress
|
||||
chmod +x /etc/cron.weekly/backup-wordpress
|
||||
```
|
||||
|
||||
Be careful what you backup exactly and when : you don't want to end up with your whole disk space saturated because you backuped 30 Go of data every day.
|
||||
|
@ -153,7 +161,7 @@ Alternatively, the app Archivist allows to setup a similar system : <https://for
|
|||
If you are using an ARM board, another method for doing a full backup can be to create an image of the SD card. For this, poweroff your ARM board, get the SD card in your computer then create a full image with something like :
|
||||
|
||||
```bash
|
||||
dd if=/dev/mmcblk0 of=./backup.img
|
||||
dd if=/dev/mmcblk0 of=./backup.img status=progress
|
||||
```
|
||||
|
||||
(replace `/dev/mmcblk0` with the actual device of your sd card)
|
||||
|
|
28
backup_fr.md
|
@ -54,16 +54,22 @@ Pour plus d'informations et d'options sur la création d'archives, consultez `yu
|
|||
|
||||
#### Configuration spécifique à certaines apps
|
||||
|
||||
Certaines apps comme Nextcloud sont potentiellement rattachées à des quantités importantes de données, qui ne sont pas sauvegardées par défaut. Dans ce cas, on dit que l'app "sauvegarde uniquement le core" (de l'app). Néanmoins, il est possible d'activer la sauvegarde de toutes les données de cette application avec (dans le cas de Nextcloud) `yunohost app setting nextcloud backup_core_only -v 0`. Soyez prudent : en fonction des données stockées dans Nextcloud, il se peut que l'archive que vous obtenez ensuite devienne énorme...
|
||||
Certaines apps comme Nextcloud sont potentiellement rattachées à des quantités importantes de données. Il est possible de ne pas les sauvegarder par défaut. Dans ce cas, on dit que l'app "sauvegarde uniquement le core" (de l'app).
|
||||
|
||||
Pour activer la sauvegarde de toutes les données de cette application vous pouvez utiliser (dans le cas de Nextcloud) `yunohost app setting nextcloud backup_core_only -v ''`. Cette commande ajoute `backup_core_only` dans `/etc/yunohost/apps/nextcloud/settings.yml`. Soyez prudent : en fonction des données stockées dans Nextcloud, il se peut que l'archive que vous obtenez ensuite devienne énorme...
|
||||
|
||||
Pour désactiver la sauvegarde de toutes les données de cette application vous pouvez utiliser (dans le cas de Nextcloud) `yunohost app setting nextcloud backup_core_only -v '1'`. Cette commande ajoute `backup_core_only: '1'` dans `/etc/yunohost/apps/nextcloud/settings.yml`. Soyez prudent : il vous faudra alors sauvegarder vous même les données des utilisateurs de nextcloud. Choisir ce type de sauvegarde vous permettra de mettre en place manuellement des sauvegardes incrémentielles ou différentielles (que yunohost ne permet pas encore de faire automatiquement).
|
||||
|
||||
Télécharger et téléverser des sauvegardes
|
||||
-----------------------------------------
|
||||
|
||||
Après avoir créé des sauvegardes, il est possible de les lister et de les inspecter grâce aux vues correspondantes dans la webadmin, ou via `yunohost backup list` et `yunohost backup info <nom_d'archive>` depuis la ligne de commande. Par défaut, les sauvegardes sont stockées dans `/home/yunohost.backup/archives/`.
|
||||
|
||||
Il n'existe actuellement pas de solution "rapide et facile" pour télécharger ou téléverser une archive depuis une autre machine.
|
||||
À l'heure actuelle, la solution la plus accessible pour récupérer les sauvegardes est d'utiliser le programme FileZilla comme expliqué dans [cette page](/filezilla_fr).
|
||||
|
||||
Une solution consiste à utiliser `scp` (un programme basé sur [`ssh`](/ssh)) pour copier des fichiers entre deux machines grâce à la ligne de commande. Ainsi, depuis une machine sous Linux, vous pouvez utiliser la commande suivante pour télécharger une archive :
|
||||
Une autre solution alternative consiste à installer une application comme Nextcloud et à la configurer pour être en mesure d'accéder aux fichiers dans `/home/yunohost.backup/archives/` depuis un navigateur web.
|
||||
|
||||
Enfin, il est possible d'utiliser `scp` (un programme basé sur [`ssh`](/ssh)) pour copier des fichiers entre deux machines grâce à la ligne de commande. Ainsi, depuis une machine sous Linux, vous pouvez utiliser la commande suivante pour télécharger une archive :
|
||||
|
||||
```bash
|
||||
scp admin@your.domain.tld:/home/yunohost.backup/archives/<nom_d'archive>.tar.gz ./
|
||||
|
@ -75,8 +81,6 @@ De façon similaire, vous pouvez téléverser une sauvegarde depuis une machine
|
|||
scp /path/to/your/<nom_d'archive>.tar.gz admin@your.domain.tld:/home/yunohost.backup/archives/
|
||||
```
|
||||
|
||||
Une solution alternative consiste à installer une application comme Nextcloud et à la configurer pour être en mesure d'accéder aux fichiers dans `/home/yunohost.backup/archives/` depuis un navigateur web.
|
||||
|
||||
Restaurer des sauvegardes
|
||||
-------------------------
|
||||
|
||||
|
@ -98,13 +102,19 @@ Pour restaurer une application, le domaine sur laquelle elle est installée doit
|
|||
|
||||
Une fonctionnalité particulière est la possibilité de restaurer une archive entière *à la place* de faire la post-installation. Ceci est utile pour réinstaller un système entièrement à partir d'une sauvegarde existante. Pour faire cela, il vous faudra d'abord téléverser l'archive sur le serveur et la placer dans `/home/yunohost.backup/archives`.
|
||||
|
||||
Ensuite, à la place de `yunohost tools postinstall`; réalisez la restauration de l'archive téléversée par cette ligne de commande avec le nom de l'archive (sans le `.tar.gz`) :
|
||||
Ensuite, **à la place de** `yunohost tools postinstall`, réalisez la restauration de l'archive téléversée par cette ligne de commande avec le nom de l'archive (sans le `.tar.gz`) :
|
||||
|
||||
```bash
|
||||
yunohost backup restore <nom_d'archive>
|
||||
```
|
||||
|
||||
NB: Ne surtout pas engager la 'Post-Installation' , refuser l'invitation lors de l'installation via `bash`/`wget`.
|
||||
Note: si votre archive n'est pas dans `/home/yunohost.backup/archives`, vous pouvez spécifier où elle se trouve comme ceci :
|
||||
|
||||
```bash
|
||||
yunohost backup restore /path/to/<archivename>
|
||||
```
|
||||
|
||||
|
||||
|
||||
Pour aller plus loin
|
||||
--------------------
|
||||
|
@ -130,7 +140,7 @@ yunohost backup create --apps wordpress
|
|||
puis rendez-le exécutable :
|
||||
|
||||
```bash
|
||||
chown +x /etc/cron.weekly/backup-wordpress
|
||||
chmod +x /etc/cron.weekly/backup-wordpress
|
||||
```
|
||||
|
||||
Soyez prudent à propos de ce que vous sauvegardez et de la fréquence : il vaut mieux éviter de se retrouver avec un disque saturé car vous avez voulu sauvegarder 30 Go de données tous les jours...
|
||||
|
@ -146,7 +156,7 @@ Il existe aussi l'application Archivist qui permet un système similaire : https
|
|||
Si vous êtes sur une carte ARM, une autre méthode pour créer une sauvegarde complète consiste à créer une image (copie) de la carte SD. Pour cela, éteignez votre serveur, insérez la carte SD dans votre ordinateur et créez une image avec une commande comme :
|
||||
|
||||
```bash
|
||||
dd if=/dev/mmcblk0 of=./backup.img
|
||||
dd if=/dev/mmcblk0 of=./backup.img status=progress
|
||||
```
|
||||
|
||||
(remplacez `/dev/mmcblk0` par le vrai nom de votre carte SD)
|
||||
|
|
|
@ -32,3 +32,11 @@ It also allow to discuss packaging evolution, continuous integration tools :
|
|||
- IRC: **#yunohost-apps** on irc.freenode.net
|
||||
- Matrix: **#freenode_#yunohost-apps:matrix.org**
|
||||
- XMPP: **[apps@conference.yunohost.org](xmpp:apps@conference.yunohost.org?join)**
|
||||
|
||||
#### Documentation chatroom
|
||||
Yunohost project documentation chat room. It allow people to discuss, synchronize and maintain
|
||||
an up-to-date documentation on the differents aspects of the project (backend, frontend, apps, project, community...).
|
||||
You may also share here your public communications about Yunohost (videos, presentations, etc.), to allow proper referencing.
|
||||
- IRC: **#yunohost-doc** on irc.freenode.net
|
||||
- Matrix: **#freenode_#yunohost-doc:matrix.org**
|
||||
- XMPP: **[doc@conference.yunohost.org](xmpp:doc@conference.yunohost.org?join)**
|
||||
|
|
|
@ -29,3 +29,10 @@ Il sert également à discuter de l’évolution du packaging, des outils d’in
|
|||
- IRC : **#yunohost-apps** sur irc.freenode.net
|
||||
- Matrix : **#freenode_#yunohost-apps:matrix.org**
|
||||
- XMPP : **[apps@conference.yunohost.org](xmpp:apps@conference.yunohost.org?join)**
|
||||
|
||||
#### Documentation
|
||||
Le salon de documentation du projet Yunohost. Il permet aux contributeurs d'échanger, pour synchroniser et maintenir une documentation à jour sur les différents aspects du projet : backend, frontend, apps, projet, communauté...
|
||||
Vous pouvez aussi y partager vos communications au public à propos de Yunohost (présentations, vidéos...) pour permettre leur référencement dans la documentation.
|
||||
- IRC: **#yunohost-doc** sur irc.freenode.net
|
||||
- Matrix: **#freenode_#yunohost-doc:matrix.org**
|
||||
- XMPP: **[doc@conference.yunohost.org](xmpp:doc@conference.yunohost.org?join)**
|
||||
|
|
|
@ -83,13 +83,11 @@ Improve this documentation by [writing new pages](/write_documentation) or trans
|
|||
<div class="col col-md-8" markdown="1">
|
||||
Extend YunoHost capabilities by [packaging new services and web applications](/packaging_apps).
|
||||
Have a look of [what has been done yet](/apps)!
|
||||
<br>
|
||||
A <a href="http://list.yunohost.org/cgi-bin/mailman/listinfo/apps">mailing-list</a> is available.
|
||||
</div>
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
<br>
|
||||
<p class="lead" markdown="1">In any case, please [come to dev chatroom](xmpp:dev@conference.yunohost.org?join) to contribute :-)</p>
|
||||
<p class="lead" markdown="1">In any case, please come chat with us on [the dev chatroom](/chat_rooms) :-)</p>
|
||||
|
||||
|
|
|
@ -79,8 +79,6 @@ Améliorez cette documentation en [proposant de nouvelles pages](/write_document
|
|||
</div>
|
||||
<div class="col col-md-8" markdown="1">
|
||||
Étendez les capacités de YunoHost en [packageant de nouveaux services et applications web](/packaging_apps_fr). Jetez un œil à [ce qui a déjà été fait](/apps_fr) !
|
||||
<br>
|
||||
Un [salon de développement](xmpp:dev@conference.yunohost.org?join) et une <a href="http://list.yunohost.org/cgi-bin/mailman/listinfo/apps">mailing-list</a> est également disponible.
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
@ -88,5 +86,5 @@ Un [salon de développement](xmpp:dev@conference.yunohost.org?join) et une <a hr
|
|||
|
||||
<br>
|
||||
<br>
|
||||
<p class="lead" markdown="1">Dans tous les cas, venez sur le [salon de développement](xmpp:dev@conference.yunohost.org?join) pour contribuer :-)</p>
|
||||
<p class="lead" markdown="1">Dans tous les cas, venez discuter avec nous sur [le salon de développement](/chat_rooms_fr) :-)</p>
|
||||
|
||||
|
|
|
@ -2,6 +2,7 @@
|
|||
|
||||
* [General ways of contributing to YunoHost](/contribute)
|
||||
* [Writing documentation](/write_documentation)
|
||||
* [Chat rooms](/chat_rooms)
|
||||
* Application packaging
|
||||
* [Apps wishlist](/apps_wishlist)
|
||||
* [General introduction to app packaging](/packaging_apps_start)
|
||||
|
@ -19,8 +20,9 @@
|
|||
* [Package linter](https://github.com/YunoHost/package_linter)
|
||||
* [Package check](https://github.com/YunoHost/package_check)
|
||||
* [Applications levels](packaging_apps_levels_fr)
|
||||
* [App Continuous Integration](https://ci-apps.yunohost.org/jenkins/)
|
||||
* [App Continuous Integration](https://ci-apps.yunohost.org)
|
||||
* [App CI dashboard](https://dash.yunohost.org/appci/branch/stable)
|
||||
* [App Continuous Integration for packagers](/packaging_apps_ci)
|
||||
* [YEP - YunoHost Enhancement Proposals](packaging_apps_guidelines_fr)
|
||||
* [Contributing to the YunoHost core](/dev)
|
||||
* [Setting up a dev environment with ynh-dev](https://github.com/YunoHost/ynh-dev/blob/master/README.md)
|
||||
|
|
|
@ -2,6 +2,7 @@
|
|||
|
||||
* [Liste des façons de contribuer à YunoHost](/contribute_fr)
|
||||
* [Écrire de la documentation](/write_documentation_fr)
|
||||
* [Salons de discussion](/chat_rooms_fr)
|
||||
* Packaging d'application
|
||||
* [Liste d'apps souhaitées par la communauté](/apps_wishlist_fr)
|
||||
* [Introduction générale au packaging d'apps](/packaging_apps_start_fr)
|
||||
|
@ -19,8 +20,9 @@
|
|||
* [Package linter](https://github.com/YunoHost/package_linter)
|
||||
* [Package check](https://github.com/YunoHost/package_check)
|
||||
* [Niveaux des applications](packaging_apps_levels_fr)
|
||||
* [Intégration continue des apps](https://ci-apps.yunohost.org/jenkins/)
|
||||
* [Intégration continue des apps](https://ci-apps.yunohost.org)
|
||||
* [Tableau de bord du CI des apps](https://dash.yunohost.org/appci/branch/stable)
|
||||
* [Intégration continue pour packagers](/packaging_apps_ci)
|
||||
* [YEP - YunoHost Enhancement Proposals](packaging_apps_guidelines_fr)
|
||||
* [Contribuer à la partie "core" de YunoHost](/dev_fr)
|
||||
* [Déployer un environnement de dev avec ynh-dev](https://github.com/YunoHost/ynh-dev/blob/master/README.md)
|
||||
|
|
|
@ -34,7 +34,7 @@ dd if=/path/to/yunohost.img of=/dev/mmcblk0
|
|||
## Expand the root partition <small>(optional)</small>
|
||||
|
||||
<div class="alert alert-warning" markdown="1">
|
||||
This step is optionnal as it should be performed automatically during the first
|
||||
This step is optional as it should be performed automatically during the first
|
||||
boot on recent images.
|
||||
</div>
|
||||
|
||||
|
|
|
@ -1,40 +1,39 @@
|
|||
# DNS with a dynamic IP
|
||||
|
||||
<div class="alert alert-warning">Before going further, make sure your global IP address is dynamic with: [ip.yunohost.org](http://ip.yunohost.org/). The global IP address of your box change almost every days.</div>
|
||||
<div class="alert alert-warning">Before going further, make sure your global IP address is dynamic with: [ip.yunohost.org](http://ip.yunohost.org/). The global IP address of your box changes almost every day.</div>
|
||||
|
||||
This tutorial aim to get around dynamic IP issue who's nest: when the IP address public of the box change, the DNS zone is not update to point towards the new IP address.
|
||||
This tutorial aim to get around dynamic IP issue which is: when the IP public address of your (Internet Service Provider-) box changes, the DNS zone is not updated to point towards the new IP address, and consequently your server is no more reachable via its domain name. After setting up the solution proposed in this tutorial, the redirection from your domain name to the actual IP address of your server will not be lost anymore.
|
||||
|
||||
After put in place the solution proposed in this tutorial, the redirection from your domain name to the real IP address will not be loose anymore.
|
||||
The method proposed here consists of automatizing the fact the box annonces its global IP adress change to the dynamic DNS, so that the DNS zone will automatically be updated.
|
||||
|
||||
The method which will be put in place consist to make automatic the fact the box annonce to the dynamic DNS it has change global IP address, and then the DNS zone will automatically be changed.
|
||||
|
||||
If you own a domain name at **OVH**, you could go to step 4 and follow this [tutorial](OVH_fr) because OVH propose a DynDNS service.
|
||||
If you own a domain name at **OVH**, you may go to step 4 and follow this [tutorial](OVH_fr), given that OVH proposes a DynDNS service.
|
||||
|
||||
#### 1. Create an account to a Dynamic DNS service
|
||||
Here is sites which offer a DynDNS service free of charge:
|
||||
Here are sites which offer a DynDNS service free of charge:
|
||||
* [DNSexit](https://www.dnsexit.com/Direct.sv?cmd=dynDns)
|
||||
* [No-IP](https://www.noip.com/remote-access)
|
||||
* [ChangeIP](https://changeip.com)
|
||||
* [DynDNS (in italian)](https://dyndns.it)
|
||||
* [DynDNS with your own domain](https://github.com/jodumont/DynDNS-with-HE.NET)
|
||||
|
||||
Register to one of them.
|
||||
Register to one of them. It should provide you with one (or more) IP address to reach the service, and a login (that you may be able to self-define).
|
||||
|
||||
#### 2. Move the DNS zones
|
||||
Move the [DNS zones](dns_config), excepted the NS fields, from the [registrar](registrar_en) where you bought your domain name to the dynamic DNS service you registrer at step 1.
|
||||
Copy the [DNS zones](dns_config), except for the NS fields, from the [registrar](registrar_en) where you bought your domain name from to the dynamic DNS service you registrer at in step 1.
|
||||
|
||||
#### 3. Toggle management of your domain name to the dynamic DNS server
|
||||
This step consist to say to the [registrar](registrar_en) that DNS service will be manage by the DynDNS service.
|
||||
Redirect NS field to the IP address gived by the DynDNS service.
|
||||
#### 3. Switch the management of your domain name to the dynamic DNS server
|
||||
This step consists in declaring to your [registrar](registrar_en) that the DNS service will now be managed by the DynDNS service provider.
|
||||
|
||||
Then, remove [DNS zones](dns_config), excepted NS fields, from the [registrar](registrar_en).
|
||||
For this, fisrt declare in the NS field(s) the IP address provided by the DynDNS service.
|
||||
|
||||
#### 4. Create a Dynamic DNS login
|
||||
On the dynamic DNS service create a login that you will enter on a dynamic DNS client.
|
||||
This client could be your box or a package installed on your server as `ddclient`.
|
||||
We gone use the client installed on the box which is more easy way.
|
||||
Then, remove any other item in the [DNS zones](dns_config) (except the previous NS fields), from the [registrar](registrar_en).
|
||||
|
||||
#### 5. Configure the box
|
||||
Put the login of the dynamic DNS and the [public IP address](http://ip.yunohost.org/) on your box.
|
||||
#### 4. Configure the client
|
||||
This client could be your ISP-box, or a package installed on your server, such as `ddclient`.
|
||||
Here, we will use the client provided by the box, which is the more easy way.
|
||||
|
||||
Enter the login of the dynamic DNS and its public IP address in your box (interface details may vary by ISP).
|
||||
|
||||
<img src="/images/dns_dynamic-ip_box_conf.png" width=600>
|
||||
|
||||
You're good to go !
|
||||
|
|
|
@ -27,7 +27,7 @@ Il existe également des **types** d’enregistrement DNS, ce qui veut dire qu
|
|||
|
||||
Plusieurs choix s’offrent à vous. Notez que vous pouvez cumuler ces solutions si vous possédez plusieurs domaines : par exemple vous pouvez avoir `mon-serveur.nohost.me` en utilisant la solution **1.**, et `mon-serveur.org` en utilisant la solution **2.**, redirigeant vers le même serveur YunoHost.
|
||||
|
||||
1. Vous pouvez utiliser [le service de DNS de YunoHost](/dns_nohost_me), qui s’occupera de configurer tout seul les DNS de votre instance YunoHost. Vous devrez en revanche choisir un domaine se terminant par `.nohost.me`, `.noho.st` ou `.ynh.fr`, ce qui peut être inconvenant (vous aurez alors des adresses email telles que `jean@mon-serveur.noho.st`).
|
||||
1. Vous pouvez utiliser [le service de DNS de YunoHost](/dns_nohost_me_fr), qui s’occupera de configurer tout seul les DNS de votre instance YunoHost. Vous devrez en revanche choisir un domaine se terminant par `.nohost.me`, `.noho.st` ou `.ynh.fr`, ce qui peut être inconvenant (vous aurez alors des adresses email telles que `jean@mon-serveur.noho.st`).
|
||||
**C’est la méthode recommandée si vous débutez.**
|
||||
|
||||
2. Vous pouvez utiliser le service de DNS de votre **registrar** (Gandi, OVH, BookMyName ou autre) pour configurer vos noms de domaine. Voici la [configuration DNS standard](/dns_config_fr). Il est aussi possible d'utiliser une redirection DNS locale, plus d'infos sur comment [Accéder à son serveur depuis le réseau local](/dns_local_network_fr).
|
||||
|
|
33
docs_de.md
Normal file
|
@ -0,0 +1,33 @@
|
|||
#Documentation
|
||||
|
||||
<p class="lead">
|
||||
Die YunoHost Dokumentation ist in 3 Bereiche aufgeteilt:
|
||||
</p>
|
||||
|
||||
<div class="row text-center">
|
||||
|
||||
<div class="col col-md-4 col-md-offset-1">
|
||||
<a class="btn btn-success btn-lg" href="/userdoc"><span class="glyphicon glyphicon-user"></span> Benutzerhandbuch</a>
|
||||
<p><small class="text-muted">Über die tägliche Nutzung des Servers und Anleitungen zur Konfiguration des Clients.</small></p>
|
||||
</div>
|
||||
|
||||
<div class="col col-md-4 col-md-offset-1">
|
||||
<a class="btn btn-primary btn-lg" href="/admindoc"><span class="glyphicon glyphicon-lock"></span> Handbuch für Administratoren</a>
|
||||
<p><small class="text-muted">Befasst sich mit den Installationsschritten und der Verwaltung von Server und Apps.</small></p>
|
||||
</div>
|
||||
|
||||
<div class="col col-md-5 col-md-offset-3">
|
||||
<a class="btn btn-danger btn-lg" href="/contributordoc"><span class="glyphicon glyphicon-heart"></span> Handbuch für Mitwirkende</a>
|
||||
<p><small class="text-muted">Alles, was du über uns und unsere Art zu arbeiten wissen musst.</small></p>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
|
||||
* Das Projektleben:
|
||||
* [Häufig gestellte Fragen](/faq_en)
|
||||
* [Projektorganisation](/project_organization)
|
||||
* [Blog](https://forum.yunohost.org/c/announcement)
|
||||
* [Forum](https://forum.yunohost.org)
|
||||
* [Chaträume](/chat_rooms_en)
|
||||
* [Kommunikation](/communication_en)
|
||||
* [Support / Hilfe](/help)
|
|
@ -19,7 +19,7 @@ YunoHost can generate a recommended DNS configuration for each domain, including
|
|||
SSL/HTTPS certificates
|
||||
----------------------
|
||||
|
||||
Another important aspect of domain configuration is the SSL/HTTPS certificate. YunoHost is integrated with Let's Encrypt, so once your server is correctly reachable from anybody on the internet through the domain name, the administrator can request a Let's Encrypt certificate. See the documentation about [certificates](certificates) for more information.
|
||||
Another important aspect of domain configuration is the SSL/HTTPS certificate. YunoHost is integrated with Let's Encrypt, so once your server is correctly reachable from anybody on the internet through the domain name, the administrator can request a Let's Encrypt certificate. See the documentation about [certificates](certificate) for more information.
|
||||
|
||||
Subpaths vs. individual domains per apps
|
||||
----------------------------------------
|
||||
|
|
|
@ -19,7 +19,7 @@ YunoHost peut générer une configuration DNS recommandée pour chaque domaine,
|
|||
Certificats SSL/HTTPS
|
||||
----------------------
|
||||
|
||||
Un autre aspect important de la configuration des domaines est le certificat SSL/HTTPS. YunoHost est intégré avec Let's Encrypt, de sorte qu'une fois que votre serveur est correctement accessible depuis n'importe qui sur Internet via le nom de domaine, l'administrateur peut demander l'installation d'un certificat Let's Encrypt. Voir la documentation sur les [certificats](certificats) pour plus d'informations.
|
||||
Un autre aspect important de la configuration des domaines est le certificat SSL/HTTPS. YunoHost est intégré avec Let's Encrypt, de sorte qu'une fois que votre serveur est correctement accessible depuis n'importe qui sur Internet via le nom de domaine, l'administrateur peut demander l'installation d'un certificat Let's Encrypt. Voir la documentation sur les [certificats](certificate_fr) pour plus d'informations.
|
||||
|
||||
Sous-chemins vs. domaines individuels par application
|
||||
-----------------------------------------------------
|
||||
|
|
2
email.md
|
@ -30,7 +30,7 @@ Configuring email aliases and auto-forwards
|
|||
|
||||
Mail aliases and forwards can be configured for each users. For instance, the first user created on the server automatically has an alias `root@the.domain.tld` configured - meaning that an email sent to this adress will end in the inbox of the first user. Automatic forwards may be configured, for instance if an user doesn't want to configure an additional email account and just wants to receive emails from the server on, say, his/her gmail address.
|
||||
|
||||
Another feature which few people know about is the use of suffixes beginning with "+". For example, emails sent to `johndoe+booking@votre.domaine.tld` will land in John Doe's mailbox. It is a practical technique for example to provide an e-mail address to a website, then easily sort (via automatic filters) the mail coming from this website.
|
||||
Another feature which few people know about is the use of suffixes beginning with "+". For example, emails sent to `johndoe+booking@votre.domaine.tld` will automatically land in the `booking` dir (lowercase) of John Doe's mailbox or in John Doe's inbox if `booking` directory doesn't exist . It is a practical technique for example to provide an e-mail address to a website, then easily sort (via automatic filters) the mail coming from this website.
|
||||
|
||||
What happens if my server becomes unavailable ?
|
||||
-----------------------------------------------
|
||||
|
|
|
@ -30,7 +30,7 @@ Configuration des alias de messagerie et des redirections automatiques
|
|||
|
||||
Des alias de messagerie et des redirections peuvent être configurés pour chaque utilisateur. Par exemple, le premier utilisateur créé sur le serveur dispose automatiquement d'un alias `root@votre.domaine.tld` - ce qui signifie qu'un email envoyé vers cette adresse se retrouvera dans la boîte de réception de cet utilisateur. Les redirections automatiques peuvent être configurées, par exemple si un utilisateur ne veut pas configurer un compte de messagerie supplémentaire et souhaite simplement recevoir des courriels du serveur sur, disons, son adresse gmail.
|
||||
|
||||
Une autre fonctionnalité méconnue est l'utilisation de suffixe commencant par "+". Par exemple, les emails envoyés à `johndoe+sncf@votre.domaine.tld` atteriront dans la boîte mail de John Doe. C'est une technique pratique pour par exemple fournir une adresse mail à un site puis facilement trier (via des filtres automatiques) les courriers venant de ce site.
|
||||
Une autre fonctionnalité méconnue est l'utilisation de suffixe commencant par "+". Par exemple, les emails envoyés à `johndoe+sncf@votre.domaine.tld` atteriront dans le dossier 'sncf' de la boîte mail de John Doe (ou bien directement dans la boîle mail si ce dossier n'existe pas). C'est une technique pratique pour par exemple fournir une adresse mail à un site puis facilement trier (via des filtres automatiques) les courriers venant de ce site.
|
||||
|
||||
Que se passe-t-il si mon serveur devient indisponible ?
|
||||
-----------------------------------------------
|
||||
|
|
|
@ -87,7 +87,7 @@ mount /dev/YOUR_DISK1 /media/storage
|
|||
|
||||
(Here, `/dev/YOUR_DISK1` corresponds to the first partition on the disk)
|
||||
|
||||
Next, you should be able to create files in `/media/stockage`, and, for instance, add `/media/stockage` as an external drive in Nextcloud.
|
||||
Next, you should be able to create files in `/media/storage`, and, for instance, add `/media/storage` as an external drive in Nextcloud.
|
||||
|
||||
## 4. Mount the disk automatically at boot
|
||||
|
||||
|
|
108
faq_de.md
Normal file
|
@ -0,0 +1,108 @@
|
|||
# Häufig gestellte Fragen
|
||||
|
||||
#### Unter welcher Lizenz wird YunoHost angeboten ?
|
||||
|
||||
YunoHost steht unter der freien GNU AGPL v.3 Lizenz.
|
||||
|
||||
YunoHost basiert auf Debian, also auch auf Lizenzen von Debian Bestandteilen.
|
||||
|
||||
Die Anwendungen und Applikations-Pakete stehen unter ihren jeweiligen, eigenen Lizenzen.
|
||||
|
||||
|
||||
#### Was ist das Ziel von YunoHost ?
|
||||
|
||||
Wir glauben, dass Dezentralisierung sowie Kontrolle und Verantwortung über die eigenen Daten und Dienste ein wichtiger Bestandteil einer freien und demokratischen Gesellschaft ist.
|
||||
|
||||
Das YunoHost Projekt zielt darauf ab, eigenverantwortliches Hosting zu demokratisieren.
|
||||
|
||||
Wir bieten eine Software an, die es für jeden möglichst einfach machen soll, einen eigenen Server zu betreiben und zu verwalten - mit einem minimalen Aufwand an Wissen und Zeit.
|
||||
|
||||
|
||||
#### Aber was *macht* YunoHost überhaupt ?
|
||||
|
||||
YunoHost könnte einen Distribution oder ein Betriebssystem genannt werden, aber es ist eigentlich "nur" eine Ebene, die über Debian betrieben wird und welche die meiste, schwierige Arbeit für Sie übernimmt.
|
||||
|
||||
Zum Beispiel, wenn Sie Wordpress installieren möchten, müssten Sie einige Befehle eintippen, um Benutzer zu generieren, einen Webserver einrichten, einen SQL Server einrichten, das Wordpress Archiv herunterladen, entpacken, den Webserver kofigurieren, die SQL Datenbank konfigurieren und schließlich Wordpress einrichten. YunoHost übernimmt all das für Sie, zähmt das technische Chaos und "tippt alle Befehle für Sie", sodass Sie sich auf das konzentrieren können, was wirklich wichtig ist.
|
||||
|
||||
Mehr Informationen finden Sie [hier](whatsyunohost) !
|
||||
|
||||
|
||||
#### Kann ich meine eigene, persönliche Internetseite mit YunoHost betreiben ?
|
||||
|
||||
Ja ! Werfen Sie einen Blick auf die [Custom Web app](https://github.com/YunoHost-Apps/my_webapp_ynh).
|
||||
Dort erhalten Sie ein "leeres Gefäß" : nach der Installation, laden Sie einfach Ihre Dateien and den jeweiligen Ort hoch (via SSH/SCP or SFTP). PHP und eine SQL Datenbank steht Ihnen bei Bedarf zur Verfügung.
|
||||
|
||||
|
||||
#### Kann ich viele voneinander unabhängige Internetseiten mit unterschiedlichen Domain-Namen betreiben ?
|
||||
|
||||
Ja ! YunoHost ermöglicht das Anlegen mehrerer Benutzer und Domain-Namen. Manche Apllikationen wie *WordPress* oder *Web App Multi Custom* sind mehrinstanzenfähig und können mehrmals installiert werden.
|
||||
|
||||
|
||||
#### Wieso kann ich Anwendungen nicht über die IP-Adresse erreichen ?
|
||||
|
||||
Die [SSO](https://github.com/Kloadut/SSOwat/) (Single Sign-on) Technik kann Benutzer nicht richtig authentifizieren, wenn sie auf den Server nur über die IP zugreifen. Wenn Sie keine Möglichkeit haben, die DNS korrekt zu konfigurieren, können Sie als temporäre Notlösung [die `Hosts` Datei (letztes §)](dns_local_network_en) auf Ihrem Computer modifizieren.
|
||||
|
||||
|
||||
#### Was ist das Geschäftsmodell von YunoHost ?
|
||||
|
||||
Momentan wird YunoHost nur von Freiwiligen betrieben, die in ihrer Freizeit an dem Projekt arbeiten. Im Grunde ist bisher kein Geld im Spiel (abgesehen von Serverkosten oder Stickern :P).
|
||||
|
||||
Vor dem Hintergrund, dass einige Mitwirkende sehr viel zeit in das Projekt investieren, überlegen wir derzeit, wie wir das Projekt langfristig tragfähig machen können.
|
||||
|
||||
Dies könnte durch Spenden oder öffentliche Gelder erricht werden. Einige Mitwirkenden arbeiten an professionellen Angeboten in Zusammenhang mit YunoHost.
|
||||
|
||||
|
||||
#### Kann ich für das Projekt spenden ?
|
||||
|
||||
Ja, das können Sie ! YunoHost braucht Geld, um die Server und Domain-Namen zu bezahlen. Wir möchten außerdem erreichen, dass die Mitwirkenden weiterhin zum Projekt beitragen können und sich nicht nach anderen Jobs umschauen müssen.
|
||||
|
||||
Sie können [auf Liberapay spenden](https://liberapay.com/yunohost).
|
||||
|
||||
Wenn Ihnen das möglich ist, können Sie auch gerne Sachspenden leisten (ein Teil unserer Infrastruktur ist auf Server von Dritten angewiesen).
|
||||
|
||||
|
||||
#### Wie kann ich zum Projekt beitragen ?
|
||||
|
||||
Es gibt viele Wege [zum Projekt beizutragen](contribute) :).
|
||||
|
||||
Zögern Sie nicht, mit uns über Ihre Ideen zu sprechen!
|
||||
|
||||
Es ist ein weit verbreitetes Missverständnis, dass Neulinge bei offenen Softwareprojekten nicht "ausreichend qualifiziert" sind. Wer ist das schon :) ? Was wirklich zählt, ist, [dass Sie mögen, was Sie tun](https://www.youtube.com/watch?v=zIbR5TAz2xQ&t=113s), nett zu anderen Menschen, geduldig und starrköpfig gegenüber Maschinen sind und etwas freie Zeit haben. Abgesehen davon ist einfach alles was Sie tun können, schon mehr als genug!
|
||||
|
||||
|
||||
#### Was sind YunoHost organisatorische Grundsätze ?
|
||||
|
||||
Das beschreiben wir in [diesem Dokument](https://github.com/YunoHost/project-organization/blob/master/yunohost_project_organization.md) :).
|
||||
|
||||
|
||||
#### Werdet ihr YunoHosts für [Lieblingsdistribution hier einfügen] portieren ?
|
||||
|
||||
Die kurze Antwort: Nein. Wir haben nicht die Energie dafür und es ist eh irrelevant.
|
||||
|
||||
<a data-toggle="collapse" data-target="#willyouportyunohost" href="#">Die lange Antwort</a>
|
||||
<div id="willyouportyunohost" class="collapse">
|
||||
<p>Wer sich auf Distrowars einlässt oder denkt, dass Dabian "schmutzig" sei, ist nicht die Zielgruppe von YunoHost.</p>
|
||||
|
||||
<p>YunoHost soll nicht-technikversierte Leute ansprechen, die einfach nur wollen, dass ihr Server funktioniert. Debian hat seine Macken, aber es ist eine bekannte und verbreitete Distributionen für Server. Es ist stabil. Die meiste self-hosted Software ist auf die eine oder andere Weise kompatibel mit Debian. Wer ein bisschen CLI auf seinem eigenen Ubuntu/Mint Computer betreibt, kann sich selbst etwas zusammenhacken. Es gibt kein Killer-Feature in anderen Distributionen, das es notwendig macht, dass YunoHost wechselt oder portiert wird.</p>
|
||||
|
||||
<p>Sollte Sie das nicht überzeugen, gibt es ausreichend andere Projekte für andere Distributionen mit einer anderen Philosophie dahinter.</p>
|
||||
</div>
|
||||
|
||||
|
||||
#### Ich hab gesehen, wie das Packen von Apps funktioniert? Warum erfindet ihr das Rad neu und benutzt nicht [hier bevorzugtes Paketformat einfügen] ?
|
||||
|
||||
Kurze Antwort: Machen wir nicht.
|
||||
|
||||
Mittellange Antwort: Früher wurden die Apps in .deb gepackt. Was für ein Albtraum. Wir sind jetzt glücklicher ;).
|
||||
|
||||
<a data-toggle="collapse" data-target="#whyareyoureinventingpackaging" href="#">Die lange Antwort</a>
|
||||
<div id="whyareyoureinventingpackaging" class="collapse">
|
||||
|
||||
<p>Das Ziel von YunoHost ist es das Packen einfacher zu machen. Von Anfang an wollten wir es so simple wie möglich gestalten, nach dem Motto: « wer die App manuell installieren kann, sollte die Schritte für die Installation und Deinstallation der Pakete ohne besonderes Training kopieren und einfügen können ». Bei Debian Paketen ist das nicht der Fall.</p>
|
||||
|
||||
<p>Es hat sich herausgestellt, dass das Packen für YunoHost einen leicht anderen Zweck erfüllt als das Erstellen klassischer Pakete wie .deb. Debian Pakete haben nur den Anspruch Dateien, Befehle, Programme und Dienste auf dem System zu installieren. Es bleibt oft an Ihnen diese richtig zu konfigurieren, weil es einfach keinen standardisierte Server-Konfiguration gibt. Typischerweise erfordern Web-Apps einen sehr hohen Konfigurationsaufwand, weil sie auf dem Webserver und einer Datenbank (und dem single sign-on) aufbauen.</p>
|
||||
|
||||
<p>YunoHost richtet Konzepte auf höchster Ebene ein (Apps, Domain-Namen, Benutzer, ...) und definiert eine standardmäßige Einrichtung (Nginx, Postfix, Metronome, SSOwat, ...) und kann deshalb die Konfiguration für den Anwender übernehmen.</p>
|
||||
|
||||
<p>Wer trotzdem glaubt, man könne deb Pakete dazu bringen, all dies zu leisten, möge sich die vorherige Antwort anschauen.</p>
|
||||
</div>
|
85
filezilla.md
Normal file
|
@ -0,0 +1,85 @@
|
|||
# Exchange files with your server using a graphical interface
|
||||
|
||||
This page explains how to exchange files (backup archives, music, pictures,
|
||||
movies, ...) with your server using a graphical interface for the (S)FTP protocol.
|
||||
This is an alternative to using `scp` which can be deemed technical and cryptic,
|
||||
or using an app like Nextcloud.
|
||||
|
||||
[FileZilla](https://filezilla-project.org/) can be used for this. It is a free
|
||||
software and is available for Windows, Linux and macOS.
|
||||
|
||||
## Download and install FileZilla
|
||||
|
||||
Get the client from the [download page](https://filezilla-project.org/download.php?type=client). It should automatically detect the version needed for your computer. Otherwise, follow the instructions to [install the client](https://wiki.filezilla-project.org/Client_Installation)
|
||||
|
||||
Install the program and run *Filezilla*.
|
||||
|
||||
## Configuration
|
||||
|
||||
1. Click the *Site Manager* icon in the upper left to begin.
|
||||
|
||||

|
||||
|
||||
2. Click **New Site** and give a name the server you will be using : *Family* here. Fill the settings as on the screenshot (replace the server adress with your own), and click on **Connect**. (N.B. : if you want to interact with the [custom webapp](https://github.com/YunoHost-Apps/my_webapp_ynh) files, you should use a different user than `admin`. Refer to the custom webapp documentation.)
|
||||
|
||||

|
||||
|
||||
3. You will get a warning as you connect for the first time to the server. *You can ignore it safely the first time you get it.*
|
||||
|
||||

|
||||
|
||||
4. Filezilla is now asking the `admin` password to connect to your server.
|
||||
|
||||

|
||||
|
||||
5. Once bookmarked, your server will be backup up and you will get this screen.
|
||||
|
||||

|
||||
|
||||
<div class="alert alert-success">
|
||||
<span class="glyphicon glyphicon-chevron-right"></span> You can now use your new bookmark to connect to the server
|
||||
</div>
|
||||
|
||||
## Usage
|
||||
|
||||
1. Connect to the Site created previously. *Your passwork might be asked again*
|
||||
|
||||
The left panel corresponds to your computer. The right panel corresponds to your remote Yunohost server. You can browse folders and drag-and-drop files between the two panels.
|
||||
|
||||

|
||||
|
||||
2. In the right panel, you can browse to `/home/yunohost.backup/archives/` to find [backup archives](/backup).
|
||||
|
||||

|
||||
|
||||
<div class="alert alert-warning">
|
||||
<span class="glyphicon glyphicon-cloud-download"></span> Be sure to download both the `.tar.gz` and `.json` files.
|
||||
</div>
|
||||
|
||||

|
||||
|
||||
----
|
||||
|
||||
Sources
|
||||
|
||||
* [Official documentation](https://wiki.filezilla-project.org/FileZilla_Client_Tutorial_(en))
|
||||
* [General tutorial about using FileZilla](https://www.rc.fas.harvard.edu/resources/documentation/sftp-file-transfer/)
|
||||
|
||||
## Alternatives to Filezilla
|
||||
|
||||
### Linux
|
||||
|
||||
From any recent Linux, you should be able to use the `file manager` to reach your server.
|
||||
|
||||
Nautilus from Gnome3 has features similar to FileZilla, out of the box.
|
||||
|
||||
* <https://help.gnome.org/users/gnome-help/stable/nautilus-connect.html.en>
|
||||
* <https://www.techrepublic.com/article/how-to-use-linux-file-manager-to-connect-to-an-sftp-server/>
|
||||
|
||||
### Windows
|
||||
|
||||
* [WinSCP](https://winscp.net/) is also a nice candidate for Windows
|
||||
|
||||
### MacOS
|
||||
|
||||
Feel free to complete this part
|
87
filezilla_fr.md
Normal file
|
@ -0,0 +1,87 @@
|
|||
# Échanger des fichiers avec son serveur à l'aide d'une interface graphique
|
||||
|
||||
Cette page explique comment échanger des fichiers (sauvegardes, musiques,
|
||||
photos, films, ...) avec son serveur à l'aide d'un outil graphique. C'est donc
|
||||
une méthode alternative au fait d'utiliser la commande `scp` qui peut être jugée
|
||||
technique et cryptique, ou de devoir installer Nextcloud.
|
||||
|
||||
[FileZilla](https://filezilla-project.org/) permet d'accomplir cela. Il s'agit
|
||||
d'un logiciel libre disponible pour Windows, Linux et MacOS.
|
||||
|
||||
## Télécharger et installer FileZilla
|
||||
|
||||
Vous pouvez télécharger FileZilla depuis [cette page](https://filezilla-project.org/download.php?type=client).
|
||||
Le site devrait détecter automatiquement la version nécessaire pour votre ordinateur.
|
||||
Sinon, suivez les instructions pour [installer le client](https://wiki.filezilla-project.org/Client_Installation)
|
||||
|
||||
Installez le programme et lancez *Filezilla*.
|
||||
|
||||
## Configuration
|
||||
|
||||
1. Cliquez sur l'icône *Gestionnaire de Sites* en haut à gauche de sorte à crééer une configuration utilisable ultérieurement.
|
||||
|
||||

|
||||
|
||||
2. Cliquez sur **Nouveau site** et donnez un nom au serveur que vous allez utiliser. Par exemple "Famille". Remplissez les paramètres comme sur la capture d'écran (en remplaçant l'adresse du serveur par la votre). Une fois terminé, cliquez sur **Connexion**. (N.B. : si vous souhaitez éditer les fichiers de l'application [custom webapp](https://github.com/YunoHost-Apps/my_webapp_ynh), il vous faudra utiliser un autre utilisateur que admin. Se référer à la documentation de custom webapp.)
|
||||
|
||||

|
||||
|
||||
3. Vous recevrez un avertissement. *Vous pouvez l'ignorer si il s'agit de la première connexion*.
|
||||
|
||||

|
||||
|
||||
4. Filezilla vous demande maintenant le mot de passe `admin` pour vous connecter à votre serveur
|
||||
|
||||

|
||||
|
||||
5. Une fois cette configuration créée, elle sera réutilisable les fois suivanteS.
|
||||
|
||||

|
||||
|
||||
<div class="alert alert-success">
|
||||
<span class="glyphicon glyphicon-chevron-right"></span> Vous pouvez désormais utiliser cette configuration pour vous connecter.
|
||||
</div>
|
||||
|
||||
## Utilisation
|
||||
|
||||
1. Connectez-vous au Site créé précédemment. *Il se peut que le mot de passe soit redemandé.*
|
||||
|
||||
La partie gauche correspond à votre ordinateur. La partie droite correspond au serveur YunoHost distant. Vous pouvez naviguer dans les dossiers et faire des glisser-déposer entre les deux panneaux.
|
||||
|
||||

|
||||
|
||||
2. Dans le panneau de droite, vous pouvez aller dans `/home/yunohost.backup/archives/` pour trouver les archives de [sauvegardes](/backup_fr).
|
||||
|
||||

|
||||
|
||||
<div class="alert alert-warning">
|
||||
<span class="glyphicon glyphicon-cloud-download"></span> Assurez-vous de télécharger à la fois le fichier `.tar.gz` et le fichier `.json`
|
||||
</div>
|
||||
|
||||

|
||||
|
||||
----
|
||||
|
||||
Sources
|
||||
|
||||
* [Documentation officielle](https://wiki.filezilla-project.org/FileZilla_Client_Tutorial_(fr))
|
||||
* [Tutoriel général à Filezilla](https://www.rc.fas.harvard.edu/resources/documentation/sftp-file-transfer/)
|
||||
|
||||
## Alternatives à Filezilla
|
||||
|
||||
### Sous Linux
|
||||
|
||||
Depuis n'importe quel Linux récent, vous devriez pouvoir utiliser le gestionnaire de fichiers pour accéder à votre serveur.
|
||||
|
||||
Nautilus de Gnome3 intègre de base des fonctionnalités similaires à FileZilla :
|
||||
|
||||
* <https://help.gnome.org/users/gnome-help/stable/nautilus-connect.html.en>
|
||||
* <https://www.techrepublic.com/article/how-to-use-linux-file-manager-to-connect-to-an-sftp-server/>
|
||||
|
||||
### Sous Windows
|
||||
|
||||
* [WinSCP](https://winscp.net/) est aussi un bon candidat pour Windows
|
||||
|
||||
### Sous MacOS
|
||||
|
||||
N'hésitez pas à compléter cette partie
|
|
@ -1,27 +1,27 @@
|
|||
# How to host yourself ?
|
||||
|
||||
You can host yourself at home (on a small computer), or on a remote server. Each solution has their pros and cons :
|
||||
You can host yourself at home (on a small computer), or on a remote server. Each solution has their pros and cons:
|
||||
|
||||
### At home, for instance on an ARM board or an old computer
|
||||
|
||||
You can host yourself at home with an ARM board or a re-purposed regular computer, connected to our home router/box.
|
||||
You can host yourself at home with an ARM board or a re-purposed regular computer, connected to your home router/box.
|
||||
|
||||
- **Pros** : you will have physical control on the machine and only need to buy the hardware ;
|
||||
- **Pros** : you will have physical control of the machine and only need to buy the hardware;
|
||||
- **Cons** : you will have to [manually configure your internet box](isp_box_config) and [might be limited by your ISP](isp).
|
||||
|
||||
### At home, behind a VPN
|
||||
|
||||
A VPN is an encrypted tunnel between two machines. In practice, it allows to make it "as is" you were connected to the Internet from somewhere else. This allows to still host yourself at home while bypassing possible limitations from your ISP. See also [the Internet Cube project](https://internetcu.be/) and [the FFDN](https://www.ffdn.org/).
|
||||
A VPN is an encrypted tunnel between two machines. In practice, it makes it "as if" you were directly, locally, connected to your server machine, but actually from somewhere else on the Internet. This allows you to still host yourself at home, while bypassing possible limitations of your ISP. See also [the Internet Cube project](https://internetcu.be/) and [the FFDN](https://www.ffdn.org/).
|
||||
|
||||
- **Pros** : you will have physical control on the machine, and the VPN hides your traffic from your ISP and allows to bypass its limitations ;
|
||||
- **Pros** : you will have physical control of the machine, and the VPN hides your traffic from your ISP and allows you to bypass its limitations;
|
||||
- **Cons** : you will have to pay a monthly subscription for the VPN.
|
||||
|
||||
### On a remote server (VPS or dedicated server)
|
||||
|
||||
You can rent a virtual private server or a dedicated machine to [associative](https://db.ffdn.org/) or commercial "Cloud" providers.
|
||||
You can rent a virtual private server or a dedicated machine from [associative](https://db.ffdn.org/) or commercial "Cloud" providers.
|
||||
|
||||
- **Pros** : your server and its internet connectivity will be fast ;
|
||||
- **Cons** : you will have to pay a monthly subscription and won't have physical control on your server.
|
||||
- **Pros** : your server and its internet connectivity will be fast;
|
||||
- **Cons** : you will have to pay a monthly subscription and won't have physical control of your server.
|
||||
|
||||
### Summary
|
||||
|
||||
|
@ -42,12 +42,12 @@ You can rent a virtual private server or a dedicated machine to [associative](ht
|
|||
</tr>
|
||||
<tr>
|
||||
<td style="text-align:center;">Monthly cost</td>
|
||||
<td style="text-align:center;" class="success">Neglictible<br><small>(electricity)</small></td>
|
||||
<td style="text-align:center;" class="success">Negligible<br><small>(electricity)</small></td>
|
||||
<td style="text-align:center;" class="warning">Around 5€ <br><small>(VPN)</small></td>
|
||||
<td style="text-align:center;" class="warning">Starting at ~3€ <br><small>(VPS)</small></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align:center;">Physical control<br>on the machine</td>
|
||||
<td style="text-align:center;">Physical control<br>of the machine</td>
|
||||
<td style="text-align:center;" class="success">Yes</td>
|
||||
<td style="text-align:center;" class="success">Yes</td>
|
||||
<td style="text-align:center;" class="danger">No</td>
|
||||
|
@ -71,12 +71,12 @@ You can rent a virtual private server or a dedicated machine to [associative](ht
|
|||
</tr>
|
||||
<tr>
|
||||
<td style="text-align:center;">RAM</td>
|
||||
<td style="text-align:center;" class="warning" colspan="2">Typically 500 Mo or 1 Go</td>
|
||||
<td style="text-align:center;" class="warning" colspan="2">Typically 500 Mb or 1 Gb</td>
|
||||
<td style="text-align:center;" class="warning">Related to server cost</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align:center;">Internet connectivity</td>
|
||||
<td style="text-align:center;" class="warning" colspan="2">Depends of home connectivity</td>
|
||||
<td style="text-align:center;" class="warning" colspan="2">Depends on home connectivity</td>
|
||||
<td style="text-align:center;" class="success">Typically pretty good</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
|
|
|
@ -4,14 +4,14 @@ Vous pouvez vous auto-héberger à la maison (sur un petit ordinateur), ou sur u
|
|||
|
||||
### À la maison, par exemple sur une carte ARM ou un ancien ordinateur
|
||||
|
||||
Vous pouvez vous hébergez chez vous, sur une carte ARM ou un vieil ordinateur, connecté à votre box internet.
|
||||
Vous pouvez vous héberger chez vous, sur une carte ARM ou un vieil ordinateur, connecté à votre box internet.
|
||||
|
||||
- **Avantages** : vous aurez un contrôle physique sur la machine et avez seulement besoin d'acheter le matériel initial ;
|
||||
- **Inconvénients** : il vous faudra [configuré manuellement votre box internet](isp_box_config) et serez possiblement [limité par certains aspects de votre fournisseur d'accès internet](isp).
|
||||
- **Inconvénients** : il vous faudra [configurer manuellement votre box internet](isp_box_config) et serez possiblement [limité par certains aspects de votre fournisseur d'accès internet](isp).
|
||||
|
||||
### À la maison, derrière un VPN
|
||||
|
||||
Un VPN est un tunnel chiffré entre deux machines. En pratique, cela permet de faire "comme si" une machine était connecté depuis ailleurs. Ceci permet de s'auto-héberger à la maison tout en contournant les limitations du fournisseur d'accès internet. Voir aussi [le projet Brique Internet](https://labriqueinter.net/) et [la FFDN](https://www.ffdn.org/).
|
||||
Un VPN est un tunnel chiffré entre deux machines. En pratique, cela permet de faire "comme si" une machine était connectée depuis ailleurs. Ceci permet de s'auto-héberger à la maison tout en contournant les limitations du fournisseur d'accès internet. Voir aussi [le projet Brique Internet](https://labriqueinter.net/) et [la FFDN](https://www.ffdn.org/).
|
||||
|
||||
- **Avantages** : vous aurez un contrôle physique sur la machine, et le VPN permettra de cacher votre traffic vis-à-vis de votre FAI ainsi que de contourner ses limitations ;
|
||||
- **Inconvénients** : il vous faudra payer des frais mensuels pour le VPN.
|
||||
|
|
BIN
images/Mediawiki_logo.png
Normal file
After Width: | Height: | Size: 9.8 KiB |
BIN
images/Mediawiki_screenshot.png
Normal file
After Width: | Height: | Size: 184 KiB |
BIN
images/PluXml_logo.png
Normal file
After Width: | Height: | Size: 12 KiB |
BIN
images/PluXml_screenshot.jpg
Normal file
After Width: | Height: | Size: 45 KiB |
BIN
images/filezilla_1.png
Normal file
After Width: | Height: | Size: 11 KiB |
BIN
images/filezilla_2.png
Normal file
After Width: | Height: | Size: 46 KiB |
BIN
images/filezilla_3.png
Normal file
After Width: | Height: | Size: 12 KiB |
BIN
images/filezilla_4.png
Normal file
After Width: | Height: | Size: 7.2 KiB |
BIN
images/filezilla_5.png
Normal file
After Width: | Height: | Size: 12 KiB |
BIN
images/filezilla_6.png
Normal file
After Width: | Height: | Size: 49 KiB |
BIN
images/filezilla_7.png
Normal file
After Width: | Height: | Size: 45 KiB |
BIN
images/filezilla_8.png
Normal file
After Width: | Height: | Size: 44 KiB |
23
index.md
|
@ -6,17 +6,16 @@
|
|||
|
||||
<div class="punchline">
|
||||
<p>
|
||||
<span class="yolo 1" style="color: #FF3399;">Self-hosting for you, mom</span>
|
||||
<span class="yolo 2" style="color: #6699FF;">Haters gonna host</span>
|
||||
<span class="yolo 3" style="color: #66FF33;">I host myself, Yo!</span>
|
||||
<span class="yolo 4" style="color: #00FFCC;">Go host yourself!</span>
|
||||
<span class="yolo 5" style="color: #FF5050;">Get off of my cloud</span>
|
||||
<span class="yolo 6" style="color: #FF0066;">Host me I’m famous</span>
|
||||
<span class="yolo 7" style="color: #3366FF;">Try Internet</span>
|
||||
<span class="yolo 8" style="color: #FFFFFF;">How I met your server</span>
|
||||
<span class="yolo 9" style="color: #FF6600;">john@doe.org</span>
|
||||
<span class="yolo 10" style="color: #FF5050;">dude, Y U NO Host?!</span>
|
||||
<span class="yolo 11" style="color: #66FF33;">Keep calm and host yourself</span>
|
||||
<span class="yolo 1" style="color: #6699FF;">Haters gonna host</span>
|
||||
<span class="yolo 2" style="color: #66FF33;">I host myself, Yo!</span>
|
||||
<span class="yolo 3" style="color: #00FFCC;">Go host yourself!</span>
|
||||
<span class="yolo 4" style="color: #FF5050;">Get off of my cloud</span>
|
||||
<span class="yolo 5" style="color: #FF0066;">Host me I’m famous</span>
|
||||
<span class="yolo 6" style="color: #3366FF;">Try Internet</span>
|
||||
<span class="yolo 7" style="color: #FFFFFF;">How I met your server</span>
|
||||
<span class="yolo 8" style="color: #FF6600;">john@doe.org</span>
|
||||
<span class="yolo 9" style="color: #FF5050;">dude, Y U NO Host?!</span>
|
||||
<span class="yolo 10" style="color: #66FF33;">Keep calm and host yourself</span>
|
||||
</p>
|
||||
<button class="btn btn-primary btn-lg btn-block yolobtn">What?</button>
|
||||
</div>
|
||||
|
@ -44,7 +43,7 @@
|
|||
<div class="call-to-action">
|
||||
<a class="btn btn-primary btn-lg" href="/try">Try it</a>
|
||||
<a class="btn btn-success btn-lg" href="/install">Get started</a>
|
||||
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-3-release-sortie-de-yunohost-3-3/6332">YunoHost v3.3</a></small></p>
|
||||
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-4-release-sortie-de-yunohost-3-4/6950">YunoHost v3.4</a></small></p>
|
||||
</div>
|
||||
|
||||
<div class="row cf">
|
||||
|
|
|
@ -40,7 +40,7 @@
|
|||
<div dir="auto" class="call-to-action">
|
||||
<a class="btn btn-primary btn-lg" href="/try">تجريب</a>
|
||||
<a class="btn btn-success btn-lg" href="/install">تنصيب</a>
|
||||
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-3-release-sortie-de-yunohost-3-3/6332">YunoHost v3.3</a></small></p>
|
||||
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-4-release-sortie-de-yunohost-3-4/6950">YunoHost v3.4</a></small></p>
|
||||
</div>
|
||||
|
||||
<hr />
|
||||
|
|
|
@ -44,7 +44,7 @@ Self-Hosting für jedermann zugänglich zu machen.</small></h1>
|
|||
<div class="call-to-action">
|
||||
<a class="btn btn-primary btn-lg" href="/try">Ausprobieren</a>
|
||||
<a class="btn btn-success btn-lg" href="/install">Beginnen</a>
|
||||
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-3-release-sortie-de-yunohost-3-3/6332">YunoHost v3.3</a></small></p>
|
||||
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-4-release-sortie-de-yunohost-3-4/6950">YunoHost v3.4</a></small></p>
|
||||
</div>
|
||||
|
||||
<div class="row cf">
|
||||
|
|
|
@ -41,7 +41,7 @@
|
|||
<div class="call-to-action">
|
||||
<!-- <a class="btn btn-primary btn-lg" href="/try">Try it</a> -->
|
||||
<a class="btn btn-success btn-lg" href="/install">Get started</a>
|
||||
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-3-release-sortie-de-yunohost-3-3/6332">YunoHost v3.3</a></small></p>
|
||||
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-4-release-sortie-de-yunohost-3-4/6950">YunoHost v3.4</a></small></p>
|
||||
</div>
|
||||
|
||||
<div class="row cf">
|
||||
|
|
|
@ -39,7 +39,7 @@
|
|||
<div class="call-to-action">
|
||||
<a class="btn btn-primary btn-lg" href="/try_fr">Essayer</a>
|
||||
<a class="btn btn-success btn-lg" href="/install_fr">Installer</a>
|
||||
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-3-release-sortie-de-yunohost-3-3/6332">YunoHost v3.3</a></small></p>
|
||||
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-4-release-sortie-de-yunohost-3-4/6950">YunoHost v3.4</a></small></p>
|
||||
</div>
|
||||
|
||||
<hr />
|
||||
|
|
|
@ -44,7 +44,7 @@
|
|||
<div class="call-to-action">
|
||||
<a class="btn btn-primary btn-lg" href="/try">Provalo</a>
|
||||
<a class="btn btn-success btn-lg" href="/install">Per cominciare</a>
|
||||
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-3-release-sortie-de-yunohost-3-3/6332">YunoHost v3.3</a></small></p>
|
||||
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-4-release-sortie-de-yunohost-3-4/6950">YunoHost v3.4</a></small></p>
|
||||
</div>
|
||||
|
||||
<div class="row cf">
|
||||
|
|
|
@ -10,7 +10,7 @@
|
|||
|
||||
* Un matériel compatible x86 dédié à YunoHost : portable, netbook, ordinateur. Vous pouvez réutiliser n’importe quelle machine avec **256 Mo de RAM minimum**
|
||||
* Un autre ordinateur pour parcourir ce guide et accéder à votre serveur
|
||||
* Un [fournisseur d’accès correct](/isp_fr), de préférence avec une bonne vitesse d’upload
|
||||
* Un [fournisseur d’accès correct](/isp_fr), de préférence avec une bonne vitesse de téléversement (débit montant)
|
||||
* Une **clé USB** d’une capacité minimum d’1Go **OU** un **CD vierge** standard
|
||||
* ***Cas particulier*** : Si votre serveur n'a pas de carte graphique, il faut [préparer un iso qui démarre sur le port série](https://github.com/luffah/debian-mkserialiso).
|
||||
|
||||
|
|
89
install_it.md
Normal file
|
@ -0,0 +1,89 @@
|
|||
# Guida all'installazione
|
||||
|
||||
Ci sono diverse maniere per installare YunoHost. Il procedimento può essere leggermente diverso a seconda che si esegua a casa o su un server remoto, e dipende dall'hardware usato:
|
||||
**[Vedi i requisiti](/hardware)**
|
||||
|
||||
Questa pagina elenca alcune guide all'installazione.
|
||||
|
||||
---
|
||||
|
||||
<h1 style="font-weight: 100">Provalo</h1>
|
||||
|
||||
<div class="row">
|
||||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/try"><img height=150 src="/images/logo.png" style="vertical-align:bottom"><b><p>Server demo</p></b></a>
|
||||
</div>
|
||||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/install_on_virtualbox"><img src="/images/virtualbox.png" height=150 style="vertical-align:bottom"><b><p>Provalo in VirtualBox</p></b></a>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
<br>
|
||||
|
||||
---
|
||||
|
||||
<h1 style="font-weight: 100">Installalo a casa</h1>
|
||||
|
||||
<div class="row">
|
||||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/install_on_raspberry"><img src="/images/raspberrypi.jpg" height=150 style="vertical-align:bottom"><b><p>Su un Raspberry Pi</p></b></a>
|
||||
</div>
|
||||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/install_on_arm_board"><img src="/images/olinuxino.jpg" height=150 style="vertical-align:bottom; padding:20px"><b><p>Su una scheda ARM</p></b></a>
|
||||
</div>
|
||||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/install_iso"><img src="/images/computer.png" height=150 style="vertical-align:bottom"><b><p>Su un computer normale</p></b></a>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
|
||||
<br>
|
||||
|
||||
|
||||
---
|
||||
|
||||
<h1 style="font-weight: 100">Installalo su un server remoto</h1>
|
||||
|
||||
<div class="alert alert-info" markdown="1">
|
||||
<span class="glyphicon glyphicon-heart"></span> ISP locali potrebbero essere in grado di fornire un *Server Privato Vrituale* (VPS), gesito da esseri umani che rispettano gli utenti e si preoccupano della [Net Neutrality](https://en.wikipedia.org/wiki/Net_neutrality) ! Guarda [questa pagina](https://db.ffdn.org/) per maggiori informazioni.
|
||||
</div>
|
||||
|
||||
<div class="row">
|
||||
|
||||
<div class="block-center text-center">
|
||||
<a href="/install_on_vps"><img src="/images/vps.png" height=150 style="vertical-align:bottom; text-align:center"><b><p>Su un server dedicato o un server privato virtuale (VPS)</p></b></a>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
|
||||
<br>
|
||||
|
||||
---
|
||||
|
||||
<h1 style="font-weight: 100">Avanzate / altri</h1>
|
||||
|
||||
<div class="row">
|
||||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/vagrant"><img src="/images/vagrant.png" height=150 style="vertical-align:bottom"><b><p>Su Vagrant</p></b></a>
|
||||
</div>
|
||||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/install_on_debian"><img height=150 src="/images/debian-logo.png" style="vertical-align:bottom">
|
||||
<b><p>Su Debian 9/Stretch</p></b></a>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
|
||||
<br>
|
|
@ -1,12 +1,12 @@
|
|||
# Installer YunoHost manuellement
|
||||
|
||||
Une fois que vous avez accès à votre serveur (directement ou par SSH), vous pouvez installer YunoHost en executant cette commande en tant que root :
|
||||
Une fois que vous avez accès à votre serveur (directement ou par SSH), vous pouvez installer YunoHost en exécutant cette commande en tant que root :
|
||||
|
||||
```bash
|
||||
curl https://install.yunohost.org | bash
|
||||
```
|
||||
|
||||
<small>*(Si `bash` n'est pas installé sur votre système, il vous faudra peut-être l'installer avec `apt install bash`. Autrement, sinon la commande n'affiche rien du tout, vous pouvez tenter `apt install ca-certificates`)*</small>
|
||||
<small>*(Si `bash` n'est pas installé sur votre système, il vous faudra peut-être l'installer avec `apt install bash`. Autrement, si la commande n'affiche rien du tout, vous pouvez tenter `apt install ca-certificates`)*</small>
|
||||
|
||||
Une fois l'installation terminée, il vous faudra [**procéder à la post-installation**](/postinstall)
|
||||
|
||||
|
|
60
install_on_raspberry_de.md
Normal file
|
@ -0,0 +1,60 @@
|
|||
# YunoHost auf einem Raspberry Pi installieren
|
||||
|
||||
*Alle Arten YunoHost zu installieren findest du **[hier](/install)**.*
|
||||
|
||||
<center>
|
||||
<img src="/images/raspberrypi.jpg" width=300 style="padding-bottom:20px">
|
||||
<img src="/images/micro-sd-card.jpg">
|
||||
</center>
|
||||
|
||||
<div class="alert alert-info" markdown="1">
|
||||
Vor der Einrichtung eines Servers zuhause ist es empfehlenswert [mögliche Einschränkungen deines Providers](/isp) zu kennen. Wenn er zu viele Einschränkungen vornimmt, kann es sinnvoll sein ein VPN zu nutzen um diese zum umgehen.
|
||||
</div>
|
||||
|
||||
## Voraussetzungen
|
||||
|
||||
- Einen Raspberry Pi 0, 1, 2 oder 3 ;
|
||||
- Eine microSD Karte: **8GB** Speicherplatz (mindestens) und **Class 10** Geschwindigkeit werden empfohlen (wie zum Beispiel die [Transcend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO)) ;
|
||||
- Ein Netzeil (entweder ein Steckernetzteil oder ein MicroUSB Kabel) ;
|
||||
- An Netzwerkkabel (RJ-45) um den Raspberry mit dem router zu verbinden. (Raspberry Pi Zero Nutzer können ein OTG Kabel nutzen, [Wifi dongle](https://core-electronics.com.au/tutorials/raspberry-pi-zerow-headless-wifi-setup.html).) ;
|
||||
- Einen [geeigneten Provider](/isp), am Besten einen mit einer guten upload Geschwindigkeit.
|
||||
|
||||
---
|
||||
|
||||
## Install with the pre-installed image (recommended)
|
||||
|
||||
<a class="btn btn-lg btn-default" href="/images">0. Download the pre-installed image for Raspberry Pi</a>
|
||||
|
||||
<a class="btn btn-lg btn-default" href="/copy_image">1. Flash the SD card with the image</a>
|
||||
|
||||
<a class="btn btn-lg btn-default" href="/plug_and_boot">2. Plug & boot</a>
|
||||
|
||||
<a class="btn btn-lg btn-default" href="/ssh">3. Connect to your server with SSH</a>
|
||||
|
||||
<a class="btn btn-lg btn-default" href="/postinstall">4. Proceed to post-installation</a>
|
||||
|
||||
---
|
||||
|
||||
## Manual installation (advanced users)
|
||||
|
||||
<div class="alert alert-warning" markdown="1">
|
||||
We do not recommend the manual installation because it is more technical and longer than using the pre-installed image. This documentation is only intended for advanced users.
|
||||
</div>
|
||||
|
||||
<div class="alert alert-warning" markdown="1">
|
||||
The latest Rasbpian images requires a screen and a keyboard, as it is no longer possible to connect directly to the Raspberry through SSH. Nevertheless it is possible to re-enable SSH at boot : before starting your Raspberry, put in the boot partition of the SD card an empty file named `ssh` (without extension).
|
||||
</div>
|
||||
|
||||
0. Install Raspbian Stretch Lite on the SD card ([instructions](https://www.raspberrypi.org/downloads/raspbian/)).
|
||||
|
||||
1. Connect to your Raspberry Pi with the user `pi`. Set the root password with
|
||||
```bash
|
||||
sudo passwd root
|
||||
```
|
||||
|
||||
2. Edit `/etc/ssh/sshd_config` to allow ssh login for root, by replacing `PermitRootLogin without-password` with `PermitRootLogin yes`. Reload the ssh daemon with `service ssh reload`.
|
||||
|
||||
3. Disconnect and reconnect, this time as root.
|
||||
|
||||
4. Then follow the <a href="/install_manually">generic manual install procedure</a>.
|
||||
|
13
isp.md
|
@ -2,9 +2,9 @@
|
|||
|
||||
<a class="btn btn-lg btn-default" href="/isp_box_config_fr"> Main configuration box</a>
|
||||
|
||||
Here is a non-comprehensive list of internet service providers by countries, wich contains criteria of tolerance to self-hosting.
|
||||
Here is a non-comprehensive list of internet service providers by country, which contains criteria about tolerance to self-hosting.
|
||||
|
||||
A "no" may cause problems of the using of your server or may require you to make additional configurations. Status in brackets indicates the default behavior.
|
||||
A "no" may cause problems for using your server or may require you to make additional configuration changes. Status in brackets indicates the default behavior.
|
||||
|
||||
A list of French and Belgian ISPs is available on the [french page](/isp_fr).
|
||||
|
||||
|
@ -35,4 +35,11 @@ A list of French and Belgian ISPs is available on the [french page](/isp_fr).
|
|||
| --- | --- | --- | --- | --- | --- | --- |
|
||||
| Telus | Multiple | - | No. Extra charge | - | - | No. Extra charge |
|
||||
|
||||
If you want to add international ISPs information, please do consider [modifying this page](/write_documentation).
|
||||
### Sweden
|
||||
|
||||
| Service provider | Box (modem/router) | uPnP available | Port 25 openable | [Hairpinning](http://en.wikipedia.org/wiki/Hairpinning) | Customizable reverse DNS | Fix IP |
|
||||
| --- | --- | --- | --- | --- | --- | --- |
|
||||
| Telia | Multiple | Yes | No. Business only. | Yes | No. Business only. | No. Business only. |
|
||||
| Bredbandsbolaget | Multiple | Yes | No. Business only. | Yes | No. Business only. | No. Business only. |
|
||||
|
||||
If you want to add international ISPs information, please do consider [modifying this page](/write_documentation).
|
||||
|
|
|
@ -37,7 +37,7 @@ sudo nano /etc/postfix/main.cf
|
|||
puis, rajouter à la ligne :
|
||||
|
||||
```bash
|
||||
smtp_sasl_password_maps = hash:/etc/postfix/mdp_fai.conf
|
||||
smtp_sasl_password_maps = hash:/etc/postfix/sasl/mdp_fai.conf
|
||||
smtp_sasl_auth_enable = yes
|
||||
smtp_sasl_security_options = noanonymous
|
||||
relayhost = [smtp.orange.fr]:25
|
||||
|
|
|
@ -43,7 +43,7 @@ The scripts have to be placed in the `hooks` repository at the root of the YunoH
|
|||
|
||||
**Note**: `priority` is optional, default is `50`.
|
||||
|
||||
Take a look at the [ownCloud package](https://github.com/Kloadut/owncloud_ynh) for a working example.
|
||||
Take a look at the [Nextcloud package](https://github.com/YunoHost-Apps/nextcloud_ynh/) for a working example.
|
||||
|
||||
### Helpers
|
||||
<a class="btn btn-lg btn-default" href="packaging_apps_helpers_en">Helpers</a>
|
||||
|
@ -115,12 +115,21 @@ This Python script checks:
|
|||
* that the manifest doesn't have syntax errors
|
||||
* that scripts exit well before modifing the system during verification.
|
||||
|
||||
### Continuous integration
|
||||
|
||||
A continuous integration server is available for packagers who want to test their apps.
|
||||
<a class="btn btn-lg btn-default" href="packaging_apps_ci">Continuous integration</a>
|
||||
|
||||
### Publish and ask for testing your application
|
||||
|
||||
* Publishing a [post on the Forum](https://forum.yunohost.org/) with the [`App integration` category](https://forum.yunohost.org/c/app-integration), to ask for testing and feedback on your application.
|
||||
|
||||
* Ask your application to be added to the [app repository](https://github.com/YunoHost/apps) to be displayed in the [non-official apps list](apps_en). Specify its progress state: `notworking`, `inprogress`, or `working`.
|
||||
* If your application is released under a free software license, you may ask the YunoHost app team to integrate your application to the [app repository](https://github.com/YunoHost/apps) (c.f. also the [app list](apps_en)). You can add your application even if it is not stable or working yet : the current state can be specified to `notworking`, `inprogress`, or `working`.
|
||||
|
||||
- Subscribe to the [Apps mailing list](https://list.yunohost.org/cgi-bin/mailman/listinfo/apps) to be informed about packaging evolution.
|
||||
* If your application is *not* free software, then in the future, a non-official list might be created to handle them but is non-existent yet.
|
||||
|
||||
### Officalization of an application
|
||||
|
||||
**!! This section is obsolete as of 08/03/19** - The project's organization regarging this point is to be changed.
|
||||
|
||||
To become an official application, it must be tested well enough, be stable and should work on Debian Stretch 64 bits, 32 bits and ARM architectures. If you think those conditions are met, ask for [official integration](https://github.com/YunoHost/apps) of your application.
|
||||
|
|
41
packaging_apps_ci.md
Normal file
|
@ -0,0 +1,41 @@
|
|||
# Continuous integration
|
||||
|
||||
A continuous integration server is available for any packager willing to test an app with [Package_check](https://github.com/YunoHost/package_check).
|
||||
|
||||
<a class="btn btn-lg btn-default" href="https://ci-apps-dev.yunohost.org">ci-apps-dev</a>
|
||||
|
||||
This server is free to use for any of you, you just need an account.
|
||||
To do so, ask to a member of the Apps group on our [Applications chatroom](/chat_rooms)
|
||||
|
||||
To create an account on this CI, you'll need two things:
|
||||
- A name (To create an user and to give it a directory).
|
||||
- A public ssh key (For your access to the server).
|
||||
|
||||
When that's done, you'll be able to access the server and put your apps on it.
|
||||
To connect to the server use:
|
||||
```bash
|
||||
ssh USER@ci-apps-dev.yunohost.org -i YOUR_PRIVATE_KEY
|
||||
```
|
||||
|
||||
You will find an empty directory, ready to receive your apps.
|
||||
As soon as you push an app into your directory, in a 5 minutes maximum delay, a new job will be created for this app and executed by the CI.
|
||||
Each time you will update this app, a new test will be executed.
|
||||
|
||||
However, to prevent any security issues, your ssh connection will be very limited.
|
||||
You can only use `sftp` or `rsync` to copy your apps into that directory. `Git` isn't available, neither most of the usual bash commands.
|
||||
To ease your usage of this CI, a small script can be used to copy your apps to your directory.
|
||||
|
||||
Copy this [script](https://raw.githubusercontent.com/YunoHost/CI_package_check/master/dev_CI/Send%20CI%20dev.sh) into your usual working directory and fill it with your info.
|
||||
|
||||
---
|
||||
|
||||
# Other continuous integration servers
|
||||
|
||||
For your information, here the list of all our continuous integration servers.
|
||||
Those CI are automatic, you can't use them directly. They're working on their own.
|
||||
|
||||
- [Official CI](https://ci-apps.yunohost.org): Our official CI, working on a x86-64 system. It is in charge of determining levels for all working apps.
|
||||
- [ARM CI](https://ci-apps-arm.yunohost.org): This CI is working with multiple Raspberry-Pi, own by members of the YunoHost community. Tests are running on Raspberry-Pi to determine if apps are working on this architecture.
|
||||
- [Unstable/Testing CI](https://ci-apps-unstable.yunohost.org): CI designed to run tests on the branches Unstable and Testing of YunoHost. Its purpose is to test those branches before an official release.
|
||||
- [Jessie CI](https://ci-stretch.nohost.me): CI running on a Debian Jessie system. This CI determine is apps are still working with the previous version of Debian and YunoHost before the version 3.
|
||||
- [HQ CI](https://ci-apps-hq.yunohost.org): **Incoming...** This CI runs automatic tests on branches of High Quality apps. Except the master branch, which is exclude from this CI, all branches added to a High Quality app will be added to this CI to be tested.
|
41
packaging_apps_ci_fr.md
Normal file
|
@ -0,0 +1,41 @@
|
|||
# Intégration continue
|
||||
|
||||
Un serveur d'intégration continue est disponible pour tout packager souhaitant tester une application avec [Package_check](https://github.com/YunoHost/package_check).
|
||||
|
||||
<a class="btn btn-lg btn-default" href="https://ci-apps-dev.yunohost.org">ci-apps-dev</a>
|
||||
|
||||
Ce serveur est libre d'accès pour chacun d'entre vous, vous avez juste besoin d'un compte.
|
||||
Pour ce faire, demandez à un membre du groupe Apps sur notre [chatroom Applications](/chat_rooms)
|
||||
|
||||
Pour créer un compte sur ce CI, vous aurez besoin de deux choses:
|
||||
- Un nom (Pour créer un utilisateur et lui donner un répertoire).
|
||||
- Une clé ssh publique (Pour votre accès au serveur).
|
||||
|
||||
Une fois cela fait, vous pourrez accéder au serveur et y déposer vos applications.
|
||||
Pour vous connecter au serveur, utilisez :
|
||||
```bash
|
||||
ssh USER@ci-apps-dev.yunohost.org -i YOUR_PRIVATE_KEY
|
||||
```
|
||||
|
||||
Vous trouverez un répertoire vide, prêt à recevoir vos applications.
|
||||
Dès que vous déposer une application dans votre répertoire, dans un délai maximum de 5 minutes, un nouveau job sera créé pour cette application et exécuté par le CI.
|
||||
Chaque fois que vous mettrez à jour cette application, un nouveau test sera exécuté.
|
||||
|
||||
Cependant, pour éviter tout problème de sécurité, votre connexion ssh sera très limitée.
|
||||
Vous ne pouvez utiliser que `sftp` ou `rsync` pour copier vos applications dans ce répertoire. `Git` n'est pas disponible, ni la plupart des commandes bash habituelles.
|
||||
Pour faciliter votre utilisation de ce CI, un petit script peut être utilisé pour copier vos applications dans votre répertoire.
|
||||
|
||||
Copiez ce [script](https://raw.githubusercontent.com/YunoHost/CI_package_check/master/dev_CI/Send%20CI%20dev.sh) dans votre répertoire de travail habituel et indiquez vos informations.
|
||||
|
||||
---
|
||||
|
||||
# Autres serveurs d'intégration continue
|
||||
|
||||
Pour votre information, voici la liste de tous nos serveurs d'intégration continue.
|
||||
Ces CI sont automatiques, vous ne pouvez pas les utiliser directement. Ils travaillent seuls.
|
||||
|
||||
- [Official CI](https://ci-apps.yunohost.org): Notre CI officiel, travaillant sur un système x86-64. Il est chargé de déterminer les niveaux pour toutes les applications notées 'working'.
|
||||
- [ARM CI](https://ci-apps-arm.yunohost.org): Ce CI travaille avec plusieurs Raspberry-Pi, appartenant à des membres de la communauté YunoHost. Les tests sont exécutés sur Raspberry-Pi pour déterminer si les applications fonctionnent sur cette architecture.
|
||||
- [Unstable/Testing CI](https://ci-apps-unstable.yunohost.org): CI conçu pour effectuer des tests sur les branches Unstable et Testing de YunoHost. Son rôle est de tester ces branches avant une sortie officielle.
|
||||
- [Jessie CI](https://ci-stretch.nohost.me): CI fonctionnant sur un système Debian Jessie. Ce CI détermine si les applications fonctionnent toujours avec la version précédente de Debian et YunoHost avant la version 3.
|
||||
- [HQ CI](https://ci-apps-hq.yunohost.org): **A venir...** Ce CI exécute des tests automatiques sur les branches des applications High Quality. A l'exception de la branche master, qui est exclue de ce CI, toutes les branches ajoutées à une application High Quality seront ajoutées à ce CI pour être testées.
|
|
@ -97,12 +97,21 @@ Il s’agit d’un script Python qui vérifie :
|
|||
* que le manifeste ne comporte pas d’erreur de syntaxe
|
||||
* que les scripts quittent bien avant de modifier le système lors de vérifications.
|
||||
|
||||
### Intégration continue
|
||||
|
||||
Un serveur d'intégration continue est a disposition des packagers désirant tester leurs applications.
|
||||
<a class="btn btn-lg btn-default" href="packaging_apps_ci">Intégration continue</a>
|
||||
|
||||
### Publiez et demandez des tests de votre application
|
||||
|
||||
* Demandez des tests et des retours sur votre application en publiant un [post sur le Forum](https://forum.yunohost.org/) dans la [catégorie `App integration`](https://forum.yunohost.org/c/app-integration).
|
||||
|
||||
* Faire une demande d’ajout de votre application dans le [dépôt des applications](https://github.com/YunoHost/apps) afin qu’elle soit affichée dans [la liste des apps non officielles](apps_fr). Préciser également son état d’avancement : `notworking`, `inprogress` ou `working`.
|
||||
* Si votre paquet et l'application qu'il contient sont sous licence libre, faites une demande d’ajout de votre application dans le [dépôt des applications](https://github.com/YunoHost/apps) (voir aussi [la liste des apps](apps_fr)). Vous pouvez ajouter une application même si celle-ci n'est pour le moment pas fonctionelle : l'état d'avancement peut être `notworking`, `inprogress` ou `working`.
|
||||
|
||||
- Inscrivez-vous à la [mailing list Apps](https://list.yunohost.org/cgi-bin/mailman/listinfo/apps) pour être tenu au courant des évolutions du packaging.
|
||||
* Si votre application n'est *pas* sous licence libre, il se peut qu'une liste non-officielle soit créée pour gérer ces applications. Ce n'est pour l'instant pas le cas.
|
||||
|
||||
### Officialisation d’une application
|
||||
|
||||
**!! Section obsolète au 08/03/19** - Le fonctionnement du projet est en cours d'évolution sur ce point.
|
||||
|
||||
Pour qu’une application devienne officielle, elle doit être suffisamment testée, stable et fonctionner sous Debian Stretch 64 bits, 32 bits et ARM. Si ces conditions vous paraissent réunies, demandez l’[intégration officielle](https://github.com/YunoHost/apps) de votre application.
|
||||
|
|
|
@ -32,6 +32,7 @@ Each YEP is associated with:
|
|||
| YEP 1.9 | Document the app | validated | AUTO | OFFICIAL (6) |
|
||||
| YEP 1.10 | Keep a clean version history | draft | manual | OFFICIAL (6) |
|
||||
| YEP 1.11 | Add app to [YunoHost bugtracker](https://github.com/YunoHost/issues/issues) | draft | manual | OFFICIAL (NA) |
|
||||
| YEP 1.12 | Follow the template from [example_ynh](https://github.com/YunoHost/example_ynh) | draft | manual | OFFICIAL (8) |
|
||||
| | | | | |
|
||||
| ** YEP 2 ** | ** Stabilize an app ** | ** Status ** | ** Test ** | ** Level ** |
|
||||
| YEP 2.1 | Respect the manifest format | validated | Home | INPROGRESS (5) |
|
||||
|
@ -112,7 +113,7 @@ These deposits have several functions:
|
|||
* indicate the state of operation of the packet;
|
||||
* indicate information about the support of a package.
|
||||
|
||||
For the `official.json` and` community.json` lists, registration is on [the git apps repository](https://github.com/YunoHost/apps).
|
||||
For the `official.json` and` community.json` lists maintained by the project team, registration is on [the git apps repository](https://github.com/YunoHost/apps). Other non-official lists may exists (including those for non-free apps for example), see more about that in the [community forum](https//forum.yunohost.org).
|
||||
|
||||
#### YEP 1.3
|
||||
##### Indicate the license associated with the package | draft | AUTO | WORKING |
|
||||
|
@ -120,6 +121,8 @@ The license of the packet must be specified in a `LICENSE` file at the root of t
|
|||
|
||||
The application lists official.json and community.json only accept packages with a free license, as well as the license for the contained application. Some free applications require non-free dependencies (example: mp3, drivers, etc.). In this case, you should add `&dep-non-free` to the acronym and if possible give details in the README.md of the package, in this case the integration will be accepted on a case-by-case basis.
|
||||
|
||||
**NB:** Apps not included in offical lists may still be installed: either manually with the URL to the app, or in a more practical way using non-official lists (which can be created and maintained by the community).
|
||||
|
||||
In the future, YunoHost will probably display details about the license of the application. To achieve this, the acronym must be the one from this [list of licenses listed in the SPDX](https://spdx.org/licenses/) (if there are 2 acronyms, the one containing the version number). For consistency, the case must be respected.
|
||||
|
||||
If the license is not present in the list, in this case it is necessary to indicate `free` or `non-free` depending on whether it is free or not and give the user the opportunity to inquire in the README .md (link, explanations, ...).
|
||||
|
@ -209,6 +212,13 @@ There is also README.md, which must and can contain:
|
|||
#### YEP 1.11
|
||||
##### Add app to [YunoHost bugtracker](https://github.com/YunoHost/issues/issues) | draft | manual | OFFICIAL |
|
||||
|
||||
#### YEP 1.12
|
||||
##### Follow the template from [example_ynh](https://github.com/YunoHost/example_ynh) | draft | manual | OFFICIAL |
|
||||
In order to facilitate the work of the community regarding a package, it has to follow the template shown by the example app.
|
||||
This will help other packagers to read, modify and debug the package. Also, it will help extend the life of the package by giving it a standard template that other packagers can quickly understand in the event that a package becomes orphaned.
|
||||
As well, a package should not use exotic or uselessly complicated code if it's not really needed. If so, this part of the code should be clearly documented.
|
||||
Keep your code as easy as possible, keep everything a script needs directly into it. Do not move functions in another file. Keep it simple and efficient.
|
||||
|
||||
### YEP 2
|
||||
#### Stabilize an app
|
||||
#### YEP 2.1
|
||||
|
|
|
@ -13,7 +13,7 @@ Ce document a pour but de lister les différentes bonnes pratiques concernant la
|
|||
Chaque bonne pratique est numérotée avec un numéro suffixé par les lettres YEP (YunoHost Enhancement Proposals), ceci afin de pouvoir y faire référence facilement dans les outils d'analyse automatique de paquet ([package checker](https://github.com/YunoHost/package_check), [package linter](https://github.com/YunoHost/package_linter)), mais également lors des revues de code.
|
||||
|
||||
Chaque YEP est associée à :
|
||||
* un statut indiquant si la règle a été validé ou si elle fait encore l'objet de discussion (brouillon, validé, refusé, obsolète) ;
|
||||
* un statut indiquant si la règle a été validée ou si elle fait encore l'objet de discussion (brouillon, validé, refusé, obsolète) ;
|
||||
* une indication sur le type de test à mener (manuel ou auto si un outil automatique peut vérifier) ;
|
||||
* une indication du niveau d'app à partir duquel la règle est nécessaire (NOTWORKING, INPROGRESS, WORKING, OFFICIAL), certaines règles sont optionnelles ;
|
||||
|
||||
|
@ -32,6 +32,7 @@ Chaque YEP est associée à :
|
|||
| YEP 1.9 | Documenter l'app | validé | AUTO | OFFICIAL (6) |
|
||||
| YEP 1.10 | Garder un historique de version propre | brouillon | manuel | OFFICIAL (6) |
|
||||
| YEP 1.11 | Ajouter l'app au [bugtracker YunoHost](https://github.com/yunohost/issues/issues) | brouillon | manuel | OFFICIAL (NA) |
|
||||
| YEP 1.12 | Suivre le modèle de [example_ynh](https://github.com/YunoHost/example_ynh) | brouillon | manuel | OFFICIAL (8) |
|
||||
| | | | | |
|
||||
| **YEP 2** | **Stabiliser une app** | **Statut** | **Test** | **Niveau** |
|
||||
| YEP 2.1 | Respecter le format du manifeste | validé | auto | INPROGRESS (5) |
|
||||
|
@ -113,7 +114,7 @@ Ces dépôts ont plusieurs fonctions :
|
|||
* indiquer l'état de fonctionnement du paquet ;
|
||||
* indiquer des informations sur le support d'un paquet.
|
||||
|
||||
Pour les listes `official.json` et `community.json`, l'inscription se fait sur [le dépôt git "apps"](https://github.com/YunoHost/apps).
|
||||
Pour les listes `official.json` et `community.json` maintenues par l'équipe du projet Yunohost, l'inscription se fait sur [le dépôt git "apps"](https://github.com/YunoHost/apps). D'autres listes non-officielles (notamment celles incluant des applications non-libres) peuvent exister, se réferer au [Forum](https://forum.yunohost.org) de la communauté.
|
||||
|
||||
#### YEP 1.3
|
||||
##### Indiquer la licence associée au paquet | brouillon | AUTO | WORKING |
|
||||
|
@ -121,6 +122,8 @@ La licence du paquet est à indiquer dans un fichier `LICENSE` à la racine du p
|
|||
|
||||
Les listes d'applications official.json et community.json n'acceptent que les paquets dont la licence est libre, de même pour la licence de l'application contenue. Certaines applications libres nécessitent des dépendances non-libres (exemple: mp3, drivers, etc.). Dans ce cas, il faut ajouter `&dep-non-free` à l'acronyme et si possible donner des précisions dans le README.md du paquet, l'intégration sera dans ce cas acceptée au cas par cas.
|
||||
|
||||
**NB :** Les applications non-présentes dans les listes maintenues par le projet peuvent tout de même être installées : soit manuellement via le lien de l'application, soit de manière plus intégrée via des listes non-officielles (qui peuvent être créées et maintenues par la communauté).
|
||||
|
||||
Dans le futur, YunoHost affichera sans doute des détails sur la licence de l'application. Pour y parvenir, l'acronyme doit être celui issu de cette [liste de licences répertoriées du SPDX](https://spdx.org/licenses/) (si il y a 2 acronymes, il faut prendre celui contenant le numéro de version). Pour plus de cohérence, la casse doit être respectée.
|
||||
|
||||
Si la licence n'est pas présente dans la liste, dans ce cas il faut indiquer `free` ou `non-free` selon qu'elle est libre ou non et donner l'occasion à l'utilisateur de se renseigner dans le README.md (lien, explications, ...).
|
||||
|
@ -210,6 +213,13 @@ Il y a également le README.md, ce dernier doit et peut contenir :
|
|||
#### YEP 1.11
|
||||
##### Ajouter l'app au [bugtracker YunoHost](https://github.com/yunohost/issues/issues) | brouillon | manuel | OFFICIAL |
|
||||
|
||||
#### YEP 1.12
|
||||
##### Suivre le modèle de [example_ynh](https://github.com/YunoHost/example_ynh) | brouillon | manuel | OFFICIAL |
|
||||
Afin de faciliter le travail de la communauté concernant un package, il doit suivre le modèle montré par l'application d'exemple.
|
||||
Cela aidera les autres packagers à lire, modifier et débugger le paquet. De plus, cela aidera à prolonger la durée de vie du package en lui donnant un modèle standard que les autres packagers seront en mesure de comprendre rapidement au cas où un package deviendrait orphelin.
|
||||
De plus, un package ne devrait pas utiliser de code exotique ou inutilement compliqué si ce n'est pas vraiment nécessaire. Le cas échéant, cette partie du code devrait être clairement documentée.
|
||||
Gardez votre code aussi simple que possible, gardez tout ce dont un script a besoin directement dedans. Ne déplacez pas les fonctions dans un autre fichier. Restez simple et efficace.
|
||||
|
||||
### YEP 2
|
||||
#### Stabiliser une app
|
||||
#### YEP 2.1
|
||||
|
|
|
@ -34,6 +34,8 @@ Après l'upgrade d'une applications
|
|||
Après la supression d'une applications
|
||||
- `post_app_change_url`
|
||||
Après avoir modifié le chemin et ou le nom de domaine d'une application
|
||||
- `post_cert_update`
|
||||
Après la mise à jour d'un certificat
|
||||
- `conf_regen`
|
||||
Avant et après la régénération de la configuration d'un service.
|
||||
Services pris en charge par regen-conf:
|
||||
|
@ -131,6 +133,11 @@ users=$2 # Tous les utilisateurs autorisés sur l'app. Séparés par des virgul
|
|||
app_id=$1
|
||||
```
|
||||
|
||||
##### `post_cert_update`
|
||||
```bash
|
||||
domain=$1
|
||||
```
|
||||
|
||||
La suite du script dépend de ce que vous voulez effectuer dans celui-ci.
|
||||
|
||||
### Cas particulier de `conf_regen`
|
||||
|
|
|
@ -23,22 +23,22 @@ The application installs and uninstalls correctly in all common configurations.
|
|||
The application can be updated.
|
||||
|
||||
**Level 4**
|
||||
The application uses YunoHost users directly and allows unique identification from the YunoHost portal.
|
||||
The application can be saved and restored.
|
||||
|
||||
**Level 5**
|
||||
The application package code follows some syntax rules.
|
||||
|
||||
**Level 6**
|
||||
The application can be saved and restored.
|
||||
The application package is in the YunoHost-Apps organization.
|
||||
|
||||
**Level 7**
|
||||
The application package passes all integrity tests successfully.
|
||||
|
||||
**Level 8**
|
||||
The application respects a set of advanced recommendations improving its general quality.
|
||||
The application package respects all packaging recommendations. This is a high quality app.
|
||||
|
||||
**Level 9**
|
||||
The application complies with all recommendations. This is an excellent quality package.
|
||||
The application complies with higher packaging recommendations. Not available yet.
|
||||
|
||||
**Level 10**
|
||||
The application package is considered perfect!
|
||||
|
@ -88,7 +88,6 @@ YEP to be respected to reach level 2:
|
|||
- *[YEP 2.18.4](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-2184---supporter-linstallation-sur-un-sous-dossier----valid%C3%A9--auto--official-) : Support installation on a subfolder*
|
||||
- *[YEP 4.6](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-46---g%C3%A8re-le-multi-instance----valid%C3%A9--manuel--optional-) : Manage multi-instance*
|
||||
|
||||
|
||||
### Level 3
|
||||
|
||||
**The application supports upgrade from an older version of the package.**
|
||||
|
@ -100,16 +99,11 @@ YEP to be respected to reach level 3:
|
|||
|
||||
### Level 4
|
||||
|
||||
**The application supports LDAP and HTTP AUTH**
|
||||
|
||||
The application manages its users directly from the [YunoHost ldap base](https://github.com/YunoHost/SSOwat/blob/366dd6c4438e6550f7438c36893690b628340185/config.lua#L50-L53) and allows unified connection using [HTTP authentication](https://fr.wikipedia.org/wiki/Authentification_HTTP) from the SSO.
|
||||
|
||||
*If the application is not capable of supporting an ldap directory or HTTP authentication, this level can be ignored. *
|
||||
*However, it is necessary to be able to justify this impossibility*.
|
||||
**The application can be backed up and restored without error on the same machine or another.**
|
||||
|
||||
YEP to be respected to reach level 4:
|
||||
- *[YEP 4.1](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-41---lier-au-ldap----valid%C3%A9--manuel--official-) : Link to ldap*
|
||||
- *[YEP 4.2](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-42---lier-lauthentification-au-sso----valid%C3%A9--manuel--official-) : Bind authentication to sso*
|
||||
- *[YEP 4.3](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-43---fournir-un-script-de-sauvegarde-yunohost-fonctionnel----valid%C3%A9--auto--official-) : Provide a functional YunoHost backup script*
|
||||
- *[YEP 4.4](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-44---fournir-un-script-de-restauration-yunohost-fonctionnel----valid%C3%A9--auto--official-) : Provide a functional YunoHost restore script*
|
||||
|
||||
### Level 5
|
||||
|
||||
|
@ -119,11 +113,10 @@ YEP to be respected to reach level 4:
|
|||
|
||||
YEP to be respected to reach level 5:
|
||||
- *[YEP 1.3](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-13---indiquer-la-licence-associ%C3%A9e-au-paquet---valid%C3%A9--auto--working-) : Specify the license associated with the package*
|
||||
- [YEP 2.1](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-21---respecter-le-format-du-manifeste---valid%C3%A9--auto--inprogress-) : Respect manifest format
|
||||
- *[YEP 2.1](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-21---respecter-le-format-du-manifeste---valid%C3%A9--auto--inprogress-) : Respect manifest format*
|
||||
- [YEP 2.12](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-212---utiliser-les-commandes-pratiques-helpers---valid%C3%A9--auto--official-) : Use practical commands (helpers)
|
||||
- [YEP 2.18.1](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-2181---lancer-le-script-dinstallation-dune-webapp-correctement----valid%C3%A9--manuel--working-) : Run the webapp installation script correctly
|
||||
|
||||
|
||||
### Level 6
|
||||
|
||||
**The application can be backed up and restored without error on the same machine or another.**
|
||||
|
@ -131,7 +124,7 @@ YEP to be respected to reach level 5:
|
|||
YEP to be respected to reach level 6:
|
||||
- [YEP 1.4](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-14---informer-sur-lintention-de-maintenir-un-paquet----brouillon--manuel--working-) : Inform about the intention to maintain a package
|
||||
- [YEP 1.6](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-16---se-tenir-inform%C3%A9-sur-l%C3%A9volution-du-packaging-dapps---valid%C3%A9--manuel--official-) : As a maintainer, keep checking and being aware of the evolution of apps packaging
|
||||
- [YEP 1.7](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-17---ajouter-lapp-%C3%A0-lorganisation-yunohost-apps---valid%C3%A9--manuel--official-) : Add app to the [YunoHost-Apps organization](https://github.com/YunoHost-Apps)
|
||||
- *[YEP 1.7](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-17---ajouter-lapp-%C3%A0-lorganisation-yunohost-apps---valid%C3%A9--manuel--official-) : Add app to the [YunoHost-Apps organization](https://github.com/YunoHost-Apps)*
|
||||
- [YEP 1.8](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-18---publier-des-demandes-de-test---valid%C3%A9--manuel--official-) : Publish test requests
|
||||
- [YEP 1.9](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-19---documenter-lapp---valid%C3%A9--auto--official-) : Document app
|
||||
- [YEP 1.10](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-110---garder-un-historique-de-version-propre----brouillon--manuel--official-) : Keep a clean version history
|
||||
|
@ -139,10 +132,6 @@ YEP to be respected to reach level 6:
|
|||
- [YEP 3.3](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-33---faciliter-le-contr%C3%B4le-de-lint%C3%A9grit%C3%A9-des-sources----brouillon--manuel--official-) : Facilitating source integrity control
|
||||
- [YEP 3.5](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-35---suivre-les-recommendations-de-la-documentation-de-lapp----valid%C3%A9--manuel--official-) : Follow the recommendations of the app documentation
|
||||
- [YEP 3.6](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-36---mettre-%C3%A0-jour-les-versions-contenant-des-cve----draft--manuel--official-) : Update versions containing CVEs
|
||||
- *[YEP 4.3](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-43---fournir-un-script-de-sauvegarde-yunohost-fonctionnel----valid%C3%A9--auto--official-) : Provide a functional YunoHost backup script*
|
||||
- *[YEP 4.4](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-44---fournir-un-script-de-restauration-yunohost-fonctionnel----valid%C3%A9--auto--official-) : Provide a functional YunoHost restore script*
|
||||
|
||||
If an app reaches level 6, it may qualify to join the official applications.
|
||||
|
||||
### Level 7
|
||||
|
||||
|
@ -151,20 +140,24 @@ If an app reaches level 6, it may qualify to join the official applications.
|
|||
Considering the maximum number of tests possible for the application.
|
||||
|
||||
YEP à respecter pour atteindre le niveau 7:
|
||||
- [YEP 2.4](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-24---d%C3%A9tecter-et-g%C3%A9rer-les-erreurs---brouillon--manuel--working-) : Error detection and management
|
||||
- [YEP 2.6](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-26---annuler-laction-si-les-valeurs-dentr%C3%A9es-sont-incorrectes----valid%C3%A9--manuel--working-) : Cancel action if input values are incorrect
|
||||
- [YEP 2.8](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-28---modifier-correctement-une-configuration-syst%C3%A8me----brouillon--manuel--working-) : Change a system configuration correctly
|
||||
- [YEP 2.10](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-210---configurer-les-logs-de-lapplication----brouillon--manuel--working-) : Configure application logs
|
||||
- [YEP 2.11](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-211---utiliser-une-variable-plut%C3%B4t-que-lapp-id-directement---valid%C3%A9--manuel--official-) : Use a variable rather than the app id directly
|
||||
- [YEP 2.13](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-213---traduire-le-package-en-anglais----brouillon--manuel--official-) : Translate the package into English
|
||||
- [YEP 3.2](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-32---ouvrir-un-port-correctement----brouillon--manuel--working-) : Open port: Open port correctly
|
||||
|
||||
|
||||
### Level 8
|
||||
|
||||
**The application complies with all recommended YEPs.**
|
||||
**The application package respects all packaging recommendations. This is a high quality app.**
|
||||
|
||||
YEP to be respected to reach level 8:
|
||||
- [YEP 2.4](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-24---d%C3%A9tecter-et-g%C3%A9rer-les-erreurs---brouillon--manuel--working-) : Error detection and management
|
||||
- [YEP 2.8](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-28---modifier-correctement-une-configuration-syst%C3%A8me----brouillon--manuel--working-) : Change a system configuration correctly
|
||||
- [YEP 2.16](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-216---v%C3%A9rifier-la-disponibilit%C3%A9-des-d%C3%A9pendances-sur-arm-x86-et-x64----valid%C3%A9--manuel--official-) : Check dependency availability on ARM, x86 and x64
|
||||
- [YEP 1.12](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-112) : Follow the template from example_ynh
|
||||
- *[YEP 2.16](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-216---v%C3%A9rifier-la-disponibilit%C3%A9-des-d%C3%A9pendances-sur-arm-x86-et-x64----valid%C3%A9--manuel--official-) : Check dependency availability on ARM, x86 and x64*
|
||||
- [YEP 2.18.5](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-2185---ajouter-la-tuile-yunohost-pour-naviguer-facilement-entre-les-applications----valid%C3%A9--manuel--official-) : Add the YunoHost tile to easily navigate between applications
|
||||
- [YEP 3.4](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-34---isoler-lapp----brouillon--manuel--official-) : Isolate app
|
||||
- [YEP 4.1](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-41---lier-au-ldap----valid%C3%A9--manuel--official-) : Link to ldap
|
||||
- [YEP 4.2](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-42---lier-lauthentification-au-sso----valid%C3%A9--manuel--official-) : Bind authentication to sso
|
||||
- [YEP 4.5](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-45---utiliser-les-hooks----valid%C3%A9--manuel--optional-) : Use hooks
|
||||
|
||||
If an application is not available on an architecture, and it is impossible to circumvent this limitation reasonably, this limitation must be indicated in the REDME and taken into account in the installation script. The installation of the application on an unsupported architecture must be stopped before modifying the filesystem.
|
||||
|
@ -175,32 +168,13 @@ If an application is not available on an architecture, and it is impossible to c
|
|||
|
||||
YEP to be respected to reach level 9:
|
||||
|
||||
- [YEP 2.10](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-210---configurer-les-logs-de-lapplication----brouillon--manuel--working-) : Configure application logs
|
||||
- [YEP 2.11](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-211---utiliser-une-variable-plut%C3%B4t-que-lapp-id-directement---valid%C3%A9--manuel--official-) : Use a variable rather than the app id directly
|
||||
- [YEP 2.13](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-213---traduire-le-package-en-anglais----brouillon--manuel--official-) : Translate the package into English
|
||||
- [YEP 2.14](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-214---remplir-correctement-un-fichier-de-conf----brouillon--manuel--official-) : Fill a conf file correctly
|
||||
- [YEP 2.17](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-217---prendre-en-compte-la-version-dorigine-lors-des-mises-%C3%A0-jour----valid%C3%A9--manuel--official-) : Take into account the original version during updates
|
||||
- [YEP 3.4](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-34---isoler-lapp----brouillon--manuel--official-) : Isolate app
|
||||
- [YEP 4.2.1](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-421---d%C3%A9connexion----valid%C3%A9--manuel--official-) : Logout
|
||||
|
||||
|
||||
### Level 10
|
||||
|
||||
**The application is considered perfect.**
|
||||
|
||||
This ultimate level for an application can only be reached after an in-depth study of the package and by the validation of the Apps group.
|
||||
|
||||
|
||||
## How to request the integration of an application in the official list?
|
||||
|
||||
Before requesting an application for inclusion in the official list, you must commit to maintaining the application over time, or find someone who will commit to doing so.
|
||||
An official application must be regularly updated and follow packaging recommendations as closely as possible.
|
||||
|
||||
To be eligible to join the official list, the application must have reached at least level 6 and must be free software.
|
||||
|
||||
If all these requirements are met, you can create a pull request on the official list or make a request on the forum.
|
||||
From then on, the package will be checked by Apps group members and the decision to include it in the list of official applications will be discussed by the group.
|
||||
Hopefully the application will join the official YunoHost applications.
|
||||
|
||||
|
||||
|
||||
|
||||
|
|
|
@ -23,22 +23,22 @@ L'application s'installe et se désinstalle correctement dans toutes les configu
|
|||
L'application peut être mise à jour.
|
||||
|
||||
**Niveau 4**
|
||||
L'application utilise directement les utilisateurs YunoHost et permet l'identification unique à partir du portail YunoHost.
|
||||
L'application peut-être sauvegardée et restaurée.
|
||||
|
||||
**Niveau 5**
|
||||
Le code du package d'application respecte certaines règles de syntaxe.
|
||||
|
||||
**Niveau 6**
|
||||
L'application peut-être sauvegardée et restaurée.
|
||||
Le package d'application est dans l'organisation YunoHost-Apps.
|
||||
|
||||
**Niveau 7**
|
||||
Le package d'application passe avec succès l'ensemble des tests d'intégrité.
|
||||
|
||||
**Niveau 8**
|
||||
L'application respecte un ensemble de recommandations avancées améliorant sa qualité générale.
|
||||
Le package d'application respecte toute les recommendations de packaging d'apps. C'est une app de très bonne qualité.
|
||||
|
||||
**Niveau 9**
|
||||
L'application respecte toutes les recommandations. C'est un package d'excellente qualité.
|
||||
Le package d'application respecte des recommandations de packaging supérieures. Non disponible pour le moment.
|
||||
|
||||
**Niveau 10**
|
||||
Le package d'application est jugé parfait !
|
||||
|
@ -91,15 +91,11 @@ YEP à respecter pour atteindre le niveau 3:
|
|||
- [YEP 2.3](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-23---sauvegarder-les-r%C3%A9ponses-lors-de-linstallation---valid%C3%A9--manuel--working-) : Sauvegarder les réponses lors de l'installation
|
||||
|
||||
### Niveau 4
|
||||
**L'application prend en charge ldap et HTTP AUTH**
|
||||
L'application gère ses utilisateurs directement à partir de la [base ldap de YunoHost](https://github.com/YunoHost/SSOwat/blob/366dd6c4438e6550f7438c36893690b628340185/config.lua#L50-L53) et permet la connexion unifiée en utilisant l'[authentification HTTP](https://fr.wikipedia.org/wiki/Authentification_HTTP) depuis le SSO.
|
||||
|
||||
*Si l'application n'est pas capable de prendre en charge un annuaire ldap ou l'authentification HTTP, ce niveau peut être ignoré.*
|
||||
*Il faut toutefois être en mesure de justifier de cette impossibilité*
|
||||
**L'application peut-être sauvegardée et restaurée sans erreur sur la même machine ou une autre.**
|
||||
|
||||
YEP à respecter pour atteindre le niveau 4:
|
||||
- *[YEP 4.1](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-41---lier-au-ldap----valid%C3%A9--manuel--official-) : Lier au ldap*
|
||||
- *[YEP 4.2](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-42---lier-lauthentification-au-sso----valid%C3%A9--manuel--official-) : Lier l'authentification au sso*
|
||||
- *[YEP 4.3](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-43---fournir-un-script-de-sauvegarde-yunohost-fonctionnel----valid%C3%A9--auto--official-) : Fournir un script de sauvegarde YunoHost fonctionnel*
|
||||
- *[YEP 4.4](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-44---fournir-un-script-de-restauration-yunohost-fonctionnel----valid%C3%A9--auto--official-) : Fournir un script de restauration YunoHost fonctionnel*
|
||||
|
||||
### Niveau 5
|
||||
**L'application ne présente aucune erreur dans [Package linter](https://github.com/YunoHost/package_linter).**
|
||||
|
@ -107,17 +103,17 @@ YEP à respecter pour atteindre le niveau 4:
|
|||
|
||||
YEP à respecter pour atteindre le niveau 5:
|
||||
- *[YEP 1.3](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-13---indiquer-la-licence-associ%C3%A9e-au-paquet---valid%C3%A9--auto--working-) : Indiquer la licence associée au paquet*
|
||||
- [YEP 2.1](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-21---respecter-le-format-du-manifeste---valid%C3%A9--auto--inprogress-) : Respecter le format du manifeste
|
||||
- *[YEP 2.1](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-21---respecter-le-format-du-manifeste---valid%C3%A9--auto--inprogress-) : Respecter le format du manifeste*
|
||||
- [YEP 2.12](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-212---utiliser-les-commandes-pratiques-helpers---valid%C3%A9--auto--official-) : Utiliser les commandes pratiques (helpers)
|
||||
- [YEP 2.18.1](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-2181---lancer-le-script-dinstallation-dune-webapp-correctement----valid%C3%A9--manuel--working-) : Lancer le script d'installation d'une webapp correctement
|
||||
|
||||
### Niveau 6
|
||||
**L'application peut-être sauvegardée et restaurée sans erreur sur la même machine ou une autre.**
|
||||
**Le package d'application est dans l'organisation YunoHost-Apps.**
|
||||
|
||||
YEP à respecter pour atteindre le niveau 6:
|
||||
- [YEP 1.4](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-14---informer-sur-lintention-de-maintenir-un-paquet----brouillon--manuel--working-) : Informer sur l'intention de maintenir un paquet
|
||||
- [YEP 1.6](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-16---se-tenir-inform%C3%A9-sur-l%C3%A9volution-du-packaging-dapps---valid%C3%A9--manuel--official-) : Se tenir informé sur l'évolution du packaging d'apps
|
||||
- [YEP 1.7](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-17---ajouter-lapp-%C3%A0-lorganisation-yunohost-apps---valid%C3%A9--manuel--official-) : Ajouter l'app à l'[organisation YunoHost-Apps](https://github.com/YunoHost-Apps)
|
||||
- *[YEP 1.7](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-17---ajouter-lapp-%C3%A0-lorganisation-yunohost-apps---valid%C3%A9--manuel--official-) : Ajouter l'app à l'[organisation YunoHost-Apps](https://github.com/YunoHost-Apps)*
|
||||
- [YEP 1.8](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-18---publier-des-demandes-de-test---valid%C3%A9--manuel--official-) : Publier des demandes de test
|
||||
- [YEP 1.9](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-19---documenter-lapp---valid%C3%A9--auto--official-) : Documenter l'app
|
||||
- [YEP 1.10](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-110---garder-un-historique-de-version-propre----brouillon--manuel--official-) : Garder un historique de version propre
|
||||
|
@ -125,28 +121,28 @@ YEP à respecter pour atteindre le niveau 6:
|
|||
- [YEP 3.3](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-33---faciliter-le-contr%C3%B4le-de-lint%C3%A9grit%C3%A9-des-sources----brouillon--manuel--official-) : Faciliter le contrôle de l'intégrité des sources
|
||||
- [YEP 3.5](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-35---suivre-les-recommendations-de-la-documentation-de-lapp----valid%C3%A9--manuel--official-) : Suivre les recommandations de la documentation de l'app
|
||||
- [YEP 3.6](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-36---mettre-%C3%A0-jour-les-versions-contenant-des-cve----draft--manuel--official-) : Mettre à jour les versions contenant des CVE
|
||||
- *[YEP 4.3](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-43---fournir-un-script-de-sauvegarde-yunohost-fonctionnel----valid%C3%A9--auto--official-) : Fournir un script de sauvegarde YunoHost fonctionnel*
|
||||
- *[YEP 4.4](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-44---fournir-un-script-de-restauration-yunohost-fonctionnel----valid%C3%A9--auto--official-) : Fournir un script de restauration YunoHost fonctionnel*
|
||||
|
||||
**Si une app atteint le niveau 6, elle peut prétendre à rejoindre les applications officielles.**
|
||||
|
||||
### Niveau 7
|
||||
**L'application ne présente aucune erreur dans [Package check](https://github.com/YunoHost/package_check).**
|
||||
En considérant le maximum de tests possibles pour l'application.
|
||||
|
||||
YEP à respecter pour atteindre le niveau 7:
|
||||
- [YEP 2.4](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-24---d%C3%A9tecter-et-g%C3%A9rer-les-erreurs---brouillon--manuel--working-) : Détecter et gérer les erreurs
|
||||
- [YEP 2.6](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-26---annuler-laction-si-les-valeurs-dentr%C3%A9es-sont-incorrectes----valid%C3%A9--manuel--working-) : Annuler l'action si les valeurs d'entrées sont incorrectes
|
||||
- [YEP 2.8](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-28---modifier-correctement-une-configuration-syst%C3%A8me----brouillon--manuel--working-) : Modifier correctement une configuration système
|
||||
- [YEP 2.10](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-210---configurer-les-logs-de-lapplication----brouillon--manuel--working-) : Configurer les logs de l'application
|
||||
- [YEP 2.11](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-211---utiliser-une-variable-plut%C3%B4t-que-lapp-id-directement---valid%C3%A9--manuel--official-) : Utiliser une variable plutôt que l'app id directement
|
||||
- [YEP 2.13](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-213---traduire-le-package-en-anglais----brouillon--manuel--official-) : Traduire le package en anglais
|
||||
- [YEP 3.2](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-32---ouvrir-un-port-correctement----brouillon--manuel--working-) : Ouvrir un port correctement
|
||||
|
||||
### Niveau 8
|
||||
**L'application respecte toutes les YEP recommandées.**
|
||||
**Le package d'application respecte toute les recommendations de packaging d'apps. C'est une app de très bonne qualité.**
|
||||
|
||||
YEP à respecter pour atteindre le niveau 8:
|
||||
- [YEP 2.4](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-24---d%C3%A9tecter-et-g%C3%A9rer-les-erreurs---brouillon--manuel--working-) : Détecter et gérer les erreurs
|
||||
- [YEP 2.8](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-28---modifier-correctement-une-configuration-syst%C3%A8me----brouillon--manuel--working-) : Modifier correctement une configuration système
|
||||
- [YEP 2.16](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-216---v%C3%A9rifier-la-disponibilit%C3%A9-des-d%C3%A9pendances-sur-arm-x86-et-x64----valid%C3%A9--manuel--official-) : Vérifier la disponibilité des dépendances sur ARM, x86 et x64
|
||||
- *[YEP 2.16](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-216---v%C3%A9rifier-la-disponibilit%C3%A9-des-d%C3%A9pendances-sur-arm-x86-et-x64----valid%C3%A9--manuel--official-) : Vérifier la disponibilité des dépendances sur ARM, x86 et x64*
|
||||
- [YEP 2.18.5](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-2185---ajouter-la-tuile-yunohost-pour-naviguer-facilement-entre-les-applications----valid%C3%A9--manuel--official-) : Ajouter la tuile YunoHost pour naviguer facilement entre les applications
|
||||
- [YEP 3.4](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-34---isoler-lapp----brouillon--manuel--official-) : Isoler l'app
|
||||
- [YEP 4.1](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-41---lier-au-ldap----valid%C3%A9--manuel--official-) : Lier au ldap
|
||||
- [YEP 4.2](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-42---lier-lauthentification-au-sso----valid%C3%A9--manuel--official-) : Lier l'authentification au sso
|
||||
- [YEP 4.5](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-45---utiliser-les-hooks----valid%C3%A9--manuel--optional-) : Utiliser les hooks
|
||||
|
||||
*Si une application n'est pas disponible sur une architecture, et qu'il est impossible de contourner cette limitation raisonnablement, cette limitation doit être indiquée dans le readme et prise en compte dans le script d'installation. L'installation de l'application sur une architecture non supportée doit être stoppée avant de modifier les fichiers.*
|
||||
|
@ -155,27 +151,11 @@ YEP à respecter pour atteindre le niveau 8:
|
|||
**L'application respecte toutes les YEP optionnelles.**
|
||||
|
||||
YEP à respecter pour atteindre le niveau 9:
|
||||
- [YEP 2.10](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-210---configurer-les-logs-de-lapplication----brouillon--manuel--working-) : Configurer les logs de l'application
|
||||
- [YEP 2.11](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-211---utiliser-une-variable-plut%C3%B4t-que-lapp-id-directement---valid%C3%A9--manuel--official-) : Utiliser une variable plutôt que l'app id directement
|
||||
- [YEP 2.13](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-213---traduire-le-package-en-anglais----brouillon--manuel--official-) : Traduire le package en anglais
|
||||
- [YEP 2.14](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-214---remplir-correctement-un-fichier-de-conf----brouillon--manuel--official-) : Remplir correctement un fichier de conf
|
||||
- [YEP 2.17](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-217---prendre-en-compte-la-version-dorigine-lors-des-mises-%C3%A0-jour----valid%C3%A9--manuel--official-) : Prendre en compte la version d'origine lors des mises à jour
|
||||
- [YEP 3.4](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-34---isoler-lapp----brouillon--manuel--official-) : Isoler l'app
|
||||
- [YEP 4.2.1](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines_fr.md#yep-421---d%C3%A9connexion----valid%C3%A9--manuel--official-) : Déconnexion
|
||||
|
||||
### Niveau 10
|
||||
**L'application est jugée parfaite !**
|
||||
Ce niveau ultime pour une application ne peux être atteint que suite à étude approfondie du package et par la validation du groupe Apps.
|
||||
|
||||
|
||||
## Comment demander l'intégration d'une application dans la liste officielle ?
|
||||
|
||||
Avant de demander l'intégration d'une application dans la liste officielle, vous devez vous engager à maintenir l'application sur la durée, ou trouver quelqu'un qui s'engage à le faire.
|
||||
Une application officielle doit être régulièrement mise à jour et suivre au mieux les recommandations de packaging.
|
||||
|
||||
Pour prétendre à rejoindre la liste officielle, l'application doit avoir atteint au moins le niveau 6 et doit être un logiciel libre.
|
||||
|
||||
Si tout ces prérequis sont satisfaits, vous pouvez créer une pull request sur la liste officielle ou faire une demande sur le forum.
|
||||
Dés lors, le package sera vérifié par les membres du groupe Apps et la décision de l'inclure dans la liste des applications officielles sera débattue par le groupe.
|
||||
Si tout va bien l'application rejoindra les applications officielles de YunoHost.
|
||||
|
||||
|
||||
|
|
|
@ -65,7 +65,7 @@ The `manifest.json` file defines the app's constants, a bunch of values that Yun
|
|||
|
||||
* **version**: version of the package builded from the upstream version number and an incremental number for each change in the package without upstream change. Example "1.0.1~ynh7". Must be a string.
|
||||
|
||||
* **license**: application license: `free` or `non-free`. Be careful to not confuse with package license which must be put in `LICENSE` file.
|
||||
* **license**: application license: `free`, `non-free` or a value from the Identifier column from https://spdx.org/licenses/. Be careful to not confuse with package license which must be put in `LICENSE` file.
|
||||
|
||||
* **maintainer**: informations about the app maintainer for contact.
|
||||
|
||||
|
@ -78,7 +78,7 @@ The `manifest.json` file defines the app's constants, a bunch of values that Yun
|
|||
* **arguments**:
|
||||
* **install**: argument for the YunoHost's administrator to enter at installation.
|
||||
* **name**: argument identification.
|
||||
* **type**: (optional) argument type among `domain`, `path`, `user`, `app`, `boolean` and `password`. The field will be hiden in the password case.
|
||||
* **type**: (optional) argument type among `domain`, `path`, `user`, `app`, `boolean`, `string` and `password`. The field will be hiden in the password case.
|
||||
* **choices** : (optional) restrict value to several choices.
|
||||
* **optional** : (optional) field which indicate if this argument is optional. It can have `true` and `false` value.
|
||||
* **ask**: question (at least in `en`) that you can translate.
|
||||
|
|
|
@ -65,7 +65,7 @@ Le fichier `manifest.json` définit les constantes de l’application, un ensemb
|
|||
|
||||
* **version** : version du package construit à partir du numéro de version de l’application qui est installée et d'un incrément pour chaque changement du paquet sans changement de version de l'application. "Exemple: 1.0.1~ynh7". Le champ doit être une chaîne de caractères.
|
||||
|
||||
* **license** : licence avec laquelle l’application est distribuée : `free`, `non-free`. Attention à ne pas confondre avec la licence du paquet qui doit être mise dans le fichier `LICENSE`.
|
||||
* **license** : licence avec laquelle l’application est distribuée : `free`, `non-free` ou une des valeurs de la colonne Identifier du site https://spdx.org/licenses/. Attention à ne pas confondre avec la licence du paquet qui doit être mise dans le fichier `LICENSE`.
|
||||
|
||||
* **maintainer** : informations à propos du mainteneur du paquet de l’application pour pouvoir le contacter.
|
||||
|
||||
|
@ -78,7 +78,7 @@ Le fichier `manifest.json` définit les constantes de l’application, un ensemb
|
|||
* **arguments** :
|
||||
* **install** : paramètres à demander à l’administrateur lors de l’installation.
|
||||
* **name** : identifiant du paramètre
|
||||
* **type** : (optionnel) type de paramètre parmis `domain`, `path`, `user`, `app`, `boolean` et `password`. Le champ sera caché dans le cas d’un mot de passe.
|
||||
* **type** : (optionnel) type de paramètre parmis `domain`, `path`, `user`, `app`, `boolean`, `string` et `password`. Le champ sera caché dans le cas d’un mot de passe.
|
||||
* **choices** : (optionnel) restreint les réponses possibles à plusieurs choix.
|
||||
* **optional** : (optionnel) champs qui indique si ce paramètre est optionnel. Il peut avoir les valeurs `true` ou `false`.
|
||||
* **ask** : question posée (au minimum en anglais – `en`) que vous pouvez traduire dans plusieurs langues.
|
||||
|
|
|
@ -32,11 +32,11 @@ You can also perform the postinstallation with the command `yunohost tools posti
|
|||
|
||||
This is the first domain name linked to your YunoHost server, but also the one which will be used by your server's users to access the **authentication portal**. It will thus be **visible by everyone**, choose it wisely.
|
||||
|
||||
* If you do not have a domain name, or if you want to use the YunoHost's DynDNS service, choose a sub-domain of **.nohost.me** or **.noho.st** (e.g. `homersimpson.nohost.me`). The domain will be configured automatically and you won't need any further configuration step.
|
||||
* If you do not have a domain name, or if you want to use the YunoHost's DynDNS service, choose a sub-domain of **.nohost.me**, **.noho.st** or **.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.
|
||||
|
||||
* If you do know what **DNS** is, you probably want to configure your own domain name here. In this case, please refer to the [DNS page](/dns) page for more informations.
|
||||
|
||||
* If you don't own a domain name and don't want a **.nohost.me** or **.noho.st**, you can use a local domain. The idea is to configure your router to redirect a local domain name to your server. For example you could create the yunohost.local domain redirecting to your server in your router, and now every device on the network will be redirected to your server when accessing yunohost.local. More information on how to setup a local domain can be found [here](dns_local_network).
|
||||
* If you don't own a domain name and don't want a **.nohost.me**, **.noho.st** or **.ynh.fr**, you can use a local domain. The idea is to configure your router to redirect a local domain name to your server. For example you could create the yunohost.local domain redirecting to your server in your router, and now every device on the network will be redirected to your server when accessing yunohost.local. More information on how to setup a local domain can be found [here](dns_local_network).
|
||||
|
||||
### Administration password
|
||||
|
||||
|
|
|
@ -31,11 +31,11 @@ Vous pouvez aussi y accéder en entrant la commande `yunohost tools postinstall`
|
|||
|
||||
C’est le nom de domaine qui permettra l’accès à votre serveur ainsi qu’au portail d’authentification des utilisateurs. Il sera donc **visible par tout le monde**, choisissez-le en conséquence.
|
||||
|
||||
* YunoHost propose un service de DNS dynamique fournissant des noms de domaine de type *mondomaine.nohost.me* ou *mondomaine.noho.st*. Si vous ne possédez pas de nom de domaine et/ou que vous souhaitez profiter de ce service, choisissez un domaine se terminant en `.nohost.me` ou `.noho.st`. Le domaine sera automatiquement rattaché à votre serveur YunoHost, et vous n’aurez pas d’étape de configuration supplémentaire.
|
||||
* YunoHost propose un service de DNS dynamique fournissant des noms de domaine de type *mondomaine.nohost.me*, *mondomaine.noho.st* ou *mondomaine.ynh.fr*. Si vous ne possédez pas de nom de domaine et/ou que vous souhaitez profiter de ce service, choisissez un domaine se terminant en `.nohost.me`, `.noho.st` ou `.ynh.fr`. S'il n'est pas déjà utilisé, le domaine sera automatiquement rattaché à votre serveur YunoHost, et vous n’aurez pas d’étape de configuration supplémentaire.
|
||||
|
||||
* Si en revanche vous maîtrisez la notion de **DNS**, vous pouvez utiliser votre propre nom de domaine. Dans ce cas, référez-vous à la page [yunohost.org/dns](/dns_fr) pour plus d’informations.
|
||||
|
||||
* Si vous n'avez pas de nom de domaine et que vous n'en voulez pas en *mondomaine.nohost.me* ou *mondomaine.noho.st*, vous pouvez utilisez un domaine local. Plus d'infos sur comment [accéder à son serveur depuis le réseau local](/dns_local_network_fr).
|
||||
* Si vous n'avez pas de nom de domaine et que vous n'en voulez pas en *mondomaine.nohost.me*, *mondomaine.noho.st* ou *mondomaine.ynh.fr*, vous pouvez utilisez un domaine local. Plus d'infos sur comment [accéder à son serveur depuis le réseau local](/dns_local_network_fr).
|
||||
|
||||
|
||||
### Mot de passe d’administration
|
||||
|
|
|
@ -1,29 +1,29 @@
|
|||
Self-hosting
|
||||
============
|
||||
|
||||
Self-hosting is the activity of having and administrating your own server, typically at home, to host your personal data and services yourself instead of relying exclusively on third-parties. For instance, you can self-host your blog, such that it 'lives' on a machine that you have control on, instead of having it on somebody else's computer (a.k.a. The Cloud) in exchange for money, advertisement or private data.
|
||||
Self-hosting is the activity of having and administrating your own server, typically at home, to host your personal data and services yourself instead of relying exclusively on third-parties. For instance, you can self-host your blog, such that it 'lives' on a machine that you have control of, instead of having it on somebody else's computer (a.k.a. The Cloud) in exchange for money, advertisement or private data.
|
||||
|
||||
Self-hosting implies owning a server. A server is a computer which is typically accessible on the network 24/7, and usually does not have any screen or keyboard (it is instead controlled remotely). Contrarily to a popular belief, a server is not necessarily a huge and extra-powerful machine : nowadays, a small, ~$30 ARM board is adequate for self-hosting.
|
||||
Self-hosting implies owning a server. A server is a computer which is typically accessible on the network 24/7, and usually does not have any screen or keyboard (it is instead controlled remotely). Contrarily to a popular belief, a server is not necessarily a huge and extra-powerful machine: nowadays, a small, ~$30 ARM board is adequate for self-hosting.
|
||||
|
||||
Self-hosting is not about making "your Internet" more secure or does not provide anonymity by itself. Instead, it is about being autonomous, and in control of your services and data - which also means being responsible for them.
|
||||
Self-hosting is not about making "your Internet" more secure and does not provide anonymity by itself. Instead, it is about being autonomous, and in control of your services and data - which also means being responsible for them.
|
||||
|
||||
Why should you host yourself ?
|
||||
------------------------------
|
||||
|
||||
- **You believe in a free, open and decentralized internet.** In a centralized internet, private companies and governement can spy, analyze and influence people by dictating how they connect with each other, and by filtering content. Yunohost is developed by a community who believe in an open and decentralized internet, and we hope that you do, too !
|
||||
- **You believe in a free, open and decentralized internet.** In a centralized internet, private companies and government can spy, analyze and influence people by dictating how they connect with each other, and by filtering content. Yunohost is developed by a community who believe in an open and decentralized internet, and we hope that you do, too!
|
||||
|
||||
- **You want to have control on your data and services.** Your pictures, chat messages, browsing history, and that text you are writing for school, have nothing to do on somebody else's server (a.k.a. The Cloud). They are part of your private life, but also part of your family's life, your friend's life, and so on. These data should be managed by *you*, not a random company in the US who wants your data to analyze them and sell the results.
|
||||
- **You want to have control of your data and services.** Your pictures, chat messages, browsing history, and that text you are writing for school, have nothing to do on somebody else's server (a.k.a. The Cloud). They are part of your private life, but also part of your family's life, your friend's life, and so on. These data should be managed by *you*, not a random company in the US who wants your data to analyze them and sell the results.
|
||||
|
||||
- **You want to learn about how computers and the Internet work.** Operating your own server is a pretty good context to understand the basic mechanisms at the heart of operating systems and the Internet. You might have to deal with command line interface, network architecture, DNS configuration, SSH, and so on.
|
||||
|
||||
- **You want to explore new possibilities and customize things.** Ever dreamed of running a Minecraft server for you friends, or a persistent IRC or XMPP client ? With you very own server, you can manually install and run virtually any program you want, and customize every bits.
|
||||
- **You want to explore new possibilities and customize things.** Ever dreamed of running a Minecraft server for you friends, or a persistent IRC or XMPP client? With you very own server, you can manually install and run virtually any program you want, and customize every bit.
|
||||
|
||||
Why should you *not* host yourself ?
|
||||
------------------------------------
|
||||
|
||||
- **Self-hosting requires some work and patience.** Hosting yourself is a bit like growing your own garden or vegetables : it requires work and patience. While YunoHost aims to do all the hard work for you, self-hosting still requires that you take time to learn and configure a few things to setup your server properly. You will also need to perform maintenance tasks (such as upgrades) from time to time, or to ask for support if some things break.
|
||||
- **Self-hosting requires some work and patience.** Hosting yourself is a bit like growing your own garden or vegetables: it requires work and patience. While YunoHost aims to do all the hard work for you, self-hosting still requires that you take time to learn and configure a few things to setup your server properly. You will also need to perform maintenance tasks (such as upgrades) from time to time, or to ask for support if some things break.
|
||||
|
||||
- **With great servers comes great responsabilities.** Operating a server means that you are responsible of the data you are hosting. Nobody will be able to recover them for you if they get lost. YunoHost provides backup features, which you should use regularly to backup the configurations and data you care about. You should also keep and eye on security news and recommentations so that your server or critical data don't get compromised.
|
||||
- **With great servers comes great responsibilities.** Operating a server means that you are responsible for the data you are hosting. Nobody will be able to recover them for you if they get lost. YunoHost provides backup features, which you should use regularly to backup the configurations and data you care about. You should also keep and eye on security news and recommendations so that your server or critical data don't get compromised.
|
||||
|
||||
- **Quality and performance probably won't be as good as premium services.** YunoHost (and most of the applications packaged for it) are free and open-source softwares, developped by communities of people in their free time and on the basis of best effort. There is no absolute guarantee that software will work in every possible circumstances. The performance of your self-hosted server is also related to its CPU and RAM, and to the available internet connectivity.
|
||||
- **Quality and performance probably won't be as good as premium services.** YunoHost (and most of the applications packaged for it) are free and open-source software, developed by communities of people in their free time and on the basis of best effort. There is no absolute guarantee that software will work in every possible circumstance. The performance of your self-hosted server is also related to its CPU and RAM, and to the available internet connectivity.
|
||||
|
||||
|
|
|
@ -1,11 +1,11 @@
|
|||
L'auto-hébergement
|
||||
==================
|
||||
|
||||
L'auto-hébergement est le fait d'avoir et d'administrer son propre serveur, typiquement chez soi, pour héberger soi-même ses données personelles et des services plutôt que de se reposer exclusivement sur des tiers. Par exemple, il est possible d'auto-héberger son blog de sorte qu'il "vive" dans une machine que vous contrôlez, au lieu qu'il soit sur l'ordinateur de quelqu'un d'autre (a.k.a. le Cloud) en échange d'argent, de publicités ou de données privées.
|
||||
L'auto-hébergement est le fait d'avoir et d'administrer son propre serveur, typiquement chez soi, pour héberger soi-même ses données personnelles et des services plutôt que de se reposer exclusivement sur des tiers. Par exemple, il est possible d'auto-héberger son blog de sorte qu'il "vive" dans une machine que vous contrôlez, au lieu qu'il soit sur l'ordinateur de quelqu'un d'autre (a.k.a. le Cloud) en échange d'argent, de publicités ou de données privées.
|
||||
|
||||
L'auto-hébergement implique de disposer d'un serveur. Un serveur est un ordinateur qui est destiné à être accessible sur le réseau en permanence, et n'a généralement pas d'écran ni de clavier puisqu'il est administé à distance. Contrairement à une croyance répandue, les serveurs ne sont pas nécessairement des machines énormes et extrèmement puissante : aujourd'hui, une petite carte ARM à ~30€ est adéquate pour de l'auto-hébergement.
|
||||
L'auto-hébergement implique de disposer d'un serveur. Un serveur est un ordinateur qui est destiné à être accessible sur le réseau en permanence, et n'a généralement pas d'écran ni de clavier puisqu'il est administré à distance. Contrairement à une croyance répandue, les serveurs ne sont pas nécessairement des machines énormes et extrêmement puissante : aujourd'hui, une petite carte ARM à ~30€ est adéquate pour de l'auto-hébergement.
|
||||
|
||||
Pratique l'auto-hébergement ne rends pas "votre internet" plus sécurisé et ne fourni pas d'anonymat en tant que tel. L'objectif est généralement de pouvoir être autonome et au contrôle de ses services et de ses données - ce qui implique aussi d'en être responsable.
|
||||
Pratiquer l'auto-hébergement ne rend pas "votre internet" plus sécurisé et ne fournit pas d'anonymat en tant que tel. L'objectif est généralement de pouvoir être autonome et au contrôle de ses services et de ses données - ce qui implique aussi d'en être responsable.
|
||||
|
||||
Pourquoi s'auto-héberger ?
|
||||
--------------------------
|
||||
|
@ -14,7 +14,7 @@ Pourquoi s'auto-héberger ?
|
|||
|
||||
- **Vous voulez avoir le contrôle de vos données et services.** Vos images, votre messages de chat, votre historique de navigation, et votre dissertation pour l'école n'ont rien à faire sur l'ordinateur de quelqu'un d'autre (a.k.a. le Cloud). Ces données font parties de votre vie privée, mais également de celle de votre famille, de vos amis, etc. Ces données devraient être gérées par *vous*, et non par une quelconque entreprise américaine qui cherche à analyser vos données pour revendre les résultats.
|
||||
|
||||
- **Vous souhaitez apprendre comment fonctionnent les ordinateurs et Internet.** Opérer son propre serveur est un bon contexte pour apprendre les mécanismes de base au coeur des systèmes d'exploitations (OS) et d'Internet. Il vous faudra possiblement toucher à la ligne de commande et à des morceaux de configuration réseau et DNS.
|
||||
- **Vous souhaitez apprendre comment fonctionnent les ordinateurs et Internet.** Opérer son propre serveur est un bon contexte pour apprendre les mécanismes de base au cœur des systèmes d'exploitations (OS) et d'Internet. Il vous faudra possiblement toucher à la ligne de commande et à des morceaux de configuration réseau et DNS.
|
||||
|
||||
- **Vous voulez explorer de nouvelles possibilités et personnaliser votre espace.** Avez-vous déjà rêvé d'avoir votre propre serveur Minecraft pour vos ami.e.s, ou un client IRC ou XMPP persistent ? Avec votre propre serveur, vous pouvez manuellement installer et faire tourner n'importe quel programme et personnaliser chaque morceau.
|
||||
|
||||
|
@ -23,6 +23,6 @@ Pourquoi ne *pas* s'auto-héberger ?
|
|||
|
||||
- **L'auto-hébergement requiert du travail et de la patience.** S'auto-héberger est un peu comme avoir son propre jardin ou potager : cela demande du travail et de la patience. Bien que YunoHost cherche à faire tout le travail compliqué pour vous, il vous faudra tout de même prendre le temps d'apprendre et configurer quelques détails pour que votre installation marche correctement. Il vous faudra aussi gérer quelques tâches de maintenance (telles que les mises à jour) de temps en temps, et demander de l'aide si des choses ne fonctionnent pas comme prévu.
|
||||
|
||||
- **Avec de grands serveurs viennent les grandes responsabilités.** Opérer un serveur implique d'être responsable des données que vous hébergez : personne ne pourra récupérer des données à votre place si vous les perdez. YunoHost fournit des fonctionnalités de sauvegarde qu'il est recommandé d'utiliser pour sauvegarder les configurations et données importantes. Il vous faut aussi garder un oeil sur les recommandations et les nouvelles à propos de la sécurité pour que votre serveur ou vos données ne soient pas compromises.
|
||||
- **Avec de grands serveurs viennent les grandes responsabilités.** Opérer un serveur implique d'être responsable des données que vous hébergez : personne ne pourra récupérer des données à votre place si vous les perdez. YunoHost fournit des fonctionnalités de sauvegarde qu'il est recommandé d'utiliser pour sauvegarder les configurations et données importantes. Il vous faut aussi garder un œil sur les recommandations et les nouvelles à propos de la sécurité pour que votre serveur ou vos données ne soient pas compromises.
|
||||
|
||||
- **La qualité et les performances ne seront probablement pas aussi bonnes que des services premium.** YunoHost (et la plupart des applications qui sont packagées) sont des logiciels libres et open-source, développés par des communautés bénévoles. Il n'y a pas de garantie absolue que ces logiciels marcheront dans toutes les circonstances possibles. Les performances de votre serveur auto-hébergé sont aussi liés au processeur, à la mémoire vive et à la connectivité internet.
|
||||
- **La qualité et les performances ne seront probablement pas aussi bonnes que des services premium.** YunoHost (et la plupart des applications qui sont packagées) sont des logiciels libres et open-source, développés par des communautés bénévoles. Il n'y a pas de garantie absolue que ces logiciels marcheront dans toutes les circonstances possibles. Les performances de votre serveur auto-hébergé sont aussi liées au processeur, à la mémoire vive et à la connectivité internet.
|
||||
|
|
10
ssh_fr.md
|
@ -2,7 +2,7 @@
|
|||
|
||||
## Qu’est-ce que SSH ?
|
||||
|
||||
**SSH** est un accronyme pour Secure Shell, et désigne un protocole qui permet de contrôler à distance une machine via la ligne de commande (CLI). C'est aussi une commande disponible de base dans les terminaux de Linux et Mac OS / OSX. Sous Windows, il vous faudra utiliser le logiciel [MobaXterm](https://mobaxterm.mobatek.net/download-home-edition.html) (après l'avoir lancer, cliquer sur Session puis SSH).
|
||||
**SSH** est un acronyme pour Secure Shell, et désigne un protocole qui permet de contrôler à distance une machine via la ligne de commande (CLI). C'est aussi une commande disponible de base dans les terminaux de Linux et Mac OS / OSX. Sous Windows, il vous faudra utiliser le logiciel [MobaXterm](https://mobaxterm.mobatek.net/download-home-edition.html) (après l'avoir lancer, cliquer sur Session puis SSH).
|
||||
|
||||
## Pendant l’installation de YunoHost
|
||||
|
||||
|
@ -10,7 +10,7 @@
|
|||
|
||||
Si vous installez YunoHost sur un VPS, votre fournisseur devrait vous avoir communiqué l'adresse IP de votre serveur.
|
||||
|
||||
Si vous installez un serveur à la maison (par ex. sur Raspberry Pi ou OLinuXino), il vous faut trouver l'IP qui a été attribuée à votre carte après que vous l'ayez connecté à votre box internet / routeur. Il y a plusieurs façon de faire ça :
|
||||
Si vous installez un serveur à la maison (par ex. sur Raspberry Pi ou OLinuXino), il vous faut trouver l'IP qui a été attribuée à votre carte après que vous l'ayez connectée à votre box internet / routeur. Il y a plusieurs façons de faire cela :
|
||||
|
||||
- ouvrez un terminal et tapez `sudo arp-scan --local` pour lister les IP des machines sur le réseau local ;
|
||||
- utilisez l'interface de votre box internet pour lister les machines connectées, ou regarder les logs ;
|
||||
|
@ -32,7 +32,7 @@ Depuis YunoHost 3.4, après avoir effectué la postinstallation, il ne sera plus
|
|||
|
||||
#### Changer le mot de passe root !
|
||||
|
||||
Après vous être loggé pour la première fois, il vous faut changer le mot de passe root. Le serveur vous demandera peut-être automatiquement de le faire. Si ce n'est pas le cas, il faut utiliser la commande `passwd`. Il est important de choisir un mot de passe raisonnablement compliqué. Notez que ce mot de passe sera écrasé ensuite par le mot de passe admin choisi lors de la postinstallation.
|
||||
Après vous être connecté pour la première fois, il vous faut changer le mot de passe `root`. Le serveur vous demandera peut-être automatiquement de le faire. Si ce n'est pas le cas, il faut utiliser la commande `passwd`. Il est important de choisir un mot de passe raisonnablement compliqué. Notez que ce mot de passe sera écrasé ensuite par le mot de passe admin choisi lors de la postinstallation.
|
||||
|
||||
## Sur une instance déjà installée
|
||||
|
||||
|
@ -66,7 +66,7 @@ Si vous êtes connecté en tant qu'`admin` et souhaité devenir `root` pour plus
|
|||
|
||||
Par défaut, seulement l'utilisateur `admin` peut se logger en SSH sur une instance Yunohost.
|
||||
|
||||
Les utilisateurs YunoHost créés via l'interface d'administration sont géré par la base de donnée LDAP. Par défaut, ils ne peuvent pas se connecter en SSH pour des raisons de sécurité. Si vous avez absolument besoin qu'un utilisateur dispose d'un accès SSH, vous pouvez utiliser la commande :
|
||||
Les utilisateurs YunoHost créés via l'interface d'administration sont gérés par la base de donnée LDAP. Par défaut, ils ne peuvent pas se connecter en SSH pour des raisons de sécurité. Si vous avez absolument besoin qu'un utilisateur dispose d'un accès SSH, vous pouvez utiliser la commande :
|
||||
```bash
|
||||
yunohost user ssh allow <username>
|
||||
```
|
||||
|
@ -85,6 +85,6 @@ yunohost user ssh list-keys <username>
|
|||
|
||||
## SSH et sécurité
|
||||
|
||||
N.B. : `fail2ban` banniera votre IP pour 10 minutes si vous échouez plus de 5 fois à vous identifier. Pour débannir une IP, vous pouvez regarder la page sur [fail2ban](/fail2ban_fr)
|
||||
N.B. : `fail2ban` bannira votre IP pour 10 minutes si vous échouez plus de 5 fois à vous identifier. Pour débannir une IP, vous pouvez regarder la page sur [fail2ban](/fail2ban_fr)
|
||||
|
||||
Une discussion plus complète de la sécurité et de SSH peut être trouvée sur [la page dédiée](security_fr).
|
||||
|
|
27
try_it.md
Normal file
|
@ -0,0 +1,27 @@
|
|||
#Prova YunoHost
|
||||
|
||||
<div class="alert alert-warning" markdown="1">
|
||||
**Nota:** A volte questo server demo può essere irraggiungibile
|
||||
<br>
|
||||
|
||||
</div>
|
||||
|
||||
<br>
|
||||
|
||||
<div class="row text-center">
|
||||
<div class="col-md-6">
|
||||
<a href="https://demo.yunohost.org/" target="_blank" class="btn btn-success btn-lg"><span class="glyphicon glyphicon-user"></span> Interfaccia utente</a>
|
||||
<p class="text-muted">Nome utente: demo<br>Password: demo</p>
|
||||
</div>
|
||||
<div class="col-md-5">
|
||||
<a href="https://demo.yunohost.org/yunohost/admin" target="_blank" class="btn btn-primary btn-lg"><span class="glyphicon glyphicon-lock"></span> Interfaccia amministrazione</a>
|
||||
<p class="text-muted">Password: demo</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<br>
|
||||
|
||||
<p class="text-center" markdown="1">
|
||||
***Il server demo è gentilmente fornito da
|
||||
<a href="https://www.gitoyen.net" target="_blank">Gitoyen</a>***
|
||||
</p>
|
|
@ -1,22 +1,22 @@
|
|||
# Interface utilisateur
|
||||
|
||||
L'interface utilisateur est un portail permettant à un utilisateur connecté de voir toutes les applications qu'il peut
|
||||
utiliser, et y accéder. Cette interface permet aussi à l'utilisateur de gérer ses paramètres (changer de mot de passe,
|
||||
utiliser, et d'y accéder. Cette interface permet aussi à l'utilisateur de gérer ses paramètres (changer de mot de passe,
|
||||
définir ses alias et redirections courriel).
|
||||
|
||||
<img src="/images/home_panel.jpg" width=800>
|
||||
|
||||
### Problème d’accès
|
||||
|
||||
L’accès à la partie utilisateur peut se faire uniquement avec un nom de domaine. Vous ne pouvez pas y accéder en utilisant l’adresse IP locale de votre serveur comme suit : https://adresse.ip.du.server/yunohost/sso
|
||||
L’accès à la partie utilisateur peut se faire uniquement avec un nom de domaine. Vous ne pouvez **pas** y accéder en utilisant l’adresse IP locale de votre serveur comme suit : https://adresse.ip.du.server/yunohost/sso
|
||||
|
||||
Vous pouvez créer une redirection d’un nom de domaine vers l’adresse IP du serveur en modifiant `/etc/hosts` et en ajoutant cette ligne :
|
||||
Cependant, sur votre ordinateur, vous pouvez créer une redirection d’un nom de domaine vers l’adresse IP du serveur en modifiant le fichier `/etc/hosts` et en ajoutant cette ligne :
|
||||
|
||||
```bash
|
||||
adresse.ip.du.server domaine.tld
|
||||
```
|
||||
|
||||
En remplaçant `adresse.ip.du.server` par exemple par `192.168.1.5` et `domaine.tld` par votre nom de domaine ou par un nom de domaine que vous pouvez choisir si vous n’en avez pas.
|
||||
en remplaçant `adresse.ip.du.server` par exemple par `192.168.1.5` et `domaine.tld` par votre nom de domaine ou par un [nom de domaine que vous pouvez choisir](/dns) si vous n’en avez pas. /!\ Cela ne fonctionne que localement /!\
|
||||
|
||||
### Logiciel
|
||||
|
||||
|
|