diff --git a/images/Galette_1_en_Update.png b/images/Galette_1_en_Update.png deleted file mode 100644 index faccaa40..00000000 Binary files a/images/Galette_1_en_Update.png and /dev/null differ diff --git a/images/Galette_1_fr_MAJ.png b/images/Galette_1_fr_MAJ.png deleted file mode 100644 index 1187ea06..00000000 Binary files a/images/Galette_1_fr_MAJ.png and /dev/null differ diff --git a/images/Galette_2_en_Passwd.png b/images/Galette_2_en_Passwd.png deleted file mode 100644 index d6939306..00000000 Binary files a/images/Galette_2_en_Passwd.png and /dev/null differ diff --git a/images/Galette_2_fr_MdP.png b/images/Galette_2_fr_MdP.png deleted file mode 100644 index 05fe848a..00000000 Binary files a/images/Galette_2_fr_MdP.png and /dev/null differ diff --git a/images/HedgeDoc-Logo.png b/images/HedgeDoc-Logo.png deleted file mode 100644 index 77aa3507..00000000 Binary files a/images/HedgeDoc-Logo.png and /dev/null differ diff --git a/images/Jirafeau_logo.jpg b/images/Jirafeau_logo.jpg deleted file mode 100644 index 35b106cb..00000000 Binary files a/images/Jirafeau_logo.jpg and /dev/null differ diff --git a/images/Mediawiki_screenshot.png b/images/Mediawiki_screenshot.png deleted file mode 100644 index 489a5a4d..00000000 Binary files a/images/Mediawiki_screenshot.png and /dev/null differ diff --git a/images/OnlyOffice_logo.png b/images/OnlyOffice_logo.png deleted file mode 100644 index 3b053510..00000000 Binary files a/images/OnlyOffice_logo.png and /dev/null differ diff --git a/images/Pidgin-add-acount.png b/images/Pidgin-add-acount.png deleted file mode 100644 index 4147b6f3..00000000 Binary files a/images/Pidgin-add-acount.png and /dev/null differ diff --git a/images/PluXml_logo.png b/images/PluXml_logo.png deleted file mode 100644 index b5ce5498..00000000 Binary files a/images/PluXml_logo.png and /dev/null differ diff --git a/images/PluXml_screenshot.jpg b/images/PluXml_screenshot.jpg deleted file mode 100644 index 8fa52feb..00000000 Binary files a/images/PluXml_screenshot.jpg and /dev/null differ diff --git a/images/actions_example.png b/images/actions_example.png deleted file mode 100644 index 04209da6..00000000 Binary files a/images/actions_example.png and /dev/null differ diff --git a/images/adguardhome-logo.png b/images/adguardhome-logo.png deleted file mode 100644 index ea1dae9b..00000000 Binary files a/images/adguardhome-logo.png and /dev/null differ diff --git a/images/adminer_logo.png b/images/adminer_logo.png deleted file mode 100644 index 06444fe5..00000000 Binary files a/images/adminer_logo.png and /dev/null differ diff --git a/images/administrate/specific_use_cases/virtualbox-snapshot.jpg b/images/administrate/specific_use_cases/virtualbox-snapshot.jpg deleted file mode 100644 index 0559f23c..00000000 Binary files a/images/administrate/specific_use_cases/virtualbox-snapshot.jpg and /dev/null differ diff --git a/images/airsonic_logo.png b/images/airsonic_logo.png deleted file mode 100644 index c013faa3..00000000 Binary files a/images/airsonic_logo.png and /dev/null differ diff --git a/images/ampache_logo.png b/images/ampache_logo.png deleted file mode 100644 index ed29e845..00000000 Binary files a/images/ampache_logo.png and /dev/null differ diff --git a/images/anarchism_logo.svg b/images/anarchism_logo.svg deleted file mode 100644 index f2b4b29c..00000000 --- a/images/anarchism_logo.svg +++ /dev/null @@ -1,11 +0,0 @@ - - - - - - - - - - - diff --git a/images/anfora_logo.svg b/images/anfora_logo.svg deleted file mode 100644 index 90f982c4..00000000 --- a/images/anfora_logo.svg +++ /dev/null @@ -1,11 +0,0 @@ - - - - - - - - - - - diff --git a/images/apps_catalog.png b/images/apps_catalog.png deleted file mode 100644 index 04ba85fe..00000000 Binary files a/images/apps_catalog.png and /dev/null differ diff --git a/images/apps_custom_url.png b/images/apps_custom_url.png deleted file mode 100644 index cf0816fe..00000000 Binary files a/images/apps_custom_url.png and /dev/null differ diff --git a/images/baikal_logo.png b/images/baikal_logo.png deleted file mode 100644 index 1a623ea3..00000000 Binary files a/images/baikal_logo.png and /dev/null differ diff --git a/images/bitwarden_logo.png b/images/bitwarden_logo.png deleted file mode 100644 index 06e4c84b..00000000 Binary files a/images/bitwarden_logo.png and /dev/null differ diff --git a/images/blogotext_logo.png b/images/blogotext_logo.png deleted file mode 100644 index 9a6752f0..00000000 Binary files a/images/blogotext_logo.png and /dev/null differ diff --git a/images/bludit_logo.png b/images/bludit_logo.png deleted file mode 100644 index b1a69662..00000000 Binary files a/images/bludit_logo.png and /dev/null differ diff --git a/images/boot_screen.png b/images/boot_screen.png deleted file mode 100644 index f8c4f2b8..00000000 Binary files a/images/boot_screen.png and /dev/null differ diff --git a/images/borg_logo.svg b/images/borg_logo.svg deleted file mode 100644 index 5f9c5a19..00000000 --- a/images/borg_logo.svg +++ /dev/null @@ -1,11 +0,0 @@ - - - - - - - - - - - diff --git a/images/brique.png b/images/brique.png deleted file mode 100644 index 762dfe3d..00000000 Binary files a/images/brique.png and /dev/null differ diff --git a/images/capture_espace_connexion.png b/images/capture_espace_connexion.png deleted file mode 100644 index d2edd32d..00000000 Binary files a/images/capture_espace_connexion.png and /dev/null differ diff --git a/images/capture_globale.png b/images/capture_globale.png deleted file mode 100644 index 5b2b84d9..00000000 Binary files a/images/capture_globale.png and /dev/null differ diff --git a/images/capture_menu_droite.png b/images/capture_menu_droite.png deleted file mode 100644 index 60658ac7..00000000 Binary files a/images/capture_menu_droite.png and /dev/null differ diff --git a/images/capture_menu_droite_chercher_utilisateur.png b/images/capture_menu_droite_chercher_utilisateur.png deleted file mode 100644 index d29a1ffe..00000000 Binary files a/images/capture_menu_droite_chercher_utilisateur.png and /dev/null differ diff --git a/images/capture_menu_droite_deconnexion.png b/images/capture_menu_droite_deconnexion.png deleted file mode 100644 index ba2b7c79..00000000 Binary files a/images/capture_menu_droite_deconnexion.png and /dev/null differ diff --git a/images/capture_menu_droite_preferences.png b/images/capture_menu_droite_preferences.png deleted file mode 100644 index ce7d05ed..00000000 Binary files a/images/capture_menu_droite_preferences.png and /dev/null differ diff --git a/images/capture_menu_gauche.png b/images/capture_menu_gauche.png deleted file mode 100644 index 842e8a70..00000000 Binary files a/images/capture_menu_gauche.png and /dev/null differ diff --git a/images/civicrm_logo.png b/images/civicrm_logo.png deleted file mode 100644 index d82cd8b4..00000000 Binary files a/images/civicrm_logo.png and /dev/null differ diff --git a/images/codimd_logo.png b/images/codimd_logo.png deleted file mode 100644 index 2422174f..00000000 Binary files a/images/codimd_logo.png and /dev/null differ diff --git a/images/collabora_logo.png b/images/collabora_logo.png deleted file mode 100644 index 22227baf..00000000 Binary files a/images/collabora_logo.png and /dev/null differ diff --git a/images/concrete5_logo.png b/images/concrete5_logo.png deleted file mode 100644 index 945438c9..00000000 Binary files a/images/concrete5_logo.png and /dev/null differ diff --git a/images/config_panel_example.png b/images/config_panel_example.png deleted file mode 100644 index 5665a3c9..00000000 Binary files a/images/config_panel_example.png and /dev/null differ diff --git a/images/config_panel_toml_example.png b/images/config_panel_toml_example.png deleted file mode 100644 index c72e0baf..00000000 Binary files a/images/config_panel_toml_example.png and /dev/null differ diff --git a/images/cowyo_logo.png b/images/cowyo_logo.png deleted file mode 100644 index 35253a33..00000000 Binary files a/images/cowyo_logo.png and /dev/null differ diff --git a/images/create-first-user-cli.png b/images/create-first-user-cli.png deleted file mode 100644 index 3e3a1480..00000000 Binary files a/images/create-first-user-cli.png and /dev/null differ diff --git a/images/create-first-user.png b/images/create-first-user.png deleted file mode 100644 index 66b5f5c8..00000000 Binary files a/images/create-first-user.png and /dev/null differ diff --git a/images/cubieboard2.png b/images/cubieboard2.png deleted file mode 100644 index e4103dcc..00000000 Binary files a/images/cubieboard2.png and /dev/null differ diff --git a/images/cubietruck.jpg b/images/cubietruck.jpg deleted file mode 100644 index c9437023..00000000 Binary files a/images/cubietruck.jpg and /dev/null differ diff --git a/images/desktop.jpg b/images/desktop.jpg deleted file mode 100644 index 8254eabd..00000000 Binary files a/images/desktop.jpg and /dev/null differ diff --git a/images/diagramsnet_logo.jpg b/images/diagramsnet_logo.jpg deleted file mode 100644 index c30ae934..00000000 Binary files a/images/diagramsnet_logo.jpg and /dev/null differ diff --git a/images/discourse_logo.svg b/images/discourse_logo.svg deleted file mode 100644 index 73e7d63e..00000000 --- a/images/discourse_logo.svg +++ /dev/null @@ -1 +0,0 @@ -Discourse_logo \ No newline at end of file diff --git a/images/docker.png b/images/docker.png deleted file mode 100644 index 780a8d5c..00000000 Binary files a/images/docker.png and /dev/null differ diff --git a/images/dokuwiki_logo.svg b/images/dokuwiki_logo.svg deleted file mode 100644 index cbee241e..00000000 --- a/images/dokuwiki_logo.svg +++ /dev/null @@ -1,553 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - image/svg+xml - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/images/dolibarr_logo.png b/images/dolibarr_logo.png deleted file mode 100644 index 2cd7964d..00000000 Binary files a/images/dolibarr_logo.png and /dev/null differ diff --git a/images/dotclean_logo.png b/images/dotclean_logo.png deleted file mode 100644 index b5f0552b..00000000 Binary files a/images/dotclean_logo.png and /dev/null differ diff --git a/images/drupal_logo.svg b/images/drupal_logo.svg deleted file mode 100644 index 7da67bde..00000000 --- a/images/drupal_logo.svg +++ /dev/null @@ -1 +0,0 @@ -]>Druplicon \ No newline at end of file diff --git a/images/ethercalc_logo.png b/images/ethercalc_logo.png deleted file mode 100644 index 88125816..00000000 Binary files a/images/ethercalc_logo.png and /dev/null differ diff --git a/images/etherpad_mypads_logo.jpg b/images/etherpad_mypads_logo.jpg deleted file mode 100644 index 9b888ad1..00000000 Binary files a/images/etherpad_mypads_logo.jpg and /dev/null differ diff --git a/images/etherpad_mypads_logo.svg b/images/etherpad_mypads_logo.svg deleted file mode 100644 index a4007d16..00000000 --- a/images/etherpad_mypads_logo.svg +++ /dev/null @@ -1,61 +0,0 @@ - - - - - Etherpad - - - - image/svg+xml - - Etherpad - 2012-11-20 - - - Marcel Klehr - - - - - - - - - - - - - - - - - diff --git a/images/ffsync_logo.png b/images/ffsync_logo.png deleted file mode 100644 index a41f526c..00000000 Binary files a/images/ffsync_logo.png and /dev/null differ diff --git a/images/firefly-iii_logo.png b/images/firefly-iii_logo.png deleted file mode 100644 index 26598804..00000000 Binary files a/images/firefly-iii_logo.png and /dev/null differ diff --git a/images/firefly-logo.png b/images/firefly-logo.png deleted file mode 100644 index c9ea5706..00000000 Binary files a/images/firefly-logo.png and /dev/null differ diff --git a/images/flarum_logo.png b/images/flarum_logo.png deleted file mode 100644 index ef72258a..00000000 Binary files a/images/flarum_logo.png and /dev/null differ diff --git a/images/fluxbb_logo.png b/images/fluxbb_logo.png deleted file mode 100644 index b9886904..00000000 Binary files a/images/fluxbb_logo.png and /dev/null differ diff --git a/images/framaforms_logo.png b/images/framaforms_logo.png deleted file mode 100644 index 54e91ddf..00000000 Binary files a/images/framaforms_logo.png and /dev/null differ diff --git a/images/freshrss_logo.png b/images/freshrss_logo.png deleted file mode 100644 index 5ef73cce..00000000 Binary files a/images/freshrss_logo.png and /dev/null differ diff --git a/images/friendica_logo.jpeg b/images/friendica_logo.jpeg deleted file mode 100644 index 89086338..00000000 Binary files a/images/friendica_logo.jpeg and /dev/null differ diff --git a/images/friendica_logo.svg b/images/friendica_logo.svg deleted file mode 100644 index 75d54920..00000000 --- a/images/friendica_logo.svg +++ /dev/null @@ -1,52 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - image/svg+xml - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/images/funkwhale_logo.png b/images/funkwhale_logo.png deleted file mode 100644 index 7cf56217..00000000 Binary files a/images/funkwhale_logo.png and /dev/null differ diff --git a/images/garradin_logo.svg b/images/garradin_logo.svg deleted file mode 100644 index daa8151d..00000000 --- a/images/garradin_logo.svg +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - - - image/svg+xml - - - - - - - - - - - diff --git a/images/gitea_logo.png b/images/gitea_logo.png deleted file mode 100644 index dd3e97c4..00000000 Binary files a/images/gitea_logo.png and /dev/null differ diff --git a/images/gitlab-runner_logo.png b/images/gitlab-runner_logo.png deleted file mode 100644 index a629de7e..00000000 Binary files a/images/gitlab-runner_logo.png and /dev/null differ diff --git a/images/gitlab_logo.svg b/images/gitlab_logo.svg deleted file mode 100644 index 6e66c741..00000000 --- a/images/gitlab_logo.svg +++ /dev/null @@ -1,30 +0,0 @@ - - - - -Fill 1 + Group 24 -Created with Sketch. - - - - - - - - - - - - - - - - - - - diff --git a/images/glowing_bear_logo.svg b/images/glowing_bear_logo.svg deleted file mode 100644 index 48e21c42..00000000 --- a/images/glowing_bear_logo.svg +++ /dev/null @@ -1 +0,0 @@ -glowing-bearCreated with Sketch (http://www.bohemiancoding.com/sketch) \ No newline at end of file diff --git a/images/glpi_logo.png b/images/glpi_logo.png deleted file mode 100644 index 7dac3d65..00000000 Binary files a/images/glpi_logo.png and /dev/null differ diff --git a/images/gogs_logo.svg b/images/gogs_logo.svg deleted file mode 100644 index ddd59685..00000000 --- a/images/gogs_logo.svg +++ /dev/null @@ -1,192 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - image/svg+xml - - - - - - - - - - - - - - - - diff --git a/images/gotify_logo.png b/images/gotify_logo.png deleted file mode 100644 index 99848593..00000000 Binary files a/images/gotify_logo.png and /dev/null differ diff --git a/images/gparted.jpg b/images/gparted.jpg deleted file mode 100644 index c6e00c09..00000000 Binary files a/images/gparted.jpg and /dev/null differ diff --git a/images/grav_logo.png b/images/grav_logo.png deleted file mode 100644 index 489c4ea9..00000000 Binary files a/images/grav_logo.png and /dev/null differ diff --git a/images/grocy-logo.png b/images/grocy-logo.png deleted file mode 100644 index dd4f08a2..00000000 Binary files a/images/grocy-logo.png and /dev/null differ diff --git a/images/halcyon_logo.png b/images/halcyon_logo.png deleted file mode 100644 index 4468cdf3..00000000 Binary files a/images/halcyon_logo.png and /dev/null differ diff --git a/images/hextris_logo.png b/images/hextris_logo.png deleted file mode 100644 index ce78a935..00000000 Binary files a/images/hextris_logo.png and /dev/null differ diff --git a/images/horde_logo.png b/images/horde_logo.png deleted file mode 100644 index 686b4db0..00000000 Binary files a/images/horde_logo.png and /dev/null differ diff --git a/images/hubzilla_logo.png b/images/hubzilla_logo.png deleted file mode 100644 index 5766891d..00000000 Binary files a/images/hubzilla_logo.png and /dev/null differ diff --git a/images/images.list b/images/images.list deleted file mode 100644 index 9b1cf3f4..00000000 --- a/images/images.list +++ /dev/null @@ -1,74 +0,0 @@ -boot_screen.png -cd.jpg -checkstart.png -cubieboard2.png -debian-logo.png -desktop.jpg -df_h.png -digitalocean.png -dns_9box.png -dns_dynamic-ip_box_conf.png -docker.png -dude_yunohost.jpg -flattr-badge-large.png -free_m.png -freshrss_logo.png -github_ribbon_grey.png -gparted.jpg -home_enjoy.jpg -home_install.png -home_manage.jpg -home_panel.jpg -install_script.png -ip_serveur.png -jappix.png -laptop.png -Linuxfr.png -logo-jirafeau.jpeg -logo.png -Logo-wallabag-svg.svg -lxc.png -mailview.jpg -webadmin.png -webadmin_fr.png -micro-sd-card.jpg -nettop.jpg -networks.png -nginx.png -OVH1_domain_select.png -OVH2_domain_DNS.png -OVH3_zoneDNS.png -Pidgin-add-acount.png -piwigo.png -postinstall_cli.png -postinstall_error.png -postinstall_web.png -Raspberry_Pi_2_Model_B_v1.1_front_angle_new.jpg -roundcube.png -sdcard.jpg -Searx_logo.svg -services_status.png -sfr-authentification.png -sfr-filtrage.png -thisisinternet.png -thunderbird-config.png -transmission.png -ttrss.png -unetbootin.png -usb_key.png -virtualbox_1.png -virtualbox_2.1.png -virtualbox_2.png -virtualbox_3.png -virtualbox.png -vps.png -web4all.png -Wikipedia-logo-v2-fr.svg -win32diskimager.png -wordpress.png -XMPP_logo.png -ynh_admin_etat_ip.png -ynh_login.png -ynh_logo_black.png -ynh_logo_white.png -yunohost_package.png diff --git a/images/invidious-logo.png b/images/invidious-logo.png deleted file mode 100644 index 55b696e8..00000000 Binary files a/images/invidious-logo.png and /dev/null differ diff --git a/images/invoiceninja_logo.png b/images/invoiceninja_logo.png deleted file mode 100644 index 0c663528..00000000 Binary files a/images/invoiceninja_logo.png and /dev/null differ diff --git a/images/jappix_logo.png b/images/jappix_logo.png deleted file mode 100644 index 53124199..00000000 Binary files a/images/jappix_logo.png and /dev/null differ diff --git a/images/jitsi_logo.png b/images/jitsi_logo.png deleted file mode 100644 index 42aa5618..00000000 Binary files a/images/jitsi_logo.png and /dev/null differ diff --git a/images/jitsi_logo.svg b/images/jitsi_logo.svg deleted file mode 100644 index 5a3526ac..00000000 --- a/images/jitsi_logo.svg +++ /dev/null @@ -1,650 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - image/svg+xml - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/images/jupyterlab_logo.svg b/images/jupyterlab_logo.svg deleted file mode 100644 index ab255087..00000000 --- a/images/jupyterlab_logo.svg +++ /dev/null @@ -1,90 +0,0 @@ - -Group.svg -Created using Figma 0.90 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/images/kanboard_logo.png b/images/kanboard_logo.png deleted file mode 100644 index 4f3436df..00000000 Binary files a/images/kanboard_logo.png and /dev/null differ diff --git a/images/keeweb_logo.png b/images/keeweb_logo.png deleted file mode 100644 index 769c5a81..00000000 Binary files a/images/keeweb_logo.png and /dev/null differ diff --git a/images/kresus_logo.png b/images/kresus_logo.png deleted file mode 100644 index d55dc2ce..00000000 Binary files a/images/kresus_logo.png and /dev/null differ diff --git a/images/laptop.png b/images/laptop.png deleted file mode 100644 index 57528c2b..00000000 Binary files a/images/laptop.png and /dev/null differ diff --git a/images/leed_logo.png b/images/leed_logo.png deleted file mode 100644 index f9f192b3..00000000 Binary files a/images/leed_logo.png and /dev/null differ diff --git a/images/liberapay_logo.svg b/images/liberapay_logo.svg deleted file mode 100644 index 007d686c..00000000 --- a/images/liberapay_logo.svg +++ /dev/null @@ -1,2 +0,0 @@ -Donate \ No newline at end of file diff --git a/images/limesurvey_logo.png b/images/limesurvey_logo.png deleted file mode 100644 index bc60942e..00000000 Binary files a/images/limesurvey_logo.png and /dev/null differ diff --git a/images/logo-bibliogram.png b/images/logo-bibliogram.png deleted file mode 100644 index 51c97c89..00000000 Binary files a/images/logo-bibliogram.png and /dev/null differ diff --git a/images/logo-bookstack.png b/images/logo-bookstack.png deleted file mode 100644 index d10b3ca4..00000000 Binary files a/images/logo-bookstack.png and /dev/null differ diff --git a/images/logo-jupyterhub.png b/images/logo-jupyterhub.png deleted file mode 100644 index 48d8b817..00000000 Binary files a/images/logo-jupyterhub.png and /dev/null differ diff --git a/images/lstu_logo.svg b/images/lstu_logo.svg deleted file mode 100644 index a4c24ebb..00000000 --- a/images/lstu_logo.svg +++ /dev/null @@ -1,188 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/images/lufi_logo.png b/images/lufi_logo.png deleted file mode 100644 index a32ed32e..00000000 Binary files a/images/lufi_logo.png and /dev/null differ diff --git a/images/lufi_logo.svg b/images/lufi_logo.svg deleted file mode 100644 index 7d53d1f3..00000000 --- a/images/lufi_logo.svg +++ /dev/null @@ -1,93 +0,0 @@ - - - - - - - - - - image/svg+xml - - - - - - - - - - - - - - - diff --git a/images/lutim_logo.png b/images/lutim_logo.png deleted file mode 100644 index fb4146d7..00000000 Binary files a/images/lutim_logo.png and /dev/null differ diff --git a/images/lxc.png b/images/lxc.png deleted file mode 100644 index e344c1dd..00000000 Binary files a/images/lxc.png and /dev/null differ diff --git a/images/lychee_logo.png b/images/lychee_logo.png deleted file mode 100644 index aa6c318b..00000000 Binary files a/images/lychee_logo.png and /dev/null differ diff --git a/images/mailman_logo.jpg b/images/mailman_logo.jpg deleted file mode 100644 index edd5e373..00000000 Binary files a/images/mailman_logo.jpg and /dev/null differ diff --git a/images/mailman_logo.svg b/images/mailman_logo.svg deleted file mode 100644 index a87f157c..00000000 --- a/images/mailman_logo.svg +++ /dev/null @@ -1,928 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - image/svg+xml - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/images/mailview.jpg b/images/mailview.jpg deleted file mode 100644 index 51bc9400..00000000 Binary files a/images/mailview.jpg and /dev/null differ diff --git a/images/mantis_logo.png b/images/mantis_logo.png deleted file mode 100644 index d2529c81..00000000 Binary files a/images/mantis_logo.png and /dev/null differ diff --git a/images/mastodon_logo.svg b/images/mastodon_logo.svg deleted file mode 100644 index 8b1328e8..00000000 --- a/images/mastodon_logo.svg +++ /dev/null @@ -1 +0,0 @@ - diff --git a/images/matomo_Logo.svg b/images/matomo_Logo.svg deleted file mode 100644 index 14d9f510..00000000 --- a/images/matomo_Logo.svg +++ /dev/null @@ -1,32 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/images/matomo_logo.png b/images/matomo_logo.png deleted file mode 100644 index d62dd696..00000000 Binary files a/images/matomo_logo.png and /dev/null differ diff --git a/images/mattermost_logo.png b/images/mattermost_logo.png deleted file mode 100644 index 189c5dc9..00000000 Binary files a/images/mattermost_logo.png and /dev/null differ diff --git a/images/mattermost_logo.svg b/images/mattermost_logo.svg deleted file mode 100644 index 57a5184a..00000000 --- a/images/mattermost_logo.svg +++ /dev/null @@ -1,2 +0,0 @@ - -image/svg+xml \ No newline at end of file diff --git a/images/mediawiki_logo.svg b/images/mediawiki_logo.svg deleted file mode 100644 index 294a02af..00000000 --- a/images/mediawiki_logo.svg +++ /dev/null @@ -1,22 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - diff --git a/images/micro-sd-card.jpg b/images/micro-sd-card.jpg deleted file mode 100644 index f6ba96a3..00000000 Binary files a/images/micro-sd-card.jpg and /dev/null differ diff --git a/images/minetest_logo.svg b/images/minetest_logo.svg deleted file mode 100644 index db6bdbf7..00000000 --- a/images/minetest_logo.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/images/misskey_logo.png b/images/misskey_logo.png deleted file mode 100644 index 3347810a..00000000 Binary files a/images/misskey_logo.png and /dev/null differ diff --git a/images/mobilizon_logo.png b/images/mobilizon_logo.png deleted file mode 100644 index 5f50cf05..00000000 Binary files a/images/mobilizon_logo.png and /dev/null differ diff --git a/images/mobilizon_logo.svg b/images/mobilizon_logo.svg deleted file mode 100644 index 1130b11f..00000000 --- a/images/mobilizon_logo.svg +++ /dev/null @@ -1 +0,0 @@ -Fichier 1 \ No newline at end of file diff --git a/images/monitorix_log.png b/images/monitorix_log.png deleted file mode 100644 index 11f53426..00000000 Binary files a/images/monitorix_log.png and /dev/null differ diff --git a/images/moodle_logo.svg b/images/moodle_logo.svg deleted file mode 100644 index 47ceb363..00000000 --- a/images/moodle_logo.svg +++ /dev/null @@ -1,33 +0,0 @@ - - - - - - - - - - - - - diff --git a/images/mumbleserver_logo.svg b/images/mumbleserver_logo.svg deleted file mode 100644 index 9414a0a7..00000000 --- a/images/mumbleserver_logo.svg +++ /dev/null @@ -1,2252 +0,0 @@ - - - - - Mumble logo - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - image/svg+xml - - Mumble logo - 2009.08.17 - - - Martin Skilnand - - - - - Martin Skilnand - - - - - Mumble team - - - mumble.svg - git://mumble.git.sourceforge.net/gitroot/mumble - Logo for voice chat program mumble - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/images/mytinytodo_logo.png b/images/mytinytodo_logo.png deleted file mode 100644 index 1720924a..00000000 Binary files a/images/mytinytodo_logo.png and /dev/null differ diff --git a/images/navidrome_logo.png b/images/navidrome_logo.png deleted file mode 100644 index 993c8e09..00000000 Binary files a/images/navidrome_logo.png and /dev/null differ diff --git a/images/netdata_logo.svg b/images/netdata_logo.svg deleted file mode 100644 index 18152fb7..00000000 --- a/images/netdata_logo.svg +++ /dev/null @@ -1,8 +0,0 @@ - - - - - - - - \ No newline at end of file diff --git a/images/nettop.jpg b/images/nettop.jpg deleted file mode 100644 index 606592ab..00000000 Binary files a/images/nettop.jpg and /dev/null differ diff --git a/images/networks.png b/images/networks.png deleted file mode 100644 index 563b60db..00000000 Binary files a/images/networks.png and /dev/null differ diff --git a/images/nextcloud_logo.png b/images/nextcloud_logo.png deleted file mode 100644 index e813cecd..00000000 Binary files a/images/nextcloud_logo.png and /dev/null differ diff --git a/images/nextcloud_menu_parameter.jpg b/images/nextcloud_menu_parameter.jpg deleted file mode 100644 index 0bf2ff0e..00000000 Binary files a/images/nextcloud_menu_parameter.jpg and /dev/null differ diff --git a/images/nextcloud_stockage_externe.jpg b/images/nextcloud_stockage_externe.jpg deleted file mode 100644 index 49583d6e..00000000 Binary files a/images/nextcloud_stockage_externe.jpg and /dev/null differ diff --git a/images/odroidc2.jpg b/images/odroidc2.jpg deleted file mode 100644 index dfe2e9c5..00000000 Binary files a/images/odroidc2.jpg and /dev/null differ diff --git a/images/opensondage_logo.png b/images/opensondage_logo.png deleted file mode 100644 index 3a3603ee..00000000 Binary files a/images/opensondage_logo.png and /dev/null differ diff --git a/images/orangepipcplus.jpg b/images/orangepipcplus.jpg deleted file mode 100644 index aeb8e057..00000000 Binary files a/images/orangepipcplus.jpg and /dev/null differ diff --git a/images/organization_schema.png b/images/organization_schema.png deleted file mode 100644 index e51b0d77..00000000 Binary files a/images/organization_schema.png and /dev/null differ diff --git a/images/osticket_logo.svg b/images/osticket_logo.svg deleted file mode 100644 index 2733d70b..00000000 --- a/images/osticket_logo.svg +++ /dev/null @@ -1,96 +0,0 @@ - - - - - - - - image/svg+xml - - - - - - - - - - - - - - - - - - diff --git a/images/peertube_embed_01.png b/images/peertube_embed_01.png deleted file mode 100644 index 74bc12fa..00000000 Binary files a/images/peertube_embed_01.png and /dev/null differ diff --git a/images/peertube_logo.png b/images/peertube_logo.png deleted file mode 100644 index 7d709ef1..00000000 Binary files a/images/peertube_logo.png and /dev/null differ diff --git a/images/peertube_logo.svg b/images/peertube_logo.svg deleted file mode 100644 index b4a60996..00000000 --- a/images/peertube_logo.svg +++ /dev/null @@ -1,2 +0,0 @@ - - \ No newline at end of file diff --git a/images/phpmyadmin_logo.svg b/images/phpmyadmin_logo.svg deleted file mode 100644 index 95d919f3..00000000 --- a/images/phpmyadmin_logo.svg +++ /dev/null @@ -1,43 +0,0 @@ - - - - - - image/svg+xml - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/images/pihole_logo.png b/images/pihole_logo.png deleted file mode 100644 index 178c085d..00000000 Binary files a/images/pihole_logo.png and /dev/null differ diff --git a/images/piwigo.org.svg b/images/piwigo.org.svg deleted file mode 100644 index 582608ff..00000000 --- a/images/piwigo.org.svg +++ /dev/null @@ -1,26 +0,0 @@ - - - - - - - - - - - - - - diff --git a/images/piwigo_logo.png b/images/piwigo_logo.png deleted file mode 100644 index e33c4a11..00000000 Binary files a/images/piwigo_logo.png and /dev/null differ diff --git a/images/piwigo_screenshot.jpg b/images/piwigo_screenshot.jpg deleted file mode 100644 index 09c80ae2..00000000 Binary files a/images/piwigo_screenshot.jpg and /dev/null differ diff --git a/images/pleroma_logo.png b/images/pleroma_logo.png deleted file mode 100644 index a199972d..00000000 Binary files a/images/pleroma_logo.png and /dev/null differ diff --git a/images/plume_logo.svg b/images/plume_logo.svg deleted file mode 100644 index a0075316..00000000 --- a/images/plume_logo.svg +++ /dev/null @@ -1,37 +0,0 @@ - - - - Plume Logo - Feather - - - - - - image/svg+xml - - Plume Logo - Feather - 2018/10/07 - - - Abdullah Tarawneh (trwnh.com) - - - - - trwnh - - - A Plume concept logo, with a soft stylized feather. Solid path, no fill. - - - - - - - - - - - - - \ No newline at end of file diff --git a/images/rainloop-logo.png b/images/rainloop-logo.png deleted file mode 100644 index 1cb320c2..00000000 Binary files a/images/rainloop-logo.png and /dev/null differ diff --git a/images/roundcube.png b/images/roundcube.png deleted file mode 100644 index 181e1862..00000000 Binary files a/images/roundcube.png and /dev/null differ diff --git a/images/roundcube_logo.svg b/images/roundcube_logo.svg deleted file mode 100644 index 04238a06..00000000 --- a/images/roundcube_logo.svg +++ /dev/null @@ -1,15 +0,0 @@ - - - - - - - - - - \ No newline at end of file diff --git a/images/sdcard.jpg b/images/sdcard.jpg deleted file mode 100644 index 3281ab8b..00000000 Binary files a/images/sdcard.jpg and /dev/null differ diff --git a/images/searx_logo.svg b/images/searx_logo.svg deleted file mode 100644 index 302d6c3f..00000000 --- a/images/searx_logo.svg +++ /dev/null @@ -1,40 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - image/svg+xml - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/images/simple-torrent_logo.png b/images/simple-torrent_logo.png deleted file mode 100644 index b18f220d..00000000 Binary files a/images/simple-torrent_logo.png and /dev/null differ diff --git a/images/slingcode_logo.svg b/images/slingcode_logo.svg deleted file mode 100644 index 8758bf4e..00000000 --- a/images/slingcode_logo.svg +++ /dev/null @@ -1,141 +0,0 @@ - - - - - - - - - - - - - - - - - - - image/svg+xml - - - - - - - - - - - - - - - - - diff --git a/images/snappymail_logo.png b/images/snappymail_logo.png deleted file mode 100644 index 213feded..00000000 Binary files a/images/snappymail_logo.png and /dev/null differ diff --git a/images/sogo_logo.png b/images/sogo_logo.png deleted file mode 100644 index bfad4b53..00000000 Binary files a/images/sogo_logo.png and /dev/null differ diff --git a/images/strut_logo.png b/images/strut_logo.png deleted file mode 100644 index db6668c8..00000000 Binary files a/images/strut_logo.png and /dev/null differ diff --git a/images/transmission.png b/images/transmission.png deleted file mode 100644 index 96f8ab13..00000000 Binary files a/images/transmission.png and /dev/null differ diff --git a/images/ttrss.png b/images/ttrss.png deleted file mode 100644 index 4e747523..00000000 Binary files a/images/ttrss.png and /dev/null differ diff --git a/images/ulogger-logo.png b/images/ulogger-logo.png deleted file mode 100644 index 7aac5abe..00000000 Binary files a/images/ulogger-logo.png and /dev/null differ diff --git a/images/umami-logo.png b/images/umami-logo.png deleted file mode 100644 index 14c12ed9..00000000 Binary files a/images/umami-logo.png and /dev/null differ diff --git a/images/unetbootin.png b/images/unetbootin.png deleted file mode 100644 index 9fd4e374..00000000 Binary files a/images/unetbootin.png and /dev/null differ diff --git a/images/administrate/specific_use_cases/virtualbox-snapshot2.webp b/images/virtualbox-snapshot2.webp similarity index 100% rename from images/administrate/specific_use_cases/virtualbox-snapshot2.webp rename to images/virtualbox-snapshot2.webp diff --git a/images/administrate/specific_use_cases/virtualbox-snapshot3.webp b/images/virtualbox-snapshot3.webp similarity index 100% rename from images/administrate/specific_use_cases/virtualbox-snapshot3.webp rename to images/virtualbox-snapshot3.webp diff --git a/images/administrate/specific_use_cases/virtualbox-snapshot4.webp b/images/virtualbox-snapshot4.webp similarity index 100% rename from images/administrate/specific_use_cases/virtualbox-snapshot4.webp rename to images/virtualbox-snapshot4.webp diff --git a/images/wallabag2_logo.svg b/images/wallabag2_logo.svg deleted file mode 100644 index 303860d9..00000000 --- a/images/wallabag2_logo.svg +++ /dev/null @@ -1,22 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/images/wallabag_logo.svg b/images/wallabag_logo.svg deleted file mode 100644 index 303860d9..00000000 --- a/images/wallabag_logo.svg +++ /dev/null @@ -1,22 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/images/weblate_logo.svg b/images/weblate_logo.svg deleted file mode 100644 index feca88dc..00000000 --- a/images/weblate_logo.svg +++ /dev/null @@ -1,124 +0,0 @@ - - - - - - image/svg+xml - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/images/webmin_logo.png b/images/webmin_logo.png deleted file mode 100644 index df1bbe78..00000000 Binary files a/images/webmin_logo.png and /dev/null differ diff --git a/images/webtrees_logo.png b/images/webtrees_logo.png deleted file mode 100644 index 46bf667f..00000000 Binary files a/images/webtrees_logo.png and /dev/null differ diff --git a/images/wekan_logo.svg b/images/wekan_logo.svg deleted file mode 100644 index da34a07a..00000000 --- a/images/wekan_logo.svg +++ /dev/null @@ -1 +0,0 @@ -wekan-1_2 \ No newline at end of file diff --git a/images/wemawema_logo.png b/images/wemawema_logo.png deleted file mode 100644 index cff5b9e7..00000000 Binary files a/images/wemawema_logo.png and /dev/null differ diff --git a/images/wikijs_logo.svg b/images/wikijs_logo.svg deleted file mode 100644 index 52c4a790..00000000 --- a/images/wikijs_logo.svg +++ /dev/null @@ -1,119 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/images/wordpress_logo.svg b/images/wordpress_logo.svg deleted file mode 100644 index 8628e3ad..00000000 --- a/images/wordpress_logo.svg +++ /dev/null @@ -1,68 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/images/writefreely-logo.png b/images/writefreely-logo.png deleted file mode 100644 index ff0e1448..00000000 Binary files a/images/writefreely-logo.png and /dev/null differ diff --git a/images/writefreely_logo.svg b/images/writefreely_logo.svg deleted file mode 100644 index 294ca0a3..00000000 --- a/images/writefreely_logo.svg +++ /dev/null @@ -1,69 +0,0 @@ - - - - - - - - - - image/svg+xml - - - - - - - - - - - diff --git a/images/yourls-logo.png b/images/yourls-logo.png deleted file mode 100644 index 77bc95d4..00000000 Binary files a/images/yourls-logo.png and /dev/null differ diff --git a/images/z-push_logo.jpg b/images/z-push_logo.jpg deleted file mode 100644 index ab0889f0..00000000 Binary files a/images/z-push_logo.jpg and /dev/null differ diff --git a/images/zabbix_logo.png b/images/zabbix_logo.png deleted file mode 100644 index 378fec3f..00000000 Binary files a/images/zabbix_logo.png and /dev/null differ diff --git a/images/zap_logo.svg b/images/zap_logo.svg deleted file mode 100644 index 94578a3f..00000000 --- a/images/zap_logo.svg +++ /dev/null @@ -1,67 +0,0 @@ - - - - - - image/svg+xml - - - - - - - - - - - diff --git a/images/zerobin_logo.svg b/images/zerobin_logo.svg deleted file mode 100644 index d63c65db..00000000 --- a/images/zerobin_logo.svg +++ /dev/null @@ -1 +0,0 @@ - diff --git a/images/zerotier_logo.png b/images/zerotier_logo.png deleted file mode 100644 index 0e49bd3f..00000000 Binary files a/images/zerotier_logo.png and /dev/null differ diff --git a/pages/02.administer/15.admin_guide/30.apps/05.customapps/customapps.md b/pages/02.administer/15.admin_guide/30.apps/05.customapps/customapps.md new file mode 100644 index 00000000..94b8dc5e --- /dev/null +++ b/pages/02.administer/15.admin_guide/30.apps/05.customapps/customapps.md @@ -0,0 +1,32 @@ +--- +title: Installing "custom" apps +template: docs +taxonomy: + category: docs +routes: + default: '/custom_apps' +--- + +While YunoHost has many apps available in the catalog, you may want to install apps that are not available in the official catalog, or setup your very own website that you crafted using HTML / CSS / PHP .. + +## Installing your very own webapp + +A special application exists called "Custom webapp" or "My webapp" : + +It can be seen as "an empty shell" in which you can drop your own HTML, CSS, JS, etc files through SFTP or other means. It also supports PHP, and an SQL database can be initialized. + +## Adding a reverse proxy to an app that you manually installed, for example using Docker + +While YunoHost apps do not use Docker for reasons that are beyond the scope of this page, you can manually install Docker apps on your server (assuming you know what you do and won't tinker too much the base system ...). However, this is not limiter to Docker, you may have deployed "manually" an app using Python, Ruby or other language, and such app usually listen to a specific port. + +Once your app or container is setup, you will probably need to actually *expose* the container on the web on a specific URL. This can be done using another special app called Redirect (which could also be called ... Reverse proxy) : + +Make sure to chose the reverse proxy mode, and point it to something like `http://127.0.0.1:PORT` where `PORT` is the port of your custom app. + +It will add the appropriate configuration bits in Nginx, SSOwat and a tile in the user portal. + +## Adding a custom tile in the portal pointing to an external app + +The Redirect app () can also be used add a "shortcut" tile in the user portal that points to an app or page located on a completly different server. Make sure to use the "explicit redirect" mode and the URL of the external page or app. + +Generally, you should refrain from manually tinkering and installing apps, except if you are sure they will not interfere with your server. YunoHost proposes two generic apps to help you out: diff --git a/pages/02.administer/15.admin_guide/35.nginx/nginx.md b/pages/02.administer/15.admin_guide/35.nginx/nginx.md deleted file mode 100644 index e1891fc5..00000000 --- a/pages/02.administer/15.admin_guide/35.nginx/nginx.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Web server with NGINX -template: docs -taxonomy: - category: docs -routes: - default: '/web_server' ---- - -YunoHost ships [NGINX](https://www.nginx.com/), a web server and reverse proxy software. That's the keystone that enables your apps and YunoHost services to be accessible online. - -Most of the web applications installed with YunoHost will automatically have their own configuration file created for NGINX. - -## Manually installing apps, or exposing existing apps - -Generally, you should refrain from manually tinkering and installing apps, except if you are sure they will not interfere with your server. YunoHost proposes two generic apps to help you out: - -- If you already have a website ready to be deployed, consider using a **Custom Webapp**. It allows you to easily setup a directory into which you can upload your HTML, PHP, CSS, JS files with SFTP, and a database if needed. -- If you want to use YunoHost as a reverse proxy, i.e. serve an app from another server or an internal web server (think NodeJS, Ruby, Python, ...), you can use the **Redirect app** in proxy mode. -- The **Redirect app** can also simply run in redirect mode, for example to create shortcuts for your users in their SSO page, or redirect `www.yourdomain.tld` to `yourdomain.tld`. - -For more information on these apps, and for more application use cases, have a look to the [Tutorials](/tutorials) section. - -!! Do not try to install Apache or other public web servers. This will break your system. diff --git a/pages/02.administer/15.admin_guide/55.upgrade/10.stretch_buster_migration/stretch_buster_migration.fr.md b/pages/02.administer/15.admin_guide/55.upgrade/10.stretch_buster_migration/stretch_buster_migration.fr.md deleted file mode 100644 index b308c36c..00000000 --- a/pages/02.administer/15.admin_guide/55.upgrade/10.stretch_buster_migration/stretch_buster_migration.fr.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Migrer de 3.x vers 4.x -template: docs -taxonomy: - category: docs -routes: - default: '/stretch_buster_migration' ---- - -L'objectif cette page est de décrire le processus de migration d'une instance en YunoHost 3.8.x (tournant sous Debian Stretch/9.x) vers YunoHost 4.x (tournant sous Debian Buster/10.x) - -## Notes importantes - -- L'équipe de YunoHost a fait de son mieux pour que cette migration se passe autant en douceur que possible. Elle a été testée durant plusieurs mois et sur plusieurs types d'installations. - -- Néanmoins, vous devez être conscient qu'il s'agit d'une opération délicate. L'administration système est un sujet compliqué et couvrir tous les cas particuliers n'est pas chose aisée. En conséquence, si vous hébergez des données et des systèmes critiques, [faites des sauvegardes](/backup). Et dans tous les cas, soyez patients et attentifs durant la migration. - -- Ne vous précipitez pas à vouloir faire une réinstallation de votre système en pensant que cela serait "plus simple" (sigh). (Une attitude qui revient régulièrement est de vouloir réinstaller son système à la moindre complication...). À la place, si vous rencontrez des problèmes, nous vous encourageons à investiguer, chercher à comprendre et [trouver de l'aide sur le chat ou le forum](/help). - -## Procédure de migration - -### Depuis la webadmin - -Après avoir mis à jour vers la version en 3.8.5.x, allez dans Outils > Migrations pour accéder à l'interface de migration. Il vous faudra ensuite lire l'avertissement attentivement et l'accepter pour lancer la migration. - -### Depuis la ligne de commande - -Après avoir mis à jour vers la version 3.8.5.x, lancez : - -```bash -sudo yunohost tools migrations migrate -``` - -puis lisez attentivement l'avertissement et les instructions. - -## Pendant la migration - -En fonction de votre matériel et des paquets installés, la migration peut prendre jusqu'à une ou deux heures. - -Les logs seront affichés dans la barre de message en haut (vous pouvez approcher la souris dessus pour voir l'historique en entier). Ils seront également consultable après coup (comme les autres opérations) dans Outils > Journaux. - -Notez que même si vous fermez la page d'admin, la migration continuera (par contre l'interface d'admin sera partiellement indisponible). - -### Si la migration a crashé / échoué à un moment - -Si la migration a échoué a un moment donné, la première chose à faire est de tenter de la relancer. Si cela ne fonctionne toujours pas, il vous faut [trouver de l'aide](/help) (prière de fournir le/les messages correspondants ou tout élément qui vous fait penser que ça n'a pas marché). - -## Choses à vérifier après la migration - -### Vérifiez que vous êtes véritablement sous Debian Buster / YunoHost 4.x - -Pour cela, vous pouvez aller dans la partie Diagnostic (section Système de base). (Vous pouvez aussi regarder ce qui est affiché à droite dans le pied de page de la webadmin). En ligne de commande, vous pouvez aussi utiliser `lsb_release -a` et `yunohost --version`. - -### Vérifiez que le diagnostic ne rapporte pas de problème particulier - -Également dans la section Diagnostic de la webadmin, vérifiez qu'il n'y a pas de problème apparu suite à la migration (par exemple un service qui ne tournerais plus...) - -### Vérifiez que les applications fonctionnent - -Vérifiez que vos applications installées fonctionnent... Si elles ne fonctionnent pas, il est recommandé de tenter de les mettre à jour. (ou bien de manière générale, il est recommandé de les mettre à jour même si elles fonctionnent !). - -## Soucis (mineurs) connus après la migration - -- Quelques fichiers de configurations (`/etc/nsswitch.conf` et `/etc/nslcd.conf`) apparaîtrons comme manuellement modifiés. Vous pouvez appliquer la regen-conf en toute sécurité pour régler le problème avec la commande: - -```bash -yunohost tools regen-conf nsswitch nslcd --force -``` - -(nous allons essayer de corriger ceci automatiquement) - -- Il se peut que la migration postgresql (censée s'effectuer automatiquement après la migration à Buster) ne fonctionne pas correctement... Certains utilisateurs ont rapporté que relancer la migration suffisait à résoudre le problème. (Nous allons voir pour comprendre et corriger ce soucis) diff --git a/pages/02.administer/15.admin_guide/55.upgrade/10.stretch_buster_migration/stretch_buster_migration.md b/pages/02.administer/15.admin_guide/55.upgrade/10.stretch_buster_migration/stretch_buster_migration.md deleted file mode 100644 index e7498578..00000000 --- a/pages/02.administer/15.admin_guide/55.upgrade/10.stretch_buster_migration/stretch_buster_migration.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Migrating from 3.x to 4.x -template: docs -taxonomy: - category: docs -routes: - default: '/stretch_buster_migration' ---- - -This page is dedicated to help you migrating an instance from YunoHost 3.8.x (running on Debian Stretch/9.x) to YunoHost 4.x (running on Debian Buster/10.x). - -## Important notes - -- The YunoHost team did its best to make sure that the migration is as smooth as possible and was tested over the course of several months in several cases. - -- With that said, please be aware that this is a delicate operation. System administration is a complicated topic and covering every particular cases is quite hard. Therefore, if you host critical data and services, please [make backups](/backup). And in any case, be patient and attentive during the migration. - -- Please don't rush into thinking that you should need to reinstall your system from scratch thinking it would be "simpler" (sigh). (A common attitude is to be willing to reinstall a server at the slightest complication...) Instead, if you happen to run into issues, we encourage you to try to investigate and understand what's going on and [reach for help on the chat and the forum](/help). - -## Migration procedure - -### From the webadmin - -After upgrading to 3.8.5.x, go to Tools > Migrations to access the migrations interface. You will have to read carefully and accept the disclaimer then launch the migration. - -### From the command line - -After upgrading to 3.8.5.x, run: - -```bash -sudo yunohost tools migrations migrate -``` - -then read carefully and accept the disclaimer. - -## During the migration - -Depending on your hardware and packages installed, the migration might take up to a few hours. - -The logs will be shown in the message bar (you can hover it to see the whole history). They will also be available after the migration (like any other operations) in Tools > Logs. - -Note that even if you close the webadmin page for some reason, the migration will continue in the background (but the webadmin will be partially unavailable). - -### If the migration crashed / failed at some point - -If the migration failed at some point, it should be possible to relaunch it. If it still doesn't work, you can try to [get help](/help) (please provide the corresponding messages or whatever makes you tell that it's not working). - -## What to do after the upgrade - -### Check that you actually are on Debian Buster and YunoHost 4.x - -For this, go in Diagnosis (category Base system) or look at the footer of the webadmin. In the command line, you can use `lsb_release -a` and `yunohost --version`. - -### Check that no issue appeared in the diagnosis - -Also in the Diagnosis in the webadmin, make sure that no specific issue appeared after running the migration (for example a service that crashed for some reason). - -### Check that your applications are working - -Test that your applications are working. If they aren't, you should try to upgrade them (it is also a good idea to upgrade them even if they are working anyway). - -## Current known (minor) issues after the migration - -- Some file (`/etc/nsswitch.conf` and `/etc/nslcd.conf`) will appear as manually modified after the migration. You can safely apply the regen-conf with: - -```bash -yunohost tools regen-conf nsswitch nslcd --force -``` - -(we will try to do this automatically somehow) - -- Sometimes the postgresql migration (that is supposed to happen automatically after the buster migration is ran) fails to run properly... Some users reported that re-launching manually the postgresql migration fixed the issue (we will try to understand and fix this somehow) diff --git a/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.fr.md b/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.fr.md deleted file mode 100644 index 92d2fbdf..00000000 --- a/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.fr.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Migrer de 2.4+ vers 3.x -template: docs -taxonomy: - category: docs -routes: - default: '/jessie_stretch_migration' ---- - -L'objectif cette page est de décrire le processus de migration d'une instance en YunoHost 2.7.x (tournant sous Debian Jessie/8.x) vers YunoHost 3.0 (tournant sous Debian Stretch/9.x) - -## Notes importantes - -- L'équipe de YunoHost a fait de son mieux pour que cette migration se passe autant en douceur que possible. Elle a été testée durant plusieurs mois et sur plusieurs types d'installations. - -- Néanmoins, vous devez être conscient qu'il s'agit d'une opération délicate. L'administration système est un sujet compliqué et couvrir tous les cas particuliers n'est pas chose aisée. En conséquence, si vous hébergez des données et des systèmes critiques, [faites des sauvegardes](/backup). Et dans tous les cas, soyez patients et attentifs durant la migration. - -- Cependant, ne vous précipitez pas non plus à vouloir faire une réinstallation de votre système. Une attitude qui revient régulièrement est de vouloir réinstaller son système à la moindre complication. Pourtant, réinstaller peut aussi s'avérer compliqué. À la place, si vous rencontrez des problèmes, nous vous encourageons à investiguer, chercher à comprendre et trouver de l'aide, plutôt que de se précipiter à vouloir réinstaller simplement parce que cela semble plus simple. - -- Si vous ou vos utilisateurs utilisez des clients emails externes (typiquement Thunderbird ou K9Mail) : le port SMTP a changé. Il s'agissait auparavant du port 465 (avec SSL/TLS) qui a été remplacé par 587 (STARTTLS). Voir [cette page de doc dédiée à la configuration des clients mails](/email_configure_client). La configuration des webmails comme Rainloop doit également être mise à jour, en passant par l'interface d'administration dédiée. - -- Pour les utilisateurs avancés : si vous avez des scripts personnels pour faire des backups, certains changements cassent (de façon mineure) la rétrocompatibilité de la ligne de commande. Les options dépréciées `--hooks`/`--ignore-hooks` ont été enlevées, ainsi que `--ignore-apps`, `--ignore-system`. Pour rendre les choses plus intuitives, `yunohost backup create --apps wordpress` (par exemple) créera uniquement un backup de wordpress, c.-à-d. pas besoin d'ajouter `--ignore-system` pour ne pas backuper le système. - -## Procédure de migration - -### Depuis la webadmin - -Après avoir mis à jour vers la version 2.7.14, allez dans Outils > Migrations pour accéder à l'interface de migration. Il vous faudra ensuite lire l'avertissement attentivement et l'accepter pour lancer la migration. Les logs seront affichés dans la barre de message en haut (vous pouvez approcher la souris dessus pour voir l'historique en entier). - -### Depuis la ligne de commande - -Après avoir mis à jour vers la version 2.7.14, lancez : - -```bash -sudo yunohost tools migrations migrate -``` - -puis lisez attentivement l'avertissement et les instructions. - -## Pendant la migration - -En fonction de votre matériel et des paquets installés, la migration peut prendre jusqu'à quelques heures. - -Notez qu'il est attendu de voir certaines erreurs (en particulier à propos de Fail2Ban) pendant la migration - ne vous en inquiétez pas trop. - -### Si la migration a crashé / échoué à un moment - -Si la migration a échoué a un moment donné, la première chose à faire est de tenter de la relancer. Si cela ne fonctionne toujours pas, il vous faut [trouver de l'aide](/help) (prière de fournir le/les messages correspondants ou tout élément qui vous fait penser que ça n'a pas marché). - -## Choses à vérifier après la migration - -### Vérifiez que vous êtes véritablement sous Debian Stretch / YunoHost 3.0 - -Pour cela, allez dans Outils > Diagnostique. (Vous pouvez aussi regarder ce qui est affiché dans le pied de page). En ligne de commande, vous pouvez aussi utiliser `lsb_release -a` et `yunohost --version`. - -### Vérifiez que Fail2Ban et le pare-feu sont actifs - -Vous devriez voir que Fail2Ban et le firewall sont actifs. Depuis la webadmin, dans Services (chercher `fail2ban` et `yunohost-firewall`). Depuis la ligne de commande, faites `yunohost service status fail2ban yunohost-firewall` : les deux devraient être en `active: active`. - -### Vérifiez que les applications fonctionnent - -Vérifiez que vos applications installées fonctionnent... Si elles ne fonctionnent pas, il est recommandé de tenter de les mettre à jour. (ou bien de manière générale, il est recommandé de les mettre à jour même si elles fonctionnent !). - -### Si vous utilisez les mails : vérifiez votre score - -Si vous utilisez les emails (en particulier les envois), vérifiez que votre score est toujours bon via [mail-tester](https://www.mail-tester.com/) par exemple. diff --git a/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.md b/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.md deleted file mode 100644 index fde3c32f..00000000 --- a/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Migrating from 2.4+ to 3.x -template: docs -taxonomy: - category: docs -routes: - default: '/jessie_stretch_migration' ---- - -This page is dedicated to help you migrating an instance from YunoHost 2.7.x (running on Debian Jessie/8.x) to YunoHost 3.0 (running on Debian Stretch/9.x). - -## Important notes - -- The YunoHost team did its best to make sure that the migration is as smooth as possible and was tested over the course of several months in several cases. - -- With that said, please be aware that this is a delicate operation. System administration is a complicated topic and covering every particular cases is quite hard. Therefore, if you host critical data and services, please [make backups](/backup). And in any case, be patient and attentive during the migration. - -- Yet, please don't rush into thinking that you should rush into reinstalling your system. A common "mistake" is to be willing to reinstall a server at the slightest complication. But turns out that reinstalling a system can also be complicated. Instead, if you happen to run into issues, we encourage you to try to investigate and understand what's going on and reach for help instead of just throwing away everything because it looks simpler. - -- About external email clients: if you or your users are using external email clients (typically Thunderbird, K9Mail...) be aware that the SMTP port changed from 465 (with SSL/TLS) to 587 (STARTTLS). See [this page of doc dedicated to email clients](/email_configure_client). Webmail configurations such as Rainloop should also be updated using the corresponding administration interface. - -- For advanced users: if you have some custom scripts for backups, be aware that we made some backward-incompatible changes in the backup command line. The deprecated `--hooks`/`--ignore-hooks` options were removed, as well as the options `--ignore-apps`, `--ignore-system`. To make things more intuitive, `yunohost backup create --apps wordpress` (for example) will only backup wordpress, i.e. you don't have to add `--ignore-system` to not backup the system. - -## Migration procedure - -### From the webadmin - -After upgrading to 2.7.14, go to Tools > Migrations to access the migrations interface. You will have to read carefully and accept the disclaimer then launch the migration. The logs will be shown in the message bar (you can hover it to see the whole history). - -### From the command line - -After upgrading to 2.7.14, run: - -```bash -sudo yunohost tools migrations migrate -``` - -then read carefully and accept the disclaimer. - -## During the migration - -Depending on your hardware and packages installed, the migration might take up to a few hours. - -Note that it is expected to see some errors (in particular about Fail2Ban) during the migration, so don't worry too much about them. - -### If the migration crashed / failed at some point - -If the migration failed at some point, it should be possible to relaunch it. If it still doesn't work, you can try to [get help](/help) (please provide the corresponding messages or whatever makes you tell that it's not working). - -## What to do after the upgrade - -### Check that you actually are on Debian Stretch and YunoHost 3.0 - -You should be able to see this from the webadmin Tools > Diagnosis, and also in the footer of the page. On the command line, you can use `lsb_release -a` and `yunohost --version`. - -### Check that Fail2Ban and the firewall are active - -You should be able to see that Fail2Ban and the firewall are active. From the webadmin in Services (look for `fail2ban` and `yunohost-firewall`). From the command line, run `yunohost service status fail2ban yunohost-firewall`. They should both have `active: active`. - -### Check that your applications are working - -Test that your applications are working. If they aren't, you should try to upgrade them (it is also a good idea to upgrade them even if they are working anyway). - -### Mail users: check your mail score - -If you are using mails (especially sending them), check that your score is still good by using [mail-tester](https://www.mail-tester.com/) for example. diff --git a/pages/02.administer/15.admin_guide/55.upgrade/upgrade.md b/pages/02.administer/15.admin_guide/55.upgrade/upgrade.md index 05f4e021..a689c11c 100644 --- a/pages/02.administer/15.admin_guide/55.upgrade/upgrade.md +++ b/pages/02.administer/15.admin_guide/55.upgrade/upgrade.md @@ -32,7 +32,3 @@ yunohost tools upgrade apps # Upgrade a specific application yunohost app upgrade wordpress ``` - -!! If you are upgrading from YunoHost below v4.2.2, `system` and `apps` were flags of the command. Add `--` before them: -!! `yunohost tools upgrade --system` -!! `yunohost tools upgrade --apps` diff --git a/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.fr.md b/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.fr.md deleted file mode 100644 index 2ec15e89..00000000 --- a/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.fr.md +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: BorgBackup -template: docs -taxonomy: - category: docs -routes: - default: '/backup/borgbackup' -page-toc: - active: true - depth: 3 ---- - -YunoHost propose un couple d'applications pour [BorgBackup](https://www.borgbackup.org/). - -## Fonctionnalité - -Cette application propose: - -- la sauvegarde des données sur un disque externe ou sur un dépôt borg distant -- la déduplication et la compression des fichiers ce qui permet de conserver de nombreuses copies antérieures -- le chiffrement des données, ce qui permet de pouvoir stocker chez un tiers -- de définir finement la fréquence et le type de données à sauvegarder -- un système d'alerte mail en cas de défaut de sauvegarde. - -Il existe des [fournisseurs de dépôts borg distants](https://www.borgbackup.org/support/commercial.html), il est également possible de créer son propre dépôt sur un autre YunoHost avec l'[application borgserver](https://github.com/YunoHost-Apps/borgserver_ynh). - -La future méthode de sauvegarde intégrée par défaut dans YunoHost sera basée sur ce logiciel. - -## Mise en place de la sauvegarde - -!!! Pour la mise en place, il faut d'abord installer l'[application borg](https://github.com/YunoHost-Apps/borg_ynh), puis éventuellement l'[application borgserver](https://github.com/YunoHost-Apps/borgserver_ynh). - -## Tester - -Avec les apps borg un email est envoyé pour dire si la sauvegarde échoue ou si le repo distant n'a rien reçu. On peut toutefois analyser manuellement pour s'assurer que tout va bien de façon plus complète. - -```bash -# Lister les fichiers -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg list "$(yunohost app setting $app repository)" | less - -# Lister les exports de base de données -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg list "$(yunohost app setting $app repository)" | grep "(db|dump)\.sql" - -# Lister les fichiers de l'archive -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg list "$(yunohost app setting $app repository)::ARCHIVE" | less - -# Voir les infos de l'archive -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg info "$(yunohost app setting $app repository)::ARCHIVE" - -# Vérifier l'intégrité des données -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg check "$(yunohost app setting $app repository)::ARCHIVE" --verify-data -``` - -## Restaurer - -Si on est dans le cas d'une migration ou d'une réinstallation, il faut réinstaller borg de la même façon. Si le repo est distant il faut changer la clé publique. - -Lister les archives disponibles - -```bash -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg list "$(yunohost app setting $app repository)" -``` - -Créer les archives tar (une archive par app et partie de système) - -```bash -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg export-tar "$(yunohost app setting $app repository)::ARCHIVE" /home/yunohost.backup/archives/ARCHIVE.tar -``` - -Puis restaurer l'archive de façon classique. - -### Restaurer des grosses archives - -Si l'espace disponible est inférieur au poids de votre archive, des données décompressées et des dépendances, vous devrez restaurer partie par partie, app par app. - -Si restaurer app par app ne suffit pas OU si une archive est trop grosse, il peut être judicieux de générer une archive tar sans les "grosses" données d'une app comme si elle avait été générée avec l'[option BACKUP_CORE_ONLY](/backup/include_exclude_files#ne-pas-sauvegarder-les-grosses-quantites-de-donnees). Exemple avec Nextcloud: - -```bash -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg export-tar -e apps/nextcloud/backup/home/yunohost.app "$(yunohost app setting $app repository)::ARCHIVE" /home/yunohost/archives/ARCHIVE.tar -``` - -Il faudra ensuite extraire ces données directement avec borg - -```bash -cd /home/yunohost.app/ -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg extract "$(yunohost app setting $app repository)::ARCHIVE" apps/nextcloud/backup/home/yunohost.app/ -mv apps/nextcloud/backup/home/yunohost.app/nextcloud ./ -rm -r apps -``` - -Puis restaurer de façon classique diff --git a/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.it.md b/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.it.md deleted file mode 100644 index f5563a63..00000000 --- a/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.it.md +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: BorgBackup -template: docs -taxonomy: - category: docs -routes: - default: '/backup/borgbackup' -page-toc: - active: true - depth: 3 ---- - -YunoHost propone due programmi per [BorgBackup](https://www.borgbackup.org/). - -## Funzionalità - -con BorgBackup potrete: - -- effettuare il backup dei dati in un HD esterno o in un repository borg remoto -- deduplicare e comprimere i file, che permette di mantenere molte versioni precedenti -- la cifratura dei dati, permettendo così di conservare in modo sicuro i file presso soggetti terzi -- definire i tipi di dati da copiare e la frequenza di backup -- ricevere una mail di allerta in caso di fallimento del backup - -Oltre ai [fornitori terzi di repository](https://www.borgbackup.org/support/commercial.html), vi è la possibilità di hostare il proprio repository su una differente installazione YunoHost con installata l'[applicazione borgserver](https://github.com/YunoHost-Apps/borgserver_ynh). - -Il futuro metodo di backup integrato in YunoHost sarà basato su BorgBackup - -## Pianificazione del backup - -!!! Installate l'[applicazione borg](https://github.com/YunoHost-Apps/borg_ynh), ed eventualmente l'[applicazione borgserver](https://github.com/YunoHost-Apps/borgserver_ynh). - -## Test - -Con il programma borg una mail viene inviata nel caso la sessione di backup fallisca o nel caso il repository di destinazione non riceva nessun dato. Da terminale possiamo controllare nei minimi dettagli, che tutto funzioni. - -```bash -# Elencare i files -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg list "$(yunohost app setting $app repository)" | less - -# Elencare le esportazioni del database -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg list "$(yunohost app setting $app repository)" | grep "(db|dump)\.sql" - -# Elencare i file contenuti nell'archivio -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg list "$(yunohost app setting $app repository)::ARCHIVE" | less - -# Ottenere informazioni sull'archivio -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg info "$(yunohost app setting $app repository)::ARCHIVE" - -# Verificare l'integrità dei dati -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg check "$(yunohost app setting $app repository)::ARCHIVE" --verify-data -``` - -## Ripristino - -Se effettuiamo il ripristino dopo una migrazione o una reinstallazione dobbiamo reinstallare borg nello stessa maniera. Se il repository si trova in un server remoto bisogna cambiare la chiave pubblica. - -Elencare gli archivi disponibili - -```bash -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg list "$(yunohost app setting $app repository)" -``` - -Creare gli archivi tar (uno per ogni applicazione e componente del sistema) - -```bash -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg export-tar "$(yunohost app setting $app repository)::ARCHIVE" /home/yunohost/archives/ARCHIVE.tar -``` - -In seguito ripristinare l'archivio come di consueto. - -### Ripristino di archivi di grandi dimensioni - -Se lo spazio disponibile è inferiore alla dimensione del vostro archivio, dei dati scompattati e delle dipendenze, dovrete ripristinare un'applicazione alla volta. - -Se il ripristino non riesce o se un archivio è troppo grande, è più prudente creare un archivio tar senza la parte più grande dei dati, cioè come se l'archivio fosse stato creato con l'[opzione BACKUP_CORE_ONLY](/backup/include_exclude_files#don't-save-large-quantities-of-data). Di seguito un esempio con Nextcloud: - -```bash -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg export-tar -e apps/nextcloud/backup/home/yunohost.app "$(yunohost app setting $app repository)::ARCHIVE" /home/yunohost/archives/ARCHIVE.tar -``` - -In seguito si estrarranno questi dati direttamente con borg - -```bash -cd /home/yunohost.app/ -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg extract "$(yunohost app setting $app repository)::ARCHIVE" apps/nextcloud/backup/home/yunohost.app/ -mv apps/nextcloud/backup/home/yunohost.app/nextcloud ./ -rm -r apps -``` - - Procedere poi con il consueto metodo di ripristino diff --git a/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.md b/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.md deleted file mode 100644 index 02e48465..00000000 --- a/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.md +++ /dev/null @@ -1,102 +0,0 @@ ---- -title: BorgBackup -template: docs -taxonomy: - category: docs -routes: - default: '/backup/borgbackup' -page-toc: - active: true - depth: 3 ---- - -YunoHost offers a couple of applications for [BorgBackup](https://www.borgbackup.org/). - -## Functionality - -This application offers: - -- backup of data on an external disk or on a remote Borg repository -- deduplication and compression of files, which allows to keep many previous copies -- data encryption, which allows you to store data with a third party -- to define the frequency and type of data to be backed up -- a mail alert system in case of backup failure. - -There are [remote borg repository providers](https://www.borgbackup.org/support/commercial.html), it is also possible to create your own repository on another YunoHost with the [borgserver application](https://github.com/YunoHost-Apps/borgserver_ynh). - -The future default backup method integrated in YunoHost will be based on this software. - -## Setting up the backup - -!!! To set up, first install the [borg application](https://github.com/YunoHost-Apps/borg_ynh), then optionally the [borgserver application](https://github.com/YunoHost-Apps/borgserver_ynh). - -## Finding the borg command - -The `borg` command is found inside the installation directory of the app. You should generaly prefer using this executable rather than the one installed by Debian's package, to ensure compatibility. - -```bash -# Get the path to the borg executable -alias borg="$(yunohost app setting $app install_dir)/venv/bin/borg" -``` - -The rest of this documentation assumes this alias is present in your shell, or that you added the venv in your PATH. - -## Test - -With the borg apps an email is sent to say if the backup fails or if the remote repo has received nothing. However, you can manually test to make sure everything is fine in a more complete way. - -```bash -# List files -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " "$borg" list "$(yunohost app setting $app repository)" | less - -# List database exports -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " "$borg" list "$(yunohost app setting $app repository)" | grep "(db|dump)\.sql" - -# List files from the archive -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " "$borg" list "$(yunohost app setting $app repository)::ARCHIVE" | less - -# View archive info -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " "$borg" info "$(yunohost app setting $app repository)::ARCHIVE" - -# Verify data integrity -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " "$borg" check "$(yunohost app setting $app repository)::ARCHIVE" --verify-data -``` - -## Restore - -If we are in the case of a migration or a reinstallation, we must reinstall borg in the same way. If the repo is remote you have to change the public key. - -List the available archives - -```bash -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " "$borg" list "$(yunohost app setting $app repository)" -``` - -Create tar archives (one archive per app and system part) - -```bash -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " "$borg" export-tar "$(yunohost app setting $app repository)::ARCHIVE" /home/yunohost/archives/ARCHIVE.tar -``` - -Then restore the archive in the usual way. - -### Restore large archives - -If the available space is less than the weight of your archive, decompressed data and dependencies, you will have to restore part by part, app by app. - -If restoring app by app is not enough OR if an archive is too big, it may be a good idea to generate a tarball without the "big" data of an app as if it had been generated with the [BACKUP_CORE_ONLY option](/backup/include_exclude_files#don't-save-large-quantities-of-data). Example with Nextcloud: - -```bash -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " "$borg" export-tar -e apps/nextcloud/backup/home/yunohost.app "$(yunohost app setting $app repository)::ARCHIVE" /home/yunohost.backup/archives/ARCHIVE.tar -``` - -You will then have to extract these data directly with borg - -```bash -cd /home/yunohost.app/ -app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " "$borg" extract "$(yunohost app setting $app repository)::ARCHIVE" apps/nextcloud/backup/home/yunohost.app/ -mv apps/nextcloud/backup/home/yunohost.app/nextcloud ./ -rm -r apps -``` - -Then restore in the classic way diff --git a/pages/02.administer/20.backups/10.backup_methods/02.restic/restic.fr.md b/pages/02.administer/20.backups/10.backup_methods/02.restic/restic.fr.md deleted file mode 100644 index d096cc15..00000000 --- a/pages/02.administer/20.backups/10.backup_methods/02.restic/restic.fr.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Restic -template: docs -taxonomy: - category: docs -routes: - default: '/backup/restic' -page-toc: - active: true - depth: 3 ---- - -## Fonctionnalité - -Cette application propose: - -- la sauvegarde des données sur un stockage distant (support de différents types de stockage) -- la déduplication et la compression des fichiers ce qui permet de conserver de nombreuses copies antérieures -- le chiffrement des données, ce qui permet de pouvoir stocker chez un tiers - -Le paquet permet aussi de définir finement la fréquence et le type de données à sauvegarder et intègre un système d'alerte mail en cas de défaut de sauvegarde. diff --git a/pages/02.administer/20.backups/10.backup_methods/02.restic/restic.it.md b/pages/02.administer/20.backups/10.backup_methods/02.restic/restic.it.md deleted file mode 100644 index 9108e0bc..00000000 --- a/pages/02.administer/20.backups/10.backup_methods/02.restic/restic.it.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Restic -template: docs -taxonomy: - category: docs -routes: - default: '/backup/restic' -page-toc: - active: true - depth: 3 ---- - -## Funzionalità - -Questa applicazione permette: - -- il backup dei dati in rete (compatibile con diverse modalità di stoccaggio dei dati) -- deduplicare e comprimere i file, permettendo di mantenere molte copie precedenti -- la cifratura dei dati, permettendo così di conservare in modo sicuro i file presso soggetti terzi - -Il programma permette di configurare con precisione i dati che devono essere salvati e la frequenza dei backup, e comprende un sistema di allerta via mail nel caso di fallimento nell'esecuzione del backup diff --git a/pages/02.administer/20.backups/10.backup_methods/02.restic/restic.md b/pages/02.administer/20.backups/10.backup_methods/02.restic/restic.md deleted file mode 100644 index 97fe4df4..00000000 --- a/pages/02.administer/20.backups/10.backup_methods/02.restic/restic.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Restic -template: docs -taxonomy: - category: docs -routes: - default: '/backup/restic' -page-toc: - active: true - depth: 3 ---- - -## Functionality - -This application offers: - -- backup of data to remote storage (support for different types of storage) -- deduplication and compression of files, which makes it possible to keep many previous copies -- data encryption, which allows to store data at a third party - -The package also allows you to finely define the frequency and type of data to be backed up and integrates an email alert system in case of backup failure. diff --git a/pages/02.administer/20.backups/10.backup_methods/03.archivist/archivist.fr.md b/pages/02.administer/20.backups/10.backup_methods/03.archivist/archivist.fr.md deleted file mode 100644 index c8f25f72..00000000 --- a/pages/02.administer/20.backups/10.backup_methods/03.archivist/archivist.fr.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: Archivist -template: docs -taxonomy: - category: docs -routes: - default: '/backup/archivist' -page-toc: - active: true - depth: 3 ---- - -## Fonctionnalité - -Cette application se base sur rsync et GPG, elle propose: - -- la sauvegarde des données sur un stockage distant (support de différents types de stockage) -- le chiffrement des données, ce qui permet de pouvoir stocker chez un tiers - -Le paquet permet aussi de définir finement la fréquence et le type de données à sauvegarder et intègre un système d'alerte mail en cas de défaut de sauvegarde. - -Pour plus d'information : diff --git a/pages/02.administer/20.backups/10.backup_methods/03.archivist/archivist.md b/pages/02.administer/20.backups/10.backup_methods/03.archivist/archivist.md deleted file mode 100644 index e4b3d96e..00000000 --- a/pages/02.administer/20.backups/10.backup_methods/03.archivist/archivist.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: Archivist -template: docs -taxonomy: - category: docs -routes: - default: '/backup/archivist' -page-toc: - active: true - depth: 3 ---- - -## Functionality - -This application is based on rsync and GPG, it offers: - -- backup of data on a remote storage (support for different types of storage) -- data encryption, which allows to store data at a third party - -The package also allows you to finely define the frequency and type of data to be backed up and integrates an email alert system in case of backup failure. - -For more information: diff --git a/pages/02.administer/20.backups/10.backup_methods/backup_methods.md b/pages/02.administer/20.backups/10.backup_methods/backup_methods.md index daed09c2..d1957321 100644 --- a/pages/02.administer/20.backups/10.backup_methods/backup_methods.md +++ b/pages/02.administer/20.backups/10.backup_methods/backup_methods.md @@ -1,5 +1,5 @@ --- -title: Backup Methods +title: Backup methods template: docs taxonomy: category: docs @@ -10,28 +10,35 @@ page-toc: depth: 3 --- -## [BorgBackup](/borgbackup) +YunoHost currently has three apps integrating backup solutions offering more features than the simple ".tar" mechanism shipped in YunoHost, in particular automatic and remote backups. -This application offers: +## [BorgBackup](https://www.borgbackup.org/) (cf the [Borg "client"](https://apps.yunohost.org/app/borg) and [Borg "server"](https://apps.yunohost.org/app/borgserver) apps) - backup of data on an external disk or on a remote Borg repository -- deduplication and compression of files, which allows to keep many previous copies +- deduplication and compression of files, which makes it possible to keep many previous copies without too much storage overhead - data encryption, which allows you to store data with a third party - to define the frequency and type of data to be backed up - a mail alert system in case of backup failure. -## [Restic](/restic) +There are [remote borg repository providers](https://www.borgbackup.org/support/commercial.html), it is also possible to create your own repository on another YunoHost with the [borgserver application](https://github.com/YunoHost-Apps/borgserver_ynh). -This application offers: +## [Restic](https://restic.net/) (cf the [Restic app](https://apps.yunohost.org/app/restic)) -- backup of data to remote storage (support for different types of storage) -- deduplication and compression of files, which makes it possible to keep many previous copies +- backup of data to remote storage (support for different types of storage, inclusing S3 and SFTP) +- deduplication and compression of files, which makes it possible to keep many previous copies without too much storage overhead - data encryption, which allows to store data at a third party +- to define the frequency and type of data to be backed up +- a mail alert system in case of backup failure. -## [Archivist](/archivist) + +## [Archivist](https://apps.yunohost.org/app/archivist) !! This application is currently broken! -This application is based on rsync and GPG, it offers: +- based on rsync and GPG - backup of data on a remote storage (support for different types of storage) - data encryption, which allows to store data at a third party + +The package also allows you to finely define the frequency and type of data to be backed up and integrates an email alert system in case of backup failure. + +More info: diff --git a/pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.fr.md b/pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.fr.md index bdb8e3f2..3da959a4 100644 --- a/pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.fr.md +++ b/pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.fr.md @@ -1,5 +1,5 @@ --- -title: Créer une image du système +title: Créer une image complète du système de fichier template: docs taxonomy: category: docs @@ -10,8 +10,6 @@ page-toc: depth: 3 --- -!! Les images de cette page sont manquantes - L'outil de sauvegarde de YunoHost ne sauvegarde que les fichiers utiles et se base sur des scripts de restauration pour réinstaller les dépendances de vos applications. Autrement dit, le mécanisme de YunoHost revient à réinstaller, puis réincorporer les données. Réaliser des images complètes du système peut être un moyen complémentaire ou alternatif de sauvegarder votre machine. L'intérêt est que votre système pourra être restauré dans l'état exact du moment de la sauvegarde. diff --git a/pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.it.md b/pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.it.md index c2bd4b78..a2a40e60 100644 --- a/pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.it.md +++ b/pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.it.md @@ -1,5 +1,5 @@ --- -title: Create a filesystem image +title: Snapshotting the entire filesystem template: docs taxonomy: category: docs @@ -10,8 +10,6 @@ page-toc: depth: 3 --- -!! Images are missing on this page - Lo strumento di backup di YunoHost salva solamente i files utili e si basa su degli script di ripristino per reinstallare le dipendenze dei vostri programmi installati. In altre parole, il ripristino di YunoHost prevede in un primo tempo la reinstallazione del sistema e in seguito il ripristino dei dati. Realizzare un'immagine completa può essere un metodo, complementare o alternativo, per un backup del vostro server. Il vantaggio sta nel fatto che il vostro server può essere ripristinato nella stessa configurazione presente al momento del backup. diff --git a/pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.md b/pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.md index 9d32b1d1..b1e489a0 100644 --- a/pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.md +++ b/pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.md @@ -1,5 +1,5 @@ --- -title: Create a filesystem image +title: Snapshotting the entire filesystem template: docs taxonomy: category: docs @@ -10,15 +10,13 @@ page-toc: depth: 3 --- -!! Images are missing on this page - YunoHost's backup tool only backs up useful files and relies on restore scripts to reinstall the dependencies of your applications. In other words, YunoHost's mechanism amounts to reinstalling and then reincorporating the data. Making full system images can be a complementary or alternative way to backup your machine. The advantage is that your system can be restored to the exact state it was in at the time of the backup. Depending on your type of installation, you can either create a snapshot or clone the storage medium by removing it from your server (turned off). -## Trigger a snapshot +## Creating a snapshot A snapshot allows you to freeze an image of the file system. Snapshots are very useful when doing an update or testing, because they allow you to easily go back in case of a glitch. On the other hand, apart from some very high availability clusters, snapshots do not really protect you against hardware failures or disasters (cf. OVH fire in Strasbourg in 2021). diff --git a/pages/02.administer/20.backups/20.avoid_hardware_failure/avoid_hardware_failure.md b/pages/02.administer/20.backups/20.avoid_hardware_failure/avoid_hardware_failure.md index 30fe81e5..83e05b7c 100644 --- a/pages/02.administer/20.backups/20.avoid_hardware_failure/avoid_hardware_failure.md +++ b/pages/02.administer/20.backups/20.avoid_hardware_failure/avoid_hardware_failure.md @@ -1,10 +1,10 @@ --- -title: Avoid hardware failure +title: Prevent hardware failures template: docs taxonomy: category: docs routes: - default: '/backup/avoid_hardware_failure' + default: '/backup/prevent_hardware_failure' page-toc: active: true depth: 3 @@ -17,13 +17,13 @@ Very often people who self-host don't have proper storage for their system. Leav ## Secure your hard drives -Ideally, your hard disks should be fixed to avoid vibrations which can accelerate the wear of the equipment or even reduce its performance, especially if there is another disk next to it. +Ideally, your hard disks should be fixed to prevent vibrations which can accelerate the wear of the equipment or even reduce its performance, especially if there is another disk next to it. ## Reduce swapiness for SD cards and SSDs If you use a swap file with an SSD or SD card with too much swapiness, your storage media could give up the ghost prematurely due to too many writes. -To avoid this: +To prevent this: ```bash cat /proc/sys/vm/swappiness @@ -48,7 +48,7 @@ In order to limit hardware failures of storage media, it can be relevant to set There are also more advanced clusters that maximize fault tolerance (failure of 2 disks like RAID6) or storage (see RAID 5). -However, these disk clustering techniques should not be considered as backups. A RAID array should be considered as a single storage medium. Indeed, if this technique avoids having to reinstall in case of a probable disk crash, it is far from zero risk. +However, these disk clustering techniques should not be considered as backups. A RAID array should be considered as a single storage medium. Indeed, if this technique prevents having to reinstall in case of a probable disk crash, it is far from zero risk. Some examples of situations known to professional system administrators: diff --git a/pages/02.administer/15.admin_guide/50.backups/backup.fr.md b/pages/02.administer/20.backups/backups.fr.md similarity index 91% rename from pages/02.administer/15.admin_guide/50.backups/backup.fr.md rename to pages/02.administer/20.backups/backups.fr.md index d5e2b110..09321699 100644 --- a/pages/02.administer/15.admin_guide/50.backups/backup.fr.md +++ b/pages/02.administer/20.backups/backups.fr.md @@ -1,5 +1,5 @@ --- -title: Sauvegarder son serveur +title: Sauvegardes template: docs taxonomy: category: docs @@ -174,20 +174,3 @@ scp -P port_ssh /path/to/your/.tar admin@your.domain.tld:/home/yu [/ui-tab] [/ui-tabs] - -## Sauvegarde automatique ou distante - -Il existe 3 applications YunoHost qui proposent d'étendre YunoHost avec une méthode de sauvegarde automatisées. - -- [BorgBackup](/backup/borgbackup) -- [Restic](/backup/restic) -- [Archivist](/backup/archivist) - -## Aller plus loin - -- [Évaluer la qualité de sa sauvegarde](/backup/strategies) -- [Cloner son système de fichier](/backup/clone_filesystem) -- [Éviter une panne matérielle](/backup/avoid_hardware_failure) -- [Inclure/exclure des fichiers](/backup/include_exclude_files) -- [Méthodes personnalisées](/backup/custom_backup_methods) -- [Migrer ou fusionner des serveurs](/backup/migrate_or_merge_servers) diff --git a/pages/02.administer/15.admin_guide/50.backups/backup.it.md b/pages/02.administer/20.backups/backups.it.md similarity index 99% rename from pages/02.administer/15.admin_guide/50.backups/backup.it.md rename to pages/02.administer/20.backups/backups.it.md index 90bf638b..d3e45a67 100644 --- a/pages/02.administer/15.admin_guide/50.backups/backup.it.md +++ b/pages/02.administer/20.backups/backups.it.md @@ -1,5 +1,5 @@ --- -title: Eseguire il backup del vostro server e delle app +title: Backups template: docs taxonomy: category: docs diff --git a/pages/02.administer/15.admin_guide/50.backups/backup.md b/pages/02.administer/20.backups/backups.md similarity index 91% rename from pages/02.administer/15.admin_guide/50.backups/backup.md rename to pages/02.administer/20.backups/backups.md index 8bb9ae19..a58872f8 100644 --- a/pages/02.administer/15.admin_guide/50.backups/backup.md +++ b/pages/02.administer/20.backups/backups.md @@ -1,5 +1,5 @@ --- -title: Backing up your server +title: Backups template: docs taxonomy: category: docs @@ -11,8 +11,6 @@ In the context of self-hosting, backups are an important element to compensate f ## Manual backup -### Backup - YunoHost comes with a backup system, that allows you to backup (and restore) system configurations and data (e.g. emails) and apps if they support it. You can manage backups either from the command line (`yunohost backup --help`) or from the web administration (in the Backups section), though some features are not yet available in the webadmin. @@ -145,7 +143,7 @@ You can then run `yunohost backup restore ` (hence without its `.ta To restore an app, the domain on which it was installed should already be configured (or you need to restore the corresponding system configuration). You also cannot restore an app which is already installed... which means that to restore an old version of an app, you must first uninstall it. -#### Upload an archive +#### Uploading an archive In many cases, the archive is not on the server on which you want to restore it. So it has to be uploaded, which depending on its size can take more or less time. @@ -170,20 +168,3 @@ scp -P ssh_port /path/to/your/.tar admin@your.domain.tld:/home/yun [/ui-tab] [/ui-tabs] - -## Automatic or remote backup - -There are 3 YunoHost applications that offer to extend YunoHost with an automated backup method. - -- [BorgBackup](/backup/borgbackup) -- [Restic](/backup/restic) -- [Archivist](/backup/archivist) - -## Go further - -- [Evaluate the quality of your backup](/backup/strategies) -- [Clone your file system](/backup/clone_filesystem) -- [Avoid a hardware failure](/backup/avoid_hardware_failure) -- [Include/exclude files](/backup/include_exclude_files) -- [Custom methods](/backup/custom_backup_methods) -- [Migrate or merge servers](/backup/migrate_or_merge_servers) diff --git a/pages/02.administer/60.extend/15.theming/theming.fr.md b/pages/02.administer/45.tutorials/10.theming/theming.fr.md similarity index 100% rename from pages/02.administer/60.extend/15.theming/theming.fr.md rename to pages/02.administer/45.tutorials/10.theming/theming.fr.md diff --git a/pages/02.administer/60.extend/15.theming/theming.md b/pages/02.administer/45.tutorials/10.theming/theming.md similarity index 100% rename from pages/02.administer/60.extend/15.theming/theming.md rename to pages/02.administer/45.tutorials/10.theming/theming.md diff --git a/pages/02.administer/45.tutorials/tutorials.fr.md b/pages/02.administer/45.tutorials/tutorials.fr.md deleted file mode 100644 index 6114ccf7..00000000 --- a/pages/02.administer/45.tutorials/tutorials.fr.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Cas d'usage spécifiques -template: docs -taxonomy: - category: docs -routes: - default: '/tutorials' - aliases: - - '/specific_use_cases' ---- - -!! Cette section est en cours de réorganisation. diff --git a/pages/02.administer/45.tutorials/tutorials.md b/pages/02.administer/45.tutorials/tutorials.md deleted file mode 100644 index 13554b84..00000000 --- a/pages/02.administer/45.tutorials/tutorials.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Tutorials -template: docs -taxonomy: - category: docs -routes: - default: '/tutorials' - aliases: - - '/specific_use_cases' ---- - -!! This section is being reworked. diff --git a/pages/02.administer/50.troubleshooting/troubleshooting.fr.md b/pages/02.administer/50.troubleshooting/troubleshooting.fr.md index 3634e5c0..6d326012 100644 --- a/pages/02.administer/50.troubleshooting/troubleshooting.fr.md +++ b/pages/02.administer/50.troubleshooting/troubleshooting.fr.md @@ -7,18 +7,6 @@ routes: default: '/troubleshooting' --- -Voici quelques conseils généraux à suivre lorsque vous rencontrez des problèmes avec votre serveur. +Cette section contiens des informations pour régler des problèmes courants. -## 0. Ne paniquez pas - -Restez calme. La plupart des problèmes sont moins grave que ce que les débutants pensent. Pour l'amour de Dieu (ou de votre déité, animal, nourriture préférée), ne sautez pas à pieds joint dans la "spirate de réinstallation" en pensant que réinstaller à partir de zéro va magiquement résoudre vos problèmes. Réinstaller est une opération lourde et n'est pas une bonne stratégie sur le long-terme pour résoudre les problèmes. Vous finirez par vous lasser et n'apprendrez rien. - -## 1. Regardez sur le forum ou bugtrackers si quelqu'un a eu un problème similaire - -Cherchez dans [le forum](https://forum.yunohost.org) des fils de discussions qui discutent de choses similaire aux problème que vous rencontrez. Si vous avez un soucis lié à une application en particulier, vous pouvez également tenter de chercher un ticket similaire sur le bugtracker de l'application, par exemple [ici se trouve le bugtracker de l'app wordpress](https://github.com/YunoHost-Apps/wordpress_ynh/issues). - -## 2. Demandez de l'aide - -Soit sur [le forum](https://forum.yunohost.org) ou bien le chat : c.f. [cette page](/help) - -!!! POUR L'AMOUR DE DIEU, PRIÈRE DE fournir du contexte ! Les bénévoles ne peuvent PAS vous aider si vous ne prenez pas *cinq* petites minutes pour décrire votre contexte : quel type de hardware, quelle version de YunoHost, qu'est-ce que vous essayez de faire, ce qui s'est passé, et **les journaux (logs) correspondants**. +Si vous cherchez de l'aide, jetez un oeil au [forum](https://forum.yunohost.org/), au [salon de support](/chat_rooms), la [page d'aide](/help) et [comment demander de l'aide efficacement](/asking_for_help_efficiently) diff --git a/pages/02.administer/50.troubleshooting/troubleshooting.it.md b/pages/02.administer/50.troubleshooting/troubleshooting.it.md deleted file mode 100644 index fce8652d..00000000 --- a/pages/02.administer/50.troubleshooting/troubleshooting.it.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Soluzione dei problemi -template: docs -taxonomy: - category: docs -routes: - default: '/troubleshooting' ---- - -Di seguito alcuni consigli generali per risolvere problemi con il vostro server. - -## 0. Don't panic - -Mantenete la calma. La maggior parte dei problemi sono meno gravi di quanto pensa chi è alle prime armi. Per amor di Dio (o le vostre divinità preferite / animali / cibo), non cadete nella "spirale della reinstallazione" presupponendo che reinstallare il vostro server da capo possa risolvere magicamente i problemi. La reinstallazione è un'operazione gravosa e non è una buona strategia per risolvere i problemi. Ti stancherai e non imparerai niente. - -## 1. Cerca problemi simili nel forum o nei bugtrackers - -Cerca [nel forum](https://forum.yunohost.org) per argomenti simili al problema che stai trovando. Se hai problemi con una app specifica puoi consultare il bugtracker relativo, ad esempio [questo è il bugtracker per l'app Wordpress app](https://github.com/YunoHost-Apps/wordpress_ynh/issues). - -## 2. Chiedi aiuto - -Sia [sul forum](https://forum.yunohost.org) siaa nella chat : vedi [questa pagina](/help) - -!!! PER AMOR DI DIO, PER FAVORE fornisci un minimo di contesto! I volontari non possono aiutarti se non ti prendi *cinque* minuti per descrivere il contesto: il tipo di hardware, la versione di YunoHost, cosa stai cercando di fare e cos'hai provato a fare, cos'è successo e **i log relativi**. diff --git a/pages/02.administer/50.troubleshooting/troubleshooting.md b/pages/02.administer/50.troubleshooting/troubleshooting.md index de5c6f8e..d4772bd4 100644 --- a/pages/02.administer/50.troubleshooting/troubleshooting.md +++ b/pages/02.administer/50.troubleshooting/troubleshooting.md @@ -7,18 +7,6 @@ routes: default: '/troubleshooting' --- -Here are some general advices when encountering issues with your server. +This section contains specific tips to troubleshoot common issues. -## 0. Don't panic - -Stay calm. Most issues are less worse than newcomers usually think. For the love of God (or your favourite deity / animal / food), please don't jump into the "reinstallation spiral" thinking reinstalling your server from scratch will magically fix stuff. Reinstalling is a heavy operation and is not a good long-term strategy for fixing problems. You will get tired and won't learn anything. - -## 1. Look for similar issues on the forum or bugtrackers - -Search [the forum](https://forum.yunohost.org) for topics similar to the issue you're encountering. If you have issues with a specific app, you may also want to check the corresponding bugtracker of the app, for example [here is the bugtracker for the Wordpress app](https://github.com/YunoHost-Apps/wordpress_ynh/issues). - -## 2. Ask for help - -Either on [the forum](https://forum.yunohost.org) or the chat: c.f. [this page](/help) - -!!! FOR THE LOVE OF GOD, PLEASE provide basic context! Volunteers can NOT help you if you do not take *five* minutes to describe your context: which kind of hardware, which YunoHost version, what you are trying to do, what you tried, what happened and **the corresponding logs**. +If you are looking for help, consider having a look at [the forum](https://forum.yunohost.org/), [the support chat room](/chat_rooms), [the 'Help' page](/help) and [how to ask for help efficiently](/asking_for_help_efficiently) diff --git a/pages/02.administer/60.extend/05.install_unpackaged_app/install_unpackaged_app.md b/pages/02.administer/60.extend/05.install_unpackaged_app/install_unpackaged_app.md deleted file mode 100644 index 7fbe171c..00000000 --- a/pages/02.administer/60.extend/05.install_unpackaged_app/install_unpackaged_app.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: Install unpackaged apps -template: docs -taxonomy: - category: docs -routes: - default: '/install_unpackaged_apps' ---- - -## PHP or HTML/JS apps - -If your app is a PHP or HTML/JS app, you probably should use the `Custom Webapp`, also know as `my_webapp`, in order to configure nginx, php, mysql, YunoHost permission and backup for you. - -## Other technologies - -If you use some other technology, you should install it like on a classical Debian. - -To expose the app on the web through nginx and be able to manage access permissions to the webapp, you could use the [`redirect` app](https://github.com/YunoHost-Apps/redirect_ynh/) to create a nginx reverse proxy on your local ip/port running the service. - -!!! You should use the proxy mode of the redirect app and not HTTP redirections mode. - -You probably should create custom backup and restore hooks to integrate your app to your YunoHost backup/restore process. See [Backup and restore hooks](/packaging_apps_hooks#backup-restore) diff --git a/pages/02.administer/60.extend/10.configuration_management/configuration_management.md b/pages/02.administer/60.extend/10.configuration_management/configuration_management.md deleted file mode 100644 index 8578ecb6..00000000 --- a/pages/02.administer/60.extend/10.configuration_management/configuration_management.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Configuration management -template: docs -taxonomy: - category: docs -routes: - default: '/configuration_management' ---- - -!! This page is to be written diff --git a/pages/02.administer/60.extend/20.helpers/helpers.md b/pages/02.administer/60.extend/20.helpers/helpers.md deleted file mode 100644 index 9869ed97..00000000 --- a/pages/02.administer/60.extend/20.helpers/helpers.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: App helpers -template: docs -redirect: '/packaging_apps_scripts_helpers' ---- diff --git a/pages/02.administer/60.extend/25.hooks/hooks.md b/pages/02.administer/60.extend/25.hooks/hooks.md deleted file mode 100644 index 5be0ac0f..00000000 --- a/pages/02.administer/60.extend/25.hooks/hooks.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: Hooks -template: docs -redirect: '/packaging_apps_hooks' ---- diff --git a/pages/02.administer/60.extend/30.api/admin_api.fr.md b/pages/02.administer/60.extend/30.api/admin_api.fr.md deleted file mode 100644 index 291b2b3a..00000000 --- a/pages/02.administer/60.extend/30.api/admin_api.fr.md +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: Administration depuis l'API ou une application externe -template: docs -taxonomy: - category: docs -routes: - default: '/admin_api' ---- - -Toutes les actions exécutables en ligne de commande le sont également via une API. L’API est accessible à l’adresse . -Pour le moment, il n'existe pas de documentation des différentes routes... mais vous pouvez trouver l'actionmap [ici](https://github.com/YunoHost/yunohost/blob/dev/share/actionsmap.yml) (en particulier les clefs `api`) - -## Avec cURL - -Il faut d’abord récupérer un cookie de connexion pour ensuite réaliser les actions. Voici un exemple avec cURL : - -```bash -# Login (avec mot de passe admin) -curl -k -H "X-Requested-With: customscript" \ - -d "password=supersecretpassword" \ - -dump-header headers \ - https://your.server/yunohost/api/login - -# Exemple de GET -curl -k -i -H "Accept: application/json" \ - -H "Content-Type: application/json" \ - -L -b headers -X GET https://your.server/yunohost/api/ROUTE \ - | grep } | python -mjson.tool -``` - -## Avec une classe PHP - -Pour simplifier l’administration à distance d’une instance YunoHost dans le cadre d’un projet CHATONS/Librehosters, des classes API ont été développées par des utilisateurs. - -Par exemple, cette [classe PHP](https://github.com/scith/yunohost-api-php) vous permettra d’administrer votre instance YunoHost depuis une application PHP (site Web, outil de gestion de capacité...). - -Voici un exemple de code PHP permettant d’ajouter un utilisateur dans votre instance YunoHost : - -```php -require("ynh_api.class.php"); -$ynh = new YNH_API("adresse IP du serveur YunoHost ou nom d’hôte", "mot de passe administrateur"); - -if ($ynh->login()) { - $domains = $ynh->get("/domains"); - $first_domain = $domains['domains'][0]; - - $arguments = array( - 'username' => 'test', - 'password' => 'yunohost', - 'firstname' => 'Prénom', - 'lastname' => 'Nom', - 'mail' => 'test@'.$first_domain, - 'mailbox_quota' => '500M' - ); - - $user_add = $ynh->post("/users", $arguments); - print_r($user_add); - -} else { - print("Login to YunoHost failed.\n"); - exit; -} -``` diff --git a/pages/02.administer/60.extend/30.api/admin_api.md b/pages/02.administer/60.extend/30.api/admin_api.md deleted file mode 100644 index fd49c76e..00000000 --- a/pages/02.administer/60.extend/30.api/admin_api.md +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: Administration from the API or an external application -template: docs -taxonomy: - category: docs -routes: - default: '/admin_api' ---- - -All command line actions can also be ran from the web API. The API is available at . - -## Test with curl - -You must first retrieve a login cookie thanks to the /login route to perform the other actions. - -```bash -# Login (with admin password) -curl -k -H "X-Requested-With: customscript" \ - -d "credentials=supersecretpassword" \ - -dump-header headers \ - https://your.server/yunohost/api/login - -# GET example -curl -k -i -H "Accept: application/json" \ - -H "Content-Type: application/json" \ - -H 'Cookie: yunohost.admin="XXXXXXXX"' \ - -L -b headers -X GET https://your.server/yunohost/api/ROUTE \ - | grep } | python -mjson.tool -``` - -## Test with our swagger doc - - 1. Login on the [Webadmin of `demo.yunohost.org`](https://demo.yunohost.org/yunohost/admin/) - 2. Use the `Try it out` button on the API endpoint you want to test - -
- - - - - - diff --git a/pages/02.administer/60.extend/extend.md b/pages/02.administer/60.extend/extend.md deleted file mode 100644 index 6a7d9ccc..00000000 --- a/pages/02.administer/60.extend/extend.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Understand and extend YunoHost -template: docs -taxonomy: - category: docs -routes: - default: '/extend' ---- - -!! This section is to be written diff --git a/pages/02.administer/admindoc.de.md b/pages/02.administer/admindoc.de.md index aa2fcb86..60dd9ba8 100644 --- a/pages/02.administer/admindoc.de.md +++ b/pages/02.administer/admindoc.de.md @@ -7,6 +7,6 @@ routes: default: '/admindoc' --- -### Administrieren +# Administratorhandbuch -# Entdecke das Selbsthosten und lerne, wie YunoHost installiert und benutzt wird +### Entdecke das Selbsthosten und lerne, wie YunoHost installiert und benutzt wird diff --git a/pages/02.administer/admindoc.es.md b/pages/02.administer/admindoc.es.md index 67a1364b..7f4705aa 100644 --- a/pages/02.administer/admindoc.es.md +++ b/pages/02.administer/admindoc.es.md @@ -7,6 +7,6 @@ routes: default: /admindoc --- -### Administrar +# Admin guide -# Descubre el auto-hospedaje, cómo instalar y usar tu YunoHost +### Descubre el auto-hospedaje, cómo instalar y usar tu YunoHost diff --git a/pages/02.administer/admindoc.fr.md b/pages/02.administer/admindoc.fr.md index bedfb7c6..304e0c2e 100644 --- a/pages/02.administer/admindoc.fr.md +++ b/pages/02.administer/admindoc.fr.md @@ -7,6 +7,6 @@ routes: default: '/admindoc' --- -### Administrer +# Guide d'administration -# Découvrez l'auto-hébergement, comment installer et utiliser YunoHost +### Découvrez l'auto-hébergement, comment installer et utiliser YunoHost diff --git a/pages/02.administer/admindoc.it.md b/pages/02.administer/admindoc.it.md index ae434ffd..f3705b38 100644 --- a/pages/02.administer/admindoc.it.md +++ b/pages/02.administer/admindoc.it.md @@ -8,6 +8,6 @@ routes: default: '/admindoc' --- -### Amministrare +# Guida di amministrazione -# Scoprire il self-hosting, come installare e utilizzare YunoHost +### Scoprire il self-hosting, come installare e utilizzare YunoHost diff --git a/pages/02.administer/admindoc.md b/pages/02.administer/admindoc.md index 8cd06ba6..ba22bb1a 100644 --- a/pages/02.administer/admindoc.md +++ b/pages/02.administer/admindoc.md @@ -7,6 +7,6 @@ routes: default: '/admindoc' --- -### Administer +# Administration guide -# Learn about self-hosting, how to install and use YunoHost +### Learn about self-hosting, how to install and use YunoHost diff --git a/pages/02.administer/admindoc.ru.md b/pages/02.administer/admindoc.ru.md index db29f4d9..96d66524 100644 --- a/pages/02.administer/admindoc.ru.md +++ b/pages/02.administer/admindoc.ru.md @@ -7,6 +7,6 @@ routes: default: '/admindoc' --- -### Управление +# Руководство для администраторов -# Узнайте о самостоятельном хостинге, о том, как установить и использовать YunoHost +### Узнайте о самостоятельном хостинге, о том, как установить и использовать YunoHost diff --git a/pages/03.user_guide/user_overview.fr.md b/pages/03.user_guide/user_overview.fr.md index 5e900b79..10d5f73e 100644 --- a/pages/03.user_guide/user_overview.fr.md +++ b/pages/03.user_guide/user_overview.fr.md @@ -1,11 +1,10 @@ --- title: Guide de l'utilisateur -menu: Guide de l'utilisateur -template: docs +template: chapter taxonomy: category: docs routes: default: '/user_guide' --- -!! Cette section est en cours d'élaboration. +# Guide de l'utilisateur diff --git a/pages/03.user_guide/user_overview.md b/pages/03.user_guide/user_overview.md index a31c91a6..4d82e058 100644 --- a/pages/03.user_guide/user_overview.md +++ b/pages/03.user_guide/user_overview.md @@ -1,11 +1,10 @@ --- title: User guide -menu: User guide -template: docs +template: chapter taxonomy: category: docs routes: default: '/user_guide' --- -!! This section is being worked on. +# User guide diff --git a/pages/04.applications/05.catalog/apps.md b/pages/04.applications/05.catalog/apps.md deleted file mode 100644 index 97230d7b..00000000 --- a/pages/04.applications/05.catalog/apps.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Application catalog -template: docs -redirect: 'https://apps.yunohost.org/catalog' -routes: - default: '/apps' ---- diff --git a/pages/04.applications/15.framasoft/apps_framasoft.md b/pages/04.applications/15.framasoft/apps_framasoft.md deleted file mode 100644 index 52c7c354..00000000 --- a/pages/04.applications/15.framasoft/apps_framasoft.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: Equivalent Framasoft applications -template: docs -taxonomy: - category: docs -routes: - default: '/apps_framasoft' ---- - -| Framasoft App | Original project | Package | -| :---: | :---: | :---: | -| Framabag | [Wallabag](https://www.wallabag.it) | [[fa=git /]](https://github.com/YunoHost-Apps/wallabag2_ynh) ![](https://ci-apps.yunohost.org/ci/badges/wallabag2.status.svg) ![](https://dash.yunohost.org/integration/wallabag2.svg) | -| Framabee | [Searx](https://searx.ir) | [[fa=git /]](https://github.com/YunoHost-Apps/searx_ynh) ![](https://ci-apps.yunohost.org/ci/badges/searx.status.svg) ![](https://dash.yunohost.org/integration/searx.svg) | -| Framabin | [PrivateBin](https://privatebin.info) | [[fa=git /]](https://github.com/YunoHost-apps/zerobin_ynh) ![](https://ci-apps.yunohost.org/ci/badges/zerobin.status.svg) ![](https://dash.yunohost.org/integration/zerobin.svg) | -| Framaboard | [Kanboard](https://kanboard.org) | [[fa=git /]](https://github.com/YunoHost-Apps/kanboard_ynh) ![](https://ci-apps.yunohost.org/ci/badges/kanboard.status.svg) ![](https://dash.yunohost.org/integration/kanboard.svg) | -| Framabookin | [BicBucStriim](https://github.com/rvolz/BicBucStriim) | [[fa=git /]](https://github.com/YunoHost-Apps/bicbucstriim_ynh) ![](https://ci-apps.yunohost.org/ci/badges/bicbucstriim.status.svg) ![](https://dash.yunohost.org/integration/bicbucstriim.svg) | -| Framacalc | [Ethercalc](https://ethercalc.net) | [[fa=git /]](https://github.com/YunoHost-Apps/ethercalc_ynh) ![](https://ci-apps.yunohost.org/ci/badges/ethercalc.status.svg) ![](https://dash.yunohost.org/integration/ethercalc.svg) | -| Framacarte | [uMap](http://umap.openstreetmap.fr) | [[fa=git /]](https://github.com/YunoHost-Apps/umap_ynh) ![](https://ci-apps.yunohost.org/ci/badges/umap.status.svg) ![](https://dash.yunohost.org/integration/umap.svg) | -| Framaclic | [Dolomon](https://dolomon.org) | Non Packagé | -| Framadate | [OpenSondage](https://framadate.org) | [[fa=git /]](https://github.com/YunoHost-Apps/opensondage_ynh) ![](https://ci-apps.yunohost.org/ci/badges/opensondage.status.svg) ![](https://dash.yunohost.org/integration/opensondage.svg) | -| Framadrive | [Nextcloud](https://nextcloud.com) | [[fa=git /]](https://github.com/YunoHost-apps/nextcloud_ynh) ![](https://ci-apps.yunohost.org/ci/badges/nextcloud.status.svg) ![](https://dash.yunohost.org/integration/nextcloud.svg) | -| Framadrop | [Lufi](https://framagit.org/fiat-tux/hat-softwares/lufi) | [[fa=git /]](https://github.com/YunoHost-Apps/lufi_ynh) ![](https://ci-apps.yunohost.org/ci/badges/lufi.status.svg) ![](https://dash.yunohost.org/integration/lufi.svg) | -| Framaestro | [Framaestro](https://framaestro.org) | [[fa=git /]](https://github.com/YunoHost-Apps/framaestro_ynh) ![](https://ci-apps.yunohost.org/ci/badges/framaestro.status.svg) ![](https://dash.yunohost.org/integration/framaestro.svg) | -| Framaforms | [Framaforms](https://framaforms.org) | [[fa=git /]](https://github.com/YunoHost-Apps/framaforms_ynh) ![](https://ci-apps.yunohost.org/ci/badges/framaforms.status.svg) ![](https://dash.yunohost.org/integration/framaforms.svg) | -| Framagames | [Framagames](https://framagames.org) | [[fa=git /]](https://github.com/YunoHost-Apps/framagames_ynh) ![](https://ci-apps.yunohost.org/ci/badges/framagames.status.svg) ![](https://dash.yunohost.org/integration/framagames.svg) | -| Framagenda | [Nextcloud Calendar](https://apps.nextcloud.com/apps/calendar) | c.f. Nextcloud | -| Framagit | [GitLab](https://about.gitlab.com) | [[fa=git /]](https://github.com/YunoHost-Apps/gitlab_ynh) ![](https://ci-apps.yunohost.org/ci/badges/gitlab.status.svg) ![](https://dash.yunohost.org/integration/gitlab.svg) | -| Frama.link | [Lstu](https://lstu.fr) | [[fa=git /]](https://github.com/YunoHost-Apps/lstu_ynh) ![](https://ci-apps.yunohost.org/ci/badges/lstu.status.svg) ![](https://dash.yunohost.org/integration/lstu.svg) | -| Framalistes | [Sympa](http://www.sympa.org) | [[fa=git /]](https://github.com/alexAubin/sympa_ynh) ![](https://ci-apps.yunohost.org/ci/badges/sympa.status.svg) ![](https://dash.yunohost.org/integration/sympa.svg) | -| Framanews | [TinyTinyRSS](https://tt-rss.org) | [[fa=git /]](https://github.com/YunoHost-apps/ttrss_ynh) ![](https://ci-apps.yunohost.org/ci/badges/ttrss.status.svg) ![](https://dash.yunohost.org/integration/ttrss.svg) | -| Framanotes | [Turtl](https://turtlapp.com) | [[fa=git /]](https://github.com/YunoHost-Apps/turtl_ynh) ![](https://ci-apps.yunohost.org/ci/badges/turtl.status.svg) ![](https://dash.yunohost.org/integration/turtl.svg) | -| Framapad | [Etherpad](https://etherpad.org) + [MyPads](https://framagit.org/framasoft/Etherpad/ep_mypads) | [[fa=git /]](https://github.com/YunoHost-Apps/etherpad_mypads_ynh) ![](https://ci-apps.yunohost.org/ci/badges/etherpad_mypads.status.svg) ![](https://dash.yunohost.org/integration/etherpad_mypads.svg) | -| Framapiaf | [Mastodon](https://joinmastodon.org) | [[fa=git /]](https://github.com/YunoHost-Apps/mastodon_ynh) ![](https://ci-apps.yunohost.org/ci/badges/mastodon.status.svg) ![](https://dash.yunohost.org/integration/mastodon.svg) | -| Framapic | [Lutim](https://lut.im/) | [[fa=git /]](https://github.com/YunoHost-Apps/lutim_ynh) ![](https://ci-apps.yunohost.org/ci/badges/lutim.status.svg) ![](https://dash.yunohost.org/integration/lutim.svg) | -| Framasites | [Grav](https://getgrav.org) | [[fa=git /]](https://github.com/YunoHost-Apps/grav_ynh) ![](https://ci-apps.yunohost.org/ci/badges/grav.status.svg) ![](https://dash.yunohost.org/integration/grav.svg) | -| Framaslides | [Strut](https://strut.io) | [[fa=git /]](https://github.com/YunoHost-Apps/strut_ynh) ![](https://ci-apps.yunohost.org/ci/badges/strut.status.svg) ![](https://dash.yunohost.org/integration/strut.svg) | -| Framasphère | [Diaspora](https://diasporafoundation.org) | [[fa=git /]](https://github.com/aymhce/diaspora_ynh) ![](https://ci-apps.yunohost.org/ci/badges/diaspora.status.svg) ![](https://dash.yunohost.org/integration/diaspora.svg) | -| Framatalk | [Jitsi Meet](https://meet.jit.si) | [[fa=git /]](https://github.com/YunoHost-Apps/jitsi_ynh) ![](https://ci-apps.yunohost.org/ci/badges/jitsi.status.svg) ![](https://dash.yunohost.org/integration/jitsi.svg) | -| Framateam | [Mattermost](https://mattermost.com) | [[fa=git /]](https://github.com/YunoHost-Apps/mattermost_ynh) ![](https://ci-apps.yunohost.org/ci/badges/mattermost.status.svg) ![](https://dash.yunohost.org/integration/mattermost.svg) | -| Framatrad | [Weblate](https://weblate.org) | [[fa=git /]](https://github.com/YunoHost-Apps/weblate_ynh) ![](https://ci-apps.yunohost.org/ci/badges/weblate.status.svg) ![](https://dash.yunohost.org/integration/weblate.svg) | -| Framatube | [Peertube](https://joinpeertube.org) | [[fa=git /]](https://github.com/YunoHost-Apps/peertube_ynh) ![](https://ci-apps.yunohost.org/ci/badges/peertube.status.svg) ![](https://dash.yunohost.org/integration/peertube.svg) | -| Framavectoriel | [SVG-Edit](https://github.com/SVG-Edit/svgedit) | [[fa=git /]](https://github.com/YunoHost-Apps/svgedit_ynh) ![](https://ci-apps.yunohost.org/ci/badges/svgedit.status.svg) ![](https://dash.yunohost.org/integration/svgedit.svg) | -| Framavox | [Loomio](https://www.loomio.org) | Non packagé | -| Framemo | [Scrumblr](http://scrumblr.ca) | [[fa=git /]](https://github.com/YunoHost-Apps/scrumblr_ynh) ![](https://ci-apps.yunohost.org/ci/badges/scrumblr.status.svg) ![](https://dash.yunohost.org/integration/scrumblr.svg) | -| Framindmap | [Wisemapping](https://www.wisemapping.com) | [[fa=git /]](https://github.com/YunoHost-Apps/wisemapping_ynh) ![](https://ci-apps.yunohost.org/ci/badges/wisemapping.status.svg) ![](https://dash.yunohost.org/integration/wisemapping.svg) | -| Framinetest | [Minetest](https://www.minetest.net) | [[fa=git /]](https://github.com/YunoHost-Apps/minetest_ynh) ![](https://ci-apps.yunohost.org/ci/badges/minetest.status.svg) ![](https://dash.yunohost.org/integration/minetest.svg) | -| MyFrama | [Shaarli](https://github.com/shaarli/Shaarli) | [[fa=git /]](https://github.com/YunoHost-Apps/shaarli_ynh) ![](https://ci-apps.yunohost.org/ci/badges/shaarli.status.svg) ![](https://dash.yunohost.org/integration/shaarli.svg) | - -### See also - -- [Complete list of packaged applications](/apps) -- [The roadmap 'Dégooglisons'](https://github.com/YunoHost/issues/milestone/13) diff --git a/pages/04.applications/20.app_bundle/05.ngo/use_case_non-profit_organisations.ca.md b/pages/04.applications/20.app_bundle/05.ngo/use_case_non-profit_organisations.ca.md deleted file mode 100644 index b46f31e9..00000000 --- a/pages/04.applications/20.app_bundle/05.ngo/use_case_non-profit_organisations.ca.md +++ /dev/null @@ -1,213 +0,0 @@ ---- -title: Use cases for NGOs -template: docs -taxonomy: - category: docs -routes: - default: '/use_case_non-profit_organisations' -page-toc: - active: true ---- - -! TODO: this page should be updated. - -L'objectiu d'aquest document és presentar un cas d'ús específic de [YunoHost](https://yunohost.org) per a organitzacions sense ànim de lucre. - -## Qui - -Organitzacions sense ànim de lucre, ONGs o qualsevol tipus d'associació. - -## Què - -Normalment les organitzacions sense ànim de lucre han de donar alguns serveis públics: - -- Consell d'administració / Comitè director / Voluntàries amb: - - [Correus electrònics](#mails) - - [Calendari](#calendar) - - [Contacte](#contact) - - [Fitxers compartits / Drive](#shared-files) - - [Missatgeria instantània](#instant-communication) - - [Intranet / base de coneixements](#intranet) - - [ERP / Comptabilitat](#erp-accounting) -- Membres amb: - - [Pàgina web pública amb accés privat i individual](#public-web-site) - - [Adhesió](#membership) - - [Inscripció a esdeveniments](#events-registration) - - [Butlletí d'informació](#newsletter-mailing) - - [Fòrum](#forum) -- Públic amb: - - [Pàgina web pública](#public-web-site) - - [Butlletí d'informació](#newsletter-mailing) - -## Quan - -Quan l'organització estigui preparada per a fer el pas. - -## On - -El servidor YunoHost de l'organització pot estar allotjat en diferents llocs: - -- Allotjament propi en un servidor, ordinador o Raspberry darrera una connexió ADSL, SDSL o fibra -- Serveis d'allotjament de [Chatons](https://chatons.org), [librehosters](https://framagit.org/librehosters/awesome-librehosters) -- Serveis d'allotjament comercials que ofereixin màquines virtuals Debian - -## Per què - -YunoHost pot cobrir la majoria de necessitats d'una organització sense ànim de lucre i permet tenir el control sobre les dades de l'organització. - -## Com - -### YunoHost - -YunoHost és una distribució GNU/Linux basada en Debian empaquetada amb programari lliure que automatitza la instal·lació d'un servidor web personal. L'objectiu de YunoHost és permetre a les usuàries allotjar fàcilment els seus propis serveis web al oferir una interfície web en la que es poden instal·lar diferents aplicacions només amb uns quants clics. - -![](https://upload.wikimedia.org/wikipedia/commons/0/07/Yunohost_user_portal.png) - -YunoHost de base ofereix: - -- Un sistema d'aplicacions -- Una interfície web -- Una interfície per línia de comandes (CLI): Moulinette -- Un servidor web: NGINX -- Un servidor DNS: Dnsmasq -- Una base de dades: MariaDB -- Un sistema de còpies de seguretat -- Un SSO: SSOwat -- OpenLDAP -- Correu electrònic: - - SMTP: Postfix - - IMAP & POP3: Dovecot - - Un antispam: rspamd, rmilter -- Un servidor de missatgeria instantània XMPP: Metronome IM - -### Nom de domini - -La primera cosa que s'haurà de tenir per poder instal·lar un servidor YunoHost és un nom de domini. Habitualment el nom de domini el pot oferir el mateix servei d'allotjament. - -### Correus electrònics - -De base, YunoHost ofereix un sistema de correus electrònics disponible utilitzant POP / IMAP / SMTP. -Els comptes de correu electrònic es poden gestionar per mitjà de la interfície web o de la línia de comandes. Els comptes creats es guarden en l'OpenLDAP. - -Es poden instal·lar paquets addicionals per donar més funcionalitats al sistema de correu electrònic de YunoHost: - -- Un client web utilitzant [Roundcube](https://github.com/YunoHost-Apps/roundcube_ynh), [Rainloop](https://github.com/YunoHost-Apps/rainloop_ynh) -- ActiveSync utilitzant [Z-Push](https://github.com/YunoHost-Apps/z-push_ynh) -- Un grup de difusió interna utilitzant [Mailman](https://github.com/YunoHost-Apps/mailman_ynh) - -### Calendari - -Per oferir calendaris personals o compartits haureu d'instal·lar: - -- [Nextcloud](https://github.com/YunoHost-Apps/nextcloud_ynh) -- [Baikal](https://github.com/YunoHost-Apps/baikal_ynh) - -### Contactes - -Per oferir un sistema de contactes personal haureu d'instal·lar: - -- [Nextcloud](https://github.com/YunoHost-Apps/nextcloud_ynh) -- [Baïkal](https://github.com/YunoHost-Apps/baikal_ynh) - -### Fitxers compartits - -Per oferir un sistema de fitxers compartit: carpetes personals i compartides, podeu instal·lar [Nextcloud](https://github.com/YunoHost-Apps/nextcloud_ynh). -Els fitxers estaran disponibles a través d'una interfície web o bé utilitzant un client de sincronització. - -### Missatgeria instantània - -De base YunoHost ofereix un servidor XMPP, pel que podeu instal·lar un client web: [Jappix](https://github.com/YunoHost-Apps/jappix_ynh). - -També podeu instal·lar un servidor matrix: - -- El servidor: [Synapse](https://github.com/YunoHost-Apps/synapse_ynh) -- Un client web: [Riot](https://github.com/YunoHost-Apps/riot_ynh) - -### Intranet - -Per a una organització sense ànim de lucre, una bona manera d'implementar una intranet és oferir una wiki interna per a que les usuàries puguin llegir, editar i afegir contingut. Vegeu aquí alguns paquets que permeten implementar una wiki: - -- [DokuWiki](https://github.com/YunoHost-Apps/docuwiki_ynh) utilitzant la sintaxi wiki -- [Wiki.js](https://github.com/YunoHost-Apps/wikijs_ynh) utilitzant la sintaxi markdown - -### ERP / Comptabilitat - -Arribats a un cert punt una organització sense ànim de lucre podria necessitar un sistema de comptabilitat / ERP, aquí hi ha dos propostes: - -- [OpenERP/Odoo](https://github.com/YunoHost-Apps/libreerp_ynh) -- [Dolibarr](https://github.com/YunoHost-Apps/dolibarr_ynh) - -### Pàgina web pública - -Hi ha múltiples maneres d'implementar una pàgina web pública: - -- Un pàgina simple amb HTML, CSS, etc. utilitzant: [Custom Webapp](https://github.com/YunoHost-Apps/my_webapp_ynh) -- Utilitzant un CMS (sistema de gestió de contingut) com [Wordpress](https://github.com/YunoHost-Apps/_ynh), [Drupal](https://github.com/YunoHost-Apps/drupal_ynh) , [Grav](https://github.com/YunoHost-Apps/grav_ynh), [PluXml](https://github.com/YunoHost-Apps/pluxml_ynh) - -Però us proposem una alternativa una mica més potent: [CiviCRM on Drupal 7](https://github.com/YunoHost-Apps/civicrm_drupal7_ynh): - -- Drupal és un entorn de treball potent de codi obert per la gestió de contingut -- amb CiviCRM que és un CRM de codi obert per a les organitzacions sense ànim de lucre - -### Adhesió - -Amb CiviCRM podeu tenir adhesions en línia i pagament. - -### Inscripció a esdeveniments - -Amb CiviCRM, podeu posar a disposició una agenda en línia per permetre als membres o al públic inscriure's gratuïtament o pagant. - -### Butlletí d'informació - -La millor manera de gestionar-ho és utilitzar el mòdul de llistes de difusió de CiviCRM. - -### Fòrum - -Hi ha múltiples opcions, tenir un fòrum integrat a Drupal o utilitzar un sistema dedicat com ara [Flarum](https://github.com/YunoHost-Apps/flarum_ynh). - -### Còpies de seguretat - -YunoHost ofereix el seu propi sistema de còpies de seguretat. Abans de cada actualització, YunoHost fa una còpia de seguretat de la versió actual del paquet i la restaura automàticament si falla l'actualització. -Les còpies de seguretat de YunoHost s'emmagatzemen localment a `/home/yunohost.backup/archives`. - -Però per un servidor en producció, còpies de seguretat locals no són suficients, així que s'hauran d'implementar còpies de seguretat alternatives: - -- Còpia de seguretat de la màquina virtual si ho permet el sistema d'allotjament. -- [Archivist](https://github.com/YunoHost-Apps/archivist_ynh) és un sistema de còpies de seguretat automàtiques del servidor. Les còpies de seguretat es poden enviar a d'altres llocs, locals o distants. -- [Borg](https://github.com/YunoHost-Apps/borg_ynh) i [Borg Server](https://github.com/YunoHost-Apps/borgserver_ynh) permeten externalitzar les còpies de seguretat. -- [Fallback](https://github.com/YunoHost-Apps/fallback_ynh), si teniu de servidors YunoHost, permet tenir un servidor secundari que pot ser utilitzat en cas que caigui el servidor principal. Aquest servidor secundari permetrà desplegar una còpia del servidor i tornar a posar en marxar YunoHost durant la caiguda. - -### Anar més enllà - -#### Galeria de fotografies federada - -- [Pixelfed](https://github.com/YunoHost-Apps/pixelfed_ynh) - -#### Galeria àudio federada - -- [Reel2Bits](https://github.com/YunoHost-Apps/reel2bits_ynh) -- [Funkwhale](https://github.com/YunoHost-Apps/funkwhale_ynh) - -#### Galeria vídeo federada - -- [PeerTube](https://github.com/YunoHost-Apps/peertube_ynh) - -#### Xarxa social federada - -- [Mastodon](https://github.com/YunoHost-Apps/mastodon_ynh) -- [Pleroma](https://github.com/YunoHost-Apps/pleroma_ynh) -- [Mobilizon](https://github.com/YunoHost-Apps/mobilizon_ynh) - -#### Blog federat - -- [Plume](https://github.com/YunoHost-Apps/plume_ynh) -- [Writefreely](https://github.com/YunoHost-Apps/writefreely_ynh) - -#### Xat - -- [Mattermost](https://github.com/YunoHost-Apps/mattermost_ynh) - -## Conclusió - -YunoHost por cobrir el 99% de les necessitats de les organitzacions sense ànim de lucre, permetent així que recuperin la sobirania i puguin protegir les seves dades, així com escollir les aplicacions que volen utilitzar. -I si n'hi ha alguna que no està disponible, poden [empaquetar-la per YunoHost](/contributordoc), és molt senzill. diff --git a/pages/04.applications/20.app_bundle/05.ngo/use_case_non-profit_organisations.fr.md b/pages/04.applications/20.app_bundle/05.ngo/use_case_non-profit_organisations.fr.md deleted file mode 100644 index 086f574a..00000000 --- a/pages/04.applications/20.app_bundle/05.ngo/use_case_non-profit_organisations.fr.md +++ /dev/null @@ -1,213 +0,0 @@ ---- -title: Cas d'usages pour associations -template: docs -taxonomy: - category: docs -routes: - default: '/use_case_non-profit_organisations' -page-toc: - active: true ---- - -! TODO: cette page devrait être retravaillée. - -L'objet de ce document est de présenter une utilisation spécifique de [YunoHost](https://yunohost.org/) pour des organisations à but non lucratif. - -## Qui - -Organisations à but non lucratif, ONG ou tout type d'association. - -## Quoi - -Les organisations à but non lucratif doivent généralement fournir différents services à différents publics : - -- Conseil d'administration / Comité directeur / Bénévoles avec : - - [Mails](#mails) - - [Calendrier](#calendrier) - - [Contact](#contact) - - [Fichiers partagés / Drive](#fichiers-partag-s) - - [Communication instantanée](#communication-instantan-e) - - [Intranet / Base de connaissances](#intranet) - - [ERP / Comptabilité](#erp-comptabilit-) -- Membres avec : - - [Site Web public avec accès privé et individuel](#site-web-public) - - [Adhésion](#adh-sion) - - [Inscriptions aux événements](#inscriptions-aux-v-nements) - - [Mailings](#newsletter-mailing) - - [Forum](#forum) -- Public avec : - - [Site Web public](#site-web-public) - - [Newsletter](#newsletter-mailing) - -## Quand - -Lorsque l'organisation à but non lucratif est prête à franchir le pas. - -## Où - -Le serveur YunoHost peut être hébergé à différents endroits : - -- Hébergement en propre sur un serveur, un ordinateur ou Raspberry derrière ADSL, SDSL ou Fibre -- [Chatons](https://chatons.org), [librehosters](https://framagit.org/librehosters/awesome-librehosters) -- Services d'hébergement commercial fournissant une machine virtuelle Debian - -## Pourquoi - -YunoHost peut répondre à tous les besoins d'une organisation à but non lucratif et lui permettre de conserver la maîtrise de ses données. - -## Comment - -### YunoHost - -YunoHost est une distribution basée sur Debian GNU/Linux qui automatise l’installation d’un serveur Web personnel. Le but de YunoHost est de permettre aux utilisateurs d’héberger facilement leurs propres services Web en proposant une interface Web simple, pointer-cliquer, pour installer diverses applications Web. - -![](https://upload.wikimedia.org/wikipedia/commons/0/07/Yunohost_user_portal.png) - -YunoHost fournit immédiatement: - -- Un système d'application -- Une interface Web -- Une interface de ligne de commande (CLI) : Moulinette -- Un serveur Web : NGINX -- Un serveur DNS : Dnsmasq -- Une base de données : MariaDB -- Un système de sauvegarde -- Un SSO : SSOwat -- OpenLDAP -- Email : - - SMTP : Postfix - - IMAP & POP3 : Dovecot - - Un antispam : rspamd, rmilter -- Serveur XMPP de messagerie instantanée : Metronome IM - -### Nom de domaine - -La première chose dont vous aurez besoin pour implémenter un serveur YunoHost est un nom de domaine. Le nom de domaine peut généralement être fourni avec votre service d'hébergement. - -### Mails - -YunoHost fournit par défaut un système de messagerie disponible en utilisant POP / IMAP / SMTP. -Les comptes de messagerie seront gérés à l'aide de l'interface Web ou de la ligne de commande. Les comptes créés sont stockés dans OpenLDAP. - -Des packages supplémentaires peuvent être installés pour fournir davantage de fonctionnalités au système de messagerie YunoHost : - -- un webmail en utilisant [Roundcube](https://github.com/YunoHost-Apps/roundcube_ynh), [Rainloop](https://github.com/YunoHost-Apps/rainloop_ynh) -- ActiveSync utilisant [Z-Push](https://github.com/YunoHost-Apps/z-push_ynh) -- Groupe de distribution interne en utilisant [Mailman](https://github.com/YunoHost-Apps/mailman_ynh) - -### Calendrier - -Pour fournir des calendriers personnels ou partagés, vous devrez installer : - -- [Nextcloud](https://github.com/YunoHost-Apps/nextcloud_ynh) -- [Baïkal](https://github.com/YunoHost-Apps/baikal_ynh) - -### Contact - -Pour fournir un système de contact personnel, vous devrez installer : - -- [Nextcloud](https://github.com/YunoHost-Apps/nextcloud_ynh) -- [Baïkal](https://github.com/YunoHost-Apps/baikal_ynh) - -### Fichiers partagés - -Pour fournir un système de fichiers partagés : dossiers personnels et dossiers partagés, vous pouvez installer [Nextcloud](https://github.com/YunoHost-Apps/nextcloud_ynh). -Les fichiers seront disponibles à partir d'une interface Web ou à l'aide d'un client de synchronisation. - -### Communication instantanée - -Par défaut, YunoHost fournit immédiatement un serveur XMPP pour lequel vous pouvez installer un client Web : [Jappix](https://github.com/YunoHost-Apps/jappix_ynh) - -Vous pouvez également installer un serveur Matrix : - -- Le serveur : [Synapse](https://github.com/YunoHost-Apps/synapse_ynh) -- Un client Web : [Element](https://github.com/YunoHost-Apps/element_ynh) - -### Intranet - -Pour une organisation à but non lucratif, un bon moyen de mettre en œuvre un intranet est de fournir un wiki permettant aux utilisateurs internes de lire, éditer et ajouter du contenu. Voici quelques paquets pour implémenter un wiki : - -- [DokuWiki](https://github.com/YunoHost-Apps/docuwiki_ynh) utilisant une syntaxe wiki -- [Wiki.js](https://github.com/YunoHost-Apps/wikijs_ynh) utilisant une syntaxe Markdown - -### ERP / Comptabilité - -À un moment donné, une organisation à but non lucratif pourrait avoir besoin d’un système de Comptabilité / ERP, voici deux propositions : - -- [OpenERP/Odoo](https://github.com/YunoHost-Apps/libreerp_ynh) -- [Dolibarr](https://github.com/YunoHost-Apps/dolibarr_ynh) - -### Site Web Public - -Il existe plusieurs façons d'implémenter un site Web public : - -- Un simple site HTML, CSS, etc. en utilisant : [Custom Webapp](https://github.com/YunoHost-Apps/my_webapp_ynh) -- Utiliser un CMS (système de gestion de contenu) comme [WordPress](https://github.com/YunoHost-Apps/_ynh), [Drupal](https://github.com/YunoHost-Apps/drupal_ynh), [Grav](https://github.com/YunoHost-Apps/grav_ynh), [PluXml](https://github.com/YunoHost-Apps/pluxml_ynh) - -Mais nous proposerons quelque chose de plus puissant : [CiviCRM on Drupal 7](https://github.com/YunoHost-Apps/civicrm_drupal7_ynh) : - -- Drupal qui est un puissant framework de gestion de contenu -- avec CiviCRM qui est un CRM open source à destination des organisations à but non lucratif - -#### Adhésion - -Avec CiviCRM, vous pourrez mettre en place des adhésions en ligne avec paiement. - -#### Inscriptions aux événements - -Avec CiviCRM, vous pourrez mettre à disposition un agenda en ligne avec la possibilité pour les membres ou le public de s'inscrire gratuitement ou en payant. - -#### Newsletter/Mailing - -Le meilleur moyen de gérer cela consiste à utiliser CiviCRM et son module de mailing. - -### Forum - -Vous avez plusieurs choix, avoir un forum intégré dans Drupal ou utiliser un système de forum dédié tel que [Flarum](https://github.com/YunoHost-Apps/flarum_ynh). - -### Sauvegarde - -YunoHost fournit son propre système de sauvegarde. Avant toute mise à niveau de paquet, YunoHost sauvegarde la version actuelle du paquet et la restaure automatiquement si la mise à niveau échoue. -Les sauvegardes YunoHost sont stockées localement dans `/home/yunohost.backup/archives`. - -Mais pour la production, la sauvegarde stockée localement ne suffit pas, vous devez donc mettre en œuvre des stratégies de sauvegarde supplémentaires : - -- Sauvegarde de la machine virtuelle si fournie par le système d'hébergement. -- [Archivist](https://github.com/YunoHost-Apps/archivist_ynh) est un système de sauvegarde automatique de votre serveur. Vos sauvegardes peuvent être envoyées à de nombreux autres endroits, locaux ou distants. -- [Borg](https://github.com/YunoHost-Apps/borg_ynh) and [Borg Server](https://github.com/YunoHost-Apps/borgserver_ynh) permettent d'externaliser les sauvegardes. -- [Fallback](https://github.com/YunoHost-Apps/fallback_ynh), si vous avez deux serveurs YunoHost, fournissez un moyen d'avoir un serveur secondaire que vous pourrez utiliser si votre serveur principal tombe en panne. Ce serveur secondaire vous permettra de déployer une copie de votre serveur pour ramener votre YunoHost lors de votre panne. - -### Aller plus loin - -#### Galerie de photos fédérées - -- [Pixelfed](https://github.com/YunoHost-Apps/pixelfed_ynh) - -#### Galerie audio fédérée - -- [Reel2Bits](https://github.com/YunoHost-Apps/reel2bits_ynh) -- [Funkwhale](https://github.com/YunoHost-Apps/funkwhale_ynh) - -#### Galerie vidéo fédérée - -- [PeerTube](https://github.com/YunoHost-Apps/peertube_ynh) - -#### Réseaux sociaux fédérés - -- [Mastodon](https://github.com/YunoHost-Apps/mastodon_ynh) -- [Pleroma](https://github.com/YunoHost-Apps/pleroma_ynh) -- [Mobilizon](https://github.com/YunoHost-Apps/mobilizon_ynh) - -#### Blog fédéré - -- [Plume](https://github.com/YunoHost-Apps/plume_ynh) -- [Writefreely](https://github.com/YunoHost-Apps/writefreely_ynh) - -#### Chat - -- [Mattermost](https://github.com/YunoHost-Apps/mattermost_ynh) - -## Conclusion - -YunoHost peut couvrir 99% des besoins des organisations à but non lucratif, leur permettant de posséder et de protéger leurs données, de choisir les applications qu'elles souhaitent utiliser. -Et s’ils ne sont pas disponibles, ils peuvent [les packager pour YunoHost](/contributordoc), c’est très simple. diff --git a/pages/04.applications/20.app_bundle/05.ngo/use_case_non-profit_organisations.md b/pages/04.applications/20.app_bundle/05.ngo/use_case_non-profit_organisations.md deleted file mode 100644 index 9df8645a..00000000 --- a/pages/04.applications/20.app_bundle/05.ngo/use_case_non-profit_organisations.md +++ /dev/null @@ -1,214 +0,0 @@ ---- -title: Use cases for NGOs -template: docs -taxonomy: - category: docs -routes: - default: '/use_case_non-profit_organisations' -page-toc: - active: true ---- - -! TODO: this page should be updated. - -The purpose of this document is to present a specific use of [YunoHost](https://yunohost.org/) for non-profit organizations. - -## Who - -Non-profit organizations, NGO or any kind of association. - -## What - -Usually non-profit organizations need to provide several services to several publics: - -- Board of Directors / Steering Committee / Volunteers with: - - [Mails](#mails) - - [Calendar](#calendar) - - [Contact](#contact) - - [Shared files / Drive](#shared-files) - - [Instant communication](#instant-communication) - - [Intranet / knowledge database](#intranet) - - [ERP / Accounting](#erp-accounting) -- Members with: - - [Public website with private and individual access](#public-web-site) - - [Membership](#membership) - - [Events registrations](#events-registrations) - - [Mailings](#newsletter-mailing) - - [Forum](#forum) -- Public with: - - [Public website](#public-web-site) - - [Newsletter](#newsletter-mailing) - -## When - -When ready to move forward. - -## Where - -You YunoHost for non profit can be hosted in several places: - -- Own hosting on a server, computer or Raspberry behind ASDL, SDSL or Fiber -- [Chatons](https://chatons.org), [librehosters](https://framagit.org/librehosters/awesome-librehosters) hosting services -- Commercial hosting services providing Debian virtual machine - -## Why - -YunoHost can provide mostly all needs of a non-profit organization. -Keeping their data on their own. - -## How - -### YunoHost - -YunoHost is a Debian GNU/Linux based distribution packaged with free software that automates the installation of a personal web server. The purpose of YunoHost is to allow users to easily host their own web services by enabling a simple point-and-click web interface for installing various web apps. - -![](https://upload.wikimedia.org/wikipedia/commons/0/07/Yunohost_user_portal.png) - -Out of the box YunoHost provide: - -- A system of application -- A web interface -- A command-line interface (CLI): Moulinette -- A web server: NGINX -- A DNS server: Dnsmasq -- A database: MariaDB -- A backup system -- An SSO: SSOwat -- OpenLDAP -- Email: - - SMTP: Postfix - - IMAP & POP3: Dovecot - - An antispam: rspamd,rmilter -- Instant messaging XMPP server: Metronome IM - -### Domain Name - -The first thing you will need to implement a YunoHost server is a domain name. The domain name can usually be provided with your hosting service. - -### Mails - -From scratch, YunoHost provide mail system available using POP/IMAP/SMTP. -Mails accounts will be managed using the web interface or the command line. Created accounts are stored in OpenLDAP. - -Additional package can be installed to provide more functionality to the YunoHost mail system: - -- Webmail using [Roundcube](https://github.com/YunoHost-Apps/roundcube_ynh), [Rainloop](https://github.com/YunoHost-Apps/rainloop_ynh) -- ActiveSync using [Z-Push](https://github.com/YunoHost-Apps/z-push_ynh) -- Internal distribution group using [Mailman](https://github.com/YunoHost-Apps/mailman_ynh) - -### Calendar - -To provide personal or shared calendars you will need to install: - -- [Nextcloud](https://github.com/YunoHost-Apps/nextcloud_ynh) -- [Baïkal](https://github.com/YunoHost-Apps/baikal_ynh) - -### Contact - -To provide personal contact system you will need to install: - -- [Nextcloud](https://github.com/YunoHost-Apps/nextcloud_ynh) -- [Baïkal](https://github.com/YunoHost-Apps/baikal_ynh) - -### Shared files - -To provide shared files system: personal and shared drive, you can install [Nextcloud](https://github.com/YunoHost-Apps/nextcloud_ynh). -Files will be available from a web interface or using a synchronization client. - -### Instant communication - -Out of the box, YunoHost provide an XMPP server, for which you can install a web client: [Jappix](https://github.com/YunoHost-Apps/jappix_ynh). - -You can also install a matrix server: - -- The server: [Synapse](https://github.com/YunoHost-Apps/synapse_ynh) -- A web client: [Element](https://github.com/YunoHost-Apps/element_ynh) - -### Intranet - -For an non-profit organization a good way to implement an intranet is to provide a wiki to let internal users read, edit and add content. Here are some packages to implement a wiki: - -- [DokuWiki](https://github.com/YunoHost-Apps/docuwiki_ynh) using wiki syntax -- [Wiki.js](https://github.com/YunoHost-Apps/wikijs_ynh) using Markdown syntax - -### ERP / Accounting - -At some time a non-profit organization could need an accounting/erp system, here are two propositions: - -- [OpenERP/Odoo](https://github.com/YunoHost-Apps/libreerp_ynh) -- [Dolibarr](https://github.com/YunoHost-Apps/dolibarr_ynh) - -### Public Web Site - -There are several way to implement a Public Web Site: - -- Simple HTML, CSS, etc. Website using: [Custom Webapp](https://github.com/YunoHost-Apps/my_webapp_ynh) -- Using a CMS (Content Management System) like [WordPress](https://github.com/YunoHost-Apps/_ynh), [Drupal](https://github.com/YunoHost-Apps/drupal_ynh), [Grav](https://github.com/YunoHost-Apps/grav_ynh), [PluXml](https://github.com/YunoHost-Apps/pluxml_ynh) - -But we will propose something more powerful: [CiviCRM on Drupal 7](https://github.com/YunoHost-Apps/civicrm_drupal7_ynh): - -- Drupal that is a powerful open source content management framework -- with CiviCRM that is an open source constituent relationship management for non-profits - -#### Membership - -With CiviCRM you can provide online membership and payment. - -#### Events Registrations - -With CiviCRM, you can provide an online diary to let members or public register for free or with a payment. - -#### Newsletter/Mailing - -Best way to manage that is using CiviCRM and its mailing module. - -### Forum - -You have several choices, or having an integrated forum in Drupal or using a dedicated forum system like [Flarum](https://github.com/YunoHost-Apps/flarum_ynh). - -### Backup - -YunoHost provide is own backup system. Before any package upgrade, YunoHost backup the current version of the package and automaticaly restore it if the upgrade fails. -YunoHost backup are stored localy in `/home/yunohost.backup/archives`. - -But for production, localy stored backup are not enough, so you will need to implement aditional backup strategies: - -- Backup of the the Virtual Machine if provided by the hosting system. -- [Archivist](https://github.com/YunoHost-Apps/archivist_ynh) is an automatic backup system for your server. Your backups can be send to many other places, local or distant. -- [Borg](https://github.com/YunoHost-Apps/borg_ynh) and [Borg Server](https://github.com/YunoHost-Apps/borgserver_ynh) allow to externalize backups. -- [Fallback](https://github.com/YunoHost-Apps/fallback_ynh), if you have two YunoHost servers, provide a way to have a secondary server which you can used if your main server goes down. This secondary server will allow you to deploy a copy of your server to bring back your YunoHost during your break down. - -### Go further - -#### Federated Photo Gallery - -- [Pixelfed](https://github.com/YunoHost-Apps/pixelfed_ynh) - -#### Federated Audio Gallery - -- [Reel2Bits](https://github.com/YunoHost-Apps/reel2bits_ynh) -- [Funkwhale](https://github.com/YunoHost-Apps/funkwhale_ynh) - -#### Federated Video Gallery - -- [PeerTube](https://github.com/YunoHost-Apps/peertube_ynh) - -#### Federated Social Networking - -- [Mastodon](https://github.com/YunoHost-Apps/mastodon_ynh) -- [Pleroma](https://github.com/YunoHost-Apps/pleroma_ynh) -- [Mobilizon](https://github.com/YunoHost-Apps/mobilizon_ynh) - -#### Federated Blog - -- [Plume](https://github.com/YunoHost-Apps/plume_ynh) -- [Writefreely](https://github.com/YunoHost-Apps/writefreely_ynh) - -#### Chat - -- [Mattermost](https://github.com/YunoHost-Apps/mattermost_ynh) - -## Conclusion - -YunoHost can cover 99% of the needs of non-profit organizations, allowing them to own and protect their data, choose applications they want to use. -And if one is not available, they can [package it for YunoHost](/contributordoc), it's very simple. diff --git a/pages/04.applications/20.app_bundle/05.ngo/use_case_non-profit_organisations.oc.md b/pages/04.applications/20.app_bundle/05.ngo/use_case_non-profit_organisations.oc.md deleted file mode 100644 index b46ed05d..00000000 --- a/pages/04.applications/20.app_bundle/05.ngo/use_case_non-profit_organisations.oc.md +++ /dev/null @@ -1,213 +0,0 @@ ---- -title: Use cases for NGOs -template: docs -taxonomy: - category: docs -routes: - default: '/use_case_non-profit_organisations' -page-toc: - active: true ---- - -! TODO: this page should be updated. - -L'objectiu d’aqueste document es de presentar una utilizacion especifica de [YunoHost](https://yunohost.org/) per d’organizacions sens tòca lucrativa. - -## Qual - -Organizacions sens tòca lucrativa, ONG o qualque siá associacion. - -## Qué - -Las organizacions sens tòca lucrativa devon generalament fornir diferents servicis a diferents publics : - -- Conselh d'administracion / Comitat director / Benevòls amb : - - [Mails](#mails) - - [Calendièr](#calendièr) - - [Contacte](#contacte) - - [Fichièrs partejats / Drive](#fichièrs-partejats) - - [Comunicacion instantanèa](#comunicacion-instantan-a) - - [Intranet / Basa de coneissenças](#intranet) - - [ERP / Comptabilitat](#erp-comptabilitat) -- Membres amb : - - [Site Web public amb accès privat e individual](#site-web-public) - - [Adhesion](#adhesion) - - [Inscripcions als eveniments](#inscriptions-als-eveniments) - - [Infoletras](#infoletras) - - [Forum](#forum) -- Public amb : - - [Site Web public](#site-web-public) - - [Infoletras](#newsletter-mailing) - -## Quand - -Quand l'organizacion sens tòca lucrativa es prèsta a passar lo pas. - -## Ont - -Lo servidor YunoHost pòt èsser albergat a diferents endreches : - -- Albergament en pròpri sus un servidor, un ordenador o Raspberry darrièr una connexion ADSL, SDSL o Fibra -- [Chatons](https://chatons.org), [librehosters](https://framagit.org/librehosters/awesome-librehosters) -- Servicis d'albergament comercial que fornís una maquina virtuala Debian - -## Perque - -YunoHost pòt correspondre als besonhs d'una organizacion sens tòca lucrativa e li permetre de servar lo mestritge de sas donadas. - -## Cossí - -### YunoHost - -YunoHost es una distribucion basada sus Debian GNU/Linux qu’automatiza l’installacion d’un servidor Web personal. La tòca de YunoHost es de permetre als utilizaires d’albergar facilament lors pròpris servicis Web en prepausant una interfàcia Web simpla, als clics, per installar divèrsas aplicacions Web. - -![](https://upload.wikimedia.org/wikipedia/commons/0/07/Yunohost_user_portal.png) - -YunoHost provesís sul pic: - -- Un sistèma d'aplicacion -- Una interfàcia web -- Una interfàcia en linha de comanda (CLI) : Moulinette -- Un servidor Web : NGINX -- Un servidor DNS : Dnsmasq -- Una basa de donadas : MariaDB -- Un sistèma de salvagarda -- Un SSO: SSOwat -- OpenLDAP -- Corrièls : - - SMTP: Postfix - - IMAP & POP3 : Dovecot - - Un antispam : rspamd, rmilter -- Servidor XMPP de messatjariá instantanèa : Metronome IM - -### Nom de domeni - -La primièra causa que vos fa mestièr per installar un servidor YunoHost es un nom de domeni. Lo nom de domeni pòt èsser generalament fornit amb lo servici d’albergament. - -### Corrièls - -A la prima installacion YunoHost fornís un sistèma de messatjariá disponible en utilizant POP / IMAP / SMTP. -Los comptes de messatjariá seràn gerits amb l'interfàcia Web o en linha de comanda. Los comptes creats seràn gardats dins l’OpenLDAP. - -De paquets suplementaris pòdon èsser installats per provesir mai de foncionalitats al sistèma de messatjariá YunoHost : - -- un webmail en utilizant [Roundcube](https://github.com/YunoHost-Apps/roundcube_ynh), [Rainloop](https://github.com/YunoHost-Apps/rainloop_ynh) -- ActiveSync utilizant [Z-Push](https://github.com/YunoHost-Apps/z-push_ynh) -- Grop de distribucion intèrne en utilizant [Mailman](https://github.com/YunoHost-Apps/mailman_ynh) - -### Calendièr - -Per fornir de calendièrs personals o partejats, vos calrà installar : - -- [Nextcloud](https://github.com/YunoHost-Apps/nextcloud_ynh) -- [Baïkal](https://github.com/YunoHost-Apps/baikal_ynh) - -### Contacte - -Per fornir un sistèma de contacte personal, vos caldrà installar : - -- [Nextcloud](https://github.com/YunoHost-Apps/nextcloud_ynh) -- [Baikal](https://github.com/YunoHost-Apps/baikal_ynh) - -### Fichièrs partejats - -Per fornir un sistèma de fichièrs partejats : dorsièrs personals e dorsièrs partejats, podètz installar [Nextcloud](https://github.com/YunoHost-Apps/nextcloud_ynh). -Las fichièrs seràn disponibles d’una interfàcia web estant o amb un client de sincronizacion. - -### Comunicacion instantanèa - -Tras l’installacion YunoHost fornís sul pic un servidor XMPP per lo qual podètz installar un client Web : [Jappix](https://github.com/YunoHost-Apps/jappix_ynh) - -Podètz tanben installar un servidor Matrix : - -- Lo servidor: [Synapse](https://github.com/YunoHost-Apps/synapse_ynh) -- Un client web: [Riot](https://github.com/YunoHost-Apps/riot_ynh) - -### Intranet - -Per una organizacion sens tòca lucrativa, un bon biais de metre en plaça un intranet es de fornir un wiki que permet als utilizaires intèrne de legir, modificar e ajustar de contengut. Vaquí unes paquets per installar un wiki : - -- [DokuWiki](https://github.com/YunoHost-Apps/docuwiki_ynh) utiliza la sintaxi wiki -- [Wiki.js](https://github.com/YunoHost-Apps/wikijs_ynh) utiliza la sintaxi markdown - -### ERP / Comptabilitat - -Arriba un moment ont a l’organizacion sens tòca lucrativa li pòsca far besonh un sistèma de comptabilitat / ERP, vaquí doas proposicions : - -- [OpenERP/Odoo](https://github.com/YunoHost-Apps/libreerp_ynh) -- [Dolibarr](https://github.com/YunoHost-Apps/dolibarr_ynh) - -### Site Web Public - -Existís mantuns biaisses de construire un site Web public : - -- Un simple site HTML, CSS, etc. en utilizant : [Custom Webapp](https://github.com/YunoHost-Apps/my_webapp_ynh) -- Utilizar un CMS (sistèma de gestion de contengut) coma [Wordpress](https://github.com/YunoHost-Apps/_ynh), [Drupal](https://github.com/YunoHost-Apps/drupal_ynh), [Grav](https://github.com/YunoHost-Apps/grav_ynh), [PluXml](https://github.com/YunoHost-Apps/pluxml_ynh) - -Mas prepausam quicòm de mai potent : [CiviCRM on Drupal 7](https://github.com/YunoHost-Apps/civicrm_drupal7_ynh) : - -- Drupal qu’es un framework potent de gestion de contengut -- amb CiviCRM qu’es un CRM OpenSource a destinacion de las organizacions sens tòca lucrativa - -#### Adhesion - -Amb CiviCRM, poiretz metre en plaça d’adhesions en linha amb pagament. - -#### Inscripcions als eveniments - -Amb CiviCRM, poiretz metre a disposicion un agenda en linha amb la possibilitat pels membres o lo public de s’inscriure gratuitament o en pagant. - -#### Infoletra/Lista de difusion - -Çò melhor per gerir aquò es d’utilizar CiviCRM e son modul de lista de difusion. - -### Forum - -Avètz mantun possibilitats, aver un forum integrat a Drupal o utilizar un sistèma dedicat coma [Flarum](https://github.com/YunoHost-Apps/flarum_ynh). - -### Salvagarda - -YunoHost fornís son pròpri sistèma de salvagarda. Abans tota mesa a nivèl de paquet, YunoHost salvagarda la version actuala del paquet e la restaura automaticament se la mesa a nivèl se debana pas corrèctament. -Las salvagardas YunoHost son gardadas localament dins `/home/yunohost.backup/archives`. - -Mas per la produccion, la salvagarda gardada localament basta pas, vos cal emplegar d’estrategias de salvagarda suplementàrias : - -- Salvagarda de la maquina virtuala se fornida pel sistèma d’albergament. -- [Archivist](https://github.com/YunoHost-Apps/archivist_ynh) es un sistèma de salvagarda automatic de vòstre servidor. Vòstras salvagardas pòdon èsser enviadas a mantun endreches, locals o alonhats. -- [Borg](https://github.com/YunoHost-Apps/borg_ynh) e [Borg Server](https://github.com/YunoHost-Apps/borgserver_ynh) permeton d’externalizar las salvagardas. -- [Fallback](https://github.com/YunoHost-Apps/fallback_ynh), se avètz dos servidors YunoHost, ajatz los mejans d’aver un servidor segondari que poiretz utilizar se lo primièr ven a foncionar pas mai. Aqueste servidor segondari vos permetrà de restablir una còpia de vòstre servidor per dire de corregir los problèmas de l’autre servidor YunoHost. - -### Anar mai luènh - -#### Galariá de fotografias federada - -- [Pixelfed](https://github.com/YunoHost-Apps/pixelfed_ynh) - -#### Galariá àudio federada - -- [Reel2Bits](https://github.com/YunoHost-Apps/reel2bits_ynh) -- [Funkwhale](https://github.com/YunoHost-Apps/funkwhale_ynh) - -#### Galariá vidèo federada - -- [PeerTube](https://github.com/YunoHost-Apps/peertube_ynh) - -#### Malhums socials federats - -- [Mastodon](https://github.com/YunoHost-Apps/mastodon_ynh) -- [Pleroma](https://github.com/YunoHost-Apps/pleroma_ynh) -- [Mobilizon](https://github.com/YunoHost-Apps/mobilizon_ynh) - -#### Blog federats - -- [Plume](https://github.com/YunoHost-Apps/plume_ynh) -- [Writefreely](https://github.com/YunoHost-Apps/writefreely_ynh) - -#### Chat - -- [Mattermost](https://github.com/YunoHost-Apps/mattermost_ynh) - -## Conclusion - -YunoHost pòt cumplir 99% dels besonhs de las organizacions sens tòca lucrativa, en lor permetent de téner e protegir lors donadas, de causir las aplicacions que vòlon utilizar. -E se son pas disponiblas, pòdon [crear un paquet per YunoHost](/contributordoc), es fòrça simple. diff --git a/pages/04.applications/20.app_bundle/app_bundle.md b/pages/04.applications/20.app_bundle/app_bundle.md deleted file mode 100644 index 0d5fa4a5..00000000 --- a/pages/04.applications/20.app_bundle/app_bundle.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Application bundles -template: docs -taxonomy: - category: docs -routes: - default: '/bundles' ---- - -! TODO: this page needs to be written - -This page aims to list app bundles to answer to typical use cases. diff --git a/pages/04.applications/99.wishlist/apps_wishlist.md b/pages/04.applications/99.wishlist/apps_wishlist.md deleted file mode 100644 index 97e8a4c1..00000000 --- a/pages/04.applications/99.wishlist/apps_wishlist.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Apps wishlist -template: docs -redirect: 'https://apps.yunohost.org/wishlist' -routes: - default: '/apps_wishlist' ---- diff --git a/pages/04.applications/applications.md b/pages/04.applications/applications.md index 22ca4a88..888314c6 100644 --- a/pages/04.applications/applications.md +++ b/pages/04.applications/applications.md @@ -3,8 +3,9 @@ title: Applications template: chapter taxonomy: category: docs +redirect: 'https://apps.yunohost.org/catalog' routes: - default: /applications + default: '/apps' --- # Applications diff --git a/pages/07.help/help.fr.md b/pages/05.community/12.asking_for_help_efficiently/help.fr.md similarity index 98% rename from pages/07.help/help.fr.md rename to pages/05.community/12.asking_for_help_efficiently/help.fr.md index 896fa861..66c1320a 100644 --- a/pages/07.help/help.fr.md +++ b/pages/05.community/12.asking_for_help_efficiently/help.fr.md @@ -1,10 +1,10 @@ --- -title: Aidez-moi +title: Demander de l'aide efficacement template: docs taxonomy: category: docs routes: - default: '/help-me' + default: '/asking_for_help_efficiently' --- Bien que les personnes contribuant à YunoHost essaient continuellement de l'améliorer, YunoHost, ses packages ou sa documentation ne sont exempts de bugs ou d'erreurs. Pour nous aider à vous aider, vous devez cependant suivre ces instructions. diff --git a/pages/07.help/help.it.md b/pages/05.community/12.asking_for_help_efficiently/help.it.md similarity index 97% rename from pages/07.help/help.it.md rename to pages/05.community/12.asking_for_help_efficiently/help.it.md index 0ec51222..cb464768 100644 --- a/pages/07.help/help.it.md +++ b/pages/05.community/12.asking_for_help_efficiently/help.it.md @@ -1,10 +1,10 @@ --- -title: Aiuto +title: Asking for help efficiently template: docs taxonomy: category: docs routes: - default: '/help-me' + default: '/asking_for_help_efficiently' --- Nonostante i collaboratori di YunoHost cerchino continuamente di migliorarlo, YunoHost e la sua documentazione non sono esenti da bug o errori. Per aiutarci ad aiutarvi, dovreste seguire queste istruzioni. diff --git a/pages/07.help/help.md b/pages/05.community/12.asking_for_help_efficiently/help.md similarity index 98% rename from pages/07.help/help.md rename to pages/05.community/12.asking_for_help_efficiently/help.md index a35fe2ef..3fb64ca9 100644 --- a/pages/07.help/help.md +++ b/pages/05.community/12.asking_for_help_efficiently/help.md @@ -1,10 +1,10 @@ --- -title: Help me +title: Asking for help efficiently template: docs taxonomy: category: docs routes: - default: '/help-me' + default: '/asking_for_help_efficiently' --- Even though YunoHost contributors try to continuously perfect it, YunoHost itself, its packages or this documentation are not free from bugs or flaw. To let us help you, however, you need to follow these guidelines.