English version
We are glad to announce the release of YunoHost 12 !
This release brings your servers to Debian 12 Bookworm, and ships an upgrade of the webadmin, an overhaul of the User portal and SSO (Single Sign On) system.
yes, that took some time⊠But it was worth it!
Shortcuts to : Installation procedure, Upgrade procedure
Major changes
- YunoHost now depends on Debian 12
- The user portal and SSO (Single Sign On) system have been split into three distinct pieces:
- SSOwat now only manages the SSO/ACL logic (as a nginx Lua middleware)
yunohost-portal-api
: A new âportal APIâ service delivering authentication cookies and allowing users to retrieve/update infosyunohost-portal
: A new login and homepage web portal
- Simplified subdomain addition during app install (they can now be installed with a Letâs Encrypt certificate directly from the app install form instead of going through dozens of clicks)
- The installation script has been reworked with a simpler flow and UI (instead of the old ncurses/whiptail)
- The base YunoHost setup is now lighter:
- MySQL/MariaDB and PHP are not installed by default anymore (apps will explicitly depend on them hence everything gets installed only when needed)
- The email antispam (Rspamd) and the XMPP server (Metronome) are not part of the core anymore. Instead, they have become separate applications: see Rspamd and Metronome
- Under the hood, the webadmin was migrated to Vue3 and Typescript
Regarding the new user portal
- The portal and authentication mechanism are now separated in terms of âmain domainsâ. For example,
foo.tld
andsub.foo.tld
share the same portal, butbar.tld
andapp.bar.tld
share a second, different portal - Users can only access a portal if they have access to at least one app of that âmain domain treeâ, or if they are admin
- The new portal include app logos, descriptions, and an optional âsearch engineâ bar.
- The new portalâs appearance can be customized from the webadmin in the corresponding âmain domainâ's setting (such as changing the portal name, logo, default theme, custom message, âŠ). Each user can also pick the theme in their own settings page.
- Note that if you themed the old portal, this theming wonât be magically migrated to the new portal
- New option to make the list of public apps browsable by visitors
- The old âyunohost tile overlayâ doesnât exist anymore
- It is technically possible to write a completely different and independent user portal (as long as it properly interacts with the portal API)
Regarding the YunoHost Terms of Services
Upon installing or upgrading to YunoHost 12, you will be prompted to accept the YunoHost Terms of Services.
The intent of this document is to clarify and be more transparent regarding services run by the YunoHost project, which your server may depend on, as well as the people making YunoHost happen, being either code or support contributors.
The document can be found at General and Specific Conditions of Services operated by the YunoHost project | Yunohost Documentation and includes a âshortâ TL;DR.
We want to thank the numerous people who helped make this release possible by adapting apps, testing the 12.0 version and migration and providing precious feedback on the forum, chat and elsewhere !
Core and translation contributors: alexAubin, Ali Ăırçır, AndrĂ© ThĂ©o Lauret, Axolotle, Ayoub Bellahbib, Bram, ButterflyOfFire, Carlos SolĂs, chri2, Chris Vogel, Christian Wehrli, cjdw, clecle226, craftrac, cristian amoyao, cube, Emmanuel Averty, Ăric Gaspar, Eric Geldmacher, Eryk Michalak, Ătienne Deparis, FĂ©lix PiĂ©dallu, Florent, Florian, Francescc, Grzegorz Cichocki, Ilya, Ivan Davydov, Jinx, John Hackett, John Schmidt, Jorge-vitrubio, JosĂ© M, Jose Riha, JosuĂ© Tille, Kayou, Krakinou, Krzysztof Nowakowski, Kuba Bazan, lapineige, Lasse Gismo, liimee, ljf, manor-tile, massyas, mathieuw, Mer, Metin Bektas, mh4ckt3mh4ckt1c4s, motcha, Neko Nekowazarashi, Nicolas Palix, oleole39, OniriCorpe, orhtej2/Mateusz, Pierre de La Morinerie, Poesty Li, ppr, QuentĂ, rosbeef andino, Saeba Ryo, Sebastian Gumprich, selfhoster1312, stanislas, sudo, Suleyman Harmandar, taco, Tagada, Tharyrok, Thatoo, theo-is-taken, Thomas, tituspijean, Tommi, Tymofii-Lytvynenko, xabirequejo, xaloc33, Yann Autissier, YapWC, yolateng0, Zwiebel
How to install
You can deploy YunoHost 12 / Bookworm on a fresh server using the regular install documentation:
- on an x86 (amd64 or i386) computer
- on a Raspberry Pi
- on other ARM boards
- on top of a fresh Debian 12 / Bookworm
How to upgrade
If you are hosting critical production services, you might want to wait for the first minor iteration of this version, that will be more polished.
Before upgrading, please check that all the apps you use are supported by Bookworm. A nice way to check that is via the app maintainer dashboard.
Also, you need to be on the latest YunoHost 11.3 version to have the migration available, so please upgrade your system as you would normally (via the Web Admin or the command line).
From the web admin
- Go into âToolsâ > âMigrationsâ. If no migration is available, please upgrade your system.
- Read attentively the migration message, and once you agree to everything, tick the box and click on the green button!
- This may take several minutes, grab your favorite beverage. You will need to re-log into the webadmin once itâs done.
- As a known issue : it is possible that the webadmin displays an âerror 500â. Do not be too spooked an try refreshing the page.
- Once youâre back in, make sure that everything went well (green check ) in Tools > Logs. Check the follow-up migrations in Tools > Migrations.
Or from the command line
Ensure you are on the latest YunoHost 11.3 version:
$ sudo yunohost tools update
$ sudo yunohost tools upgrade system
Then run the migration and accept the message:
$ sudo yunohost tools migrations run
More details can be found on the documentation.
Notes for advanced users
Configurations for SSH, nginx and postfix were updated. You must make sure to manually propagate the changes if you tweaked those. Please check the diff using
yunohost tools regen-conf ssh nginx postfix --dry-run --with-diff
.
After installation or upgrade
Please ensure everything works as intended. An FAQ on general issues is present on the documentation.
Also, please report us any issue you have (and, how you solved it) so that we can add it to the FAQ or find a way to fix the issues for everybody else!
Specifically, the rework of the SSO might have broken some apps relying on âBasic Authâ and may need some ironing on our side. If you see any anormal authentication issues, please make us know!
Other project news
As always, there is a lot going on behind the scene, and a lot of improvements accross various aspects of the project since version 11.0 two years ago! Just on the YunoHost âcoreâ repositories, 100.000 lines were changed and a hundred people contributed ⊠and thatâs not even looking at the app repositories!
The app packaging format was improved with the new âv2â format that brings many UI/UX improvements (such as pre/post install notifications) while being more robust and easier for packagers to implement. Against all odds, the entirety of the catalog was converted in about a year to this new format, thanks to the meticulious work of the packaging team! Since two years ago, about 150 new apps were added to the catalog to reach a whooping ~500 total apps available!
Note that the new packaging format also allows us to have semi-automagic upgrades to pull changes from the upstream, helping contrib to keep the catalog up to date (though we still need to manually test/validate each upgrade).
A new tool, the App Generator was developped to make writing the boilerplate of a new package easier.
A year ago, we launched our new, awesome app store! Donât forget that you can vote (star, favorite, however you want to call it!) for apps youâre interested in. These votes are super helpful for letting us know which apps deserve a bit more love. Plus, you can propose and vote for apps that arenât yet in the catalog on the wishlist. (Just log in with your YunoHost forum account; we do reserve the right to reject certain apps.)
This past month, the YunoHost infrastructure was fully migrated to a new, powerful dedicated server, provided by our friends at Globenet! It should ease out the maintenance of our infrastructure cost while providing us with more margins for our automated tests.
Last but not least, we have just released our new reworked landing page for the YunoHost project, which we hope will give a fresh look to the project (less nerdy, more flowery?) and provide a more straightforward explanation of what YunoHost is and how to get started.
Finally, we plan to write another post in the coming weeks to detail the project roadmap and release our budget report to be more transparent about the way we use your donations. Of course, in the meantime, you can keep supporting the project via our donation platform !
Version française
Nous sommes heureux dâannoncer la sortie de YunoHost 12 !
Cette version met Ă jour vos serveurs vers Debian 12 Bookworm et propose une mise Ă niveau de lâinterface web, ainsi quâune refonte du portail utilisateur et du systĂšme SSO (Single Sign On).
oui, cela a pris du temps⊠Mais ça en valait la peine !
Raccourcis vers : ProcĂ©dure dâinstallation, ProcĂ©dure de mise Ă niveau
Changements majeurs
- YunoHost dépend maintenant de Debian 12
- Le portail utilisateur et le systÚme SSO (Single Sign On) ont été découpés en trois logiciels distincts :
- SSOwat gĂšre maintenant uniquement la logique SSO/ACL (en tant que middleware Lua nginx)
yunohost-portal-api
: Un nouveau service dâAPI pour le portail fournissant les cookies dâauthentification et permettant aux utilisateurices de rĂ©cupĂ©rer/mettre Ă jour leurs informationsyunohost-portal
: Un nouveau portail web de connexion et de page dâaccueil
- Un ajout simplifiĂ© de sous-domaines lors de lâinstallation dâapplications (ils peuvent maintenant ĂȘtre configurĂ©s avec un certificat Letâs Encrypt directement depuis le formulaire dâinstallation au lieu de passer par des dizaines de clics)
- Le script dâinstallation a Ă©tĂ© retravaillĂ© avec un flux et une interface utilisateur plus simples (au lieu de lâancien ncurses/whiptail)
- La configuration de base de YunoHost est maintenant plus légÚre :
- MySQL/MariaDB et PHP ne sont plus installĂ©s par dĂ©faut (les applications dĂ©pendront explicitement dâeux, donc tout sera installĂ© uniquement au besoin)
- Lâantispam pour email (Rspamd) et le serveur XMPP (Metronome) ne font plus partie du cĆur. Ils sont devenus des applications sĂ©parĂ©es : voir Rspamd et Metronome
- En interne, lâinterface web a Ă©tĂ© migrĂ©e vers Vue3 et TypeScript
Ă propos du nouveau portail utilisateur
- Le portail et le mĂ©canisme dâauthentification sont dĂ©sormais sĂ©parĂ©s par âdomaine principauxâ. Par exemple,
foo.tld
etsub.foo.tld
partagent le mĂȘme portail, maisbar.tld
etapp.bar.tld
partagent un second portail diffĂ©rent - Les utilisateurices ne peuvent accĂ©der Ă un portail que sâils ont accĂšs Ă au moins une application de cet âarbre de domaine principalâ, ou sâils sont administrateurices
- Le nouveau portail inclut des logos dâapplication, des descriptions et une barre de recherche optionnelle.
- Lâapparence du nouveau portail peut ĂȘtre personnalisĂ©e depuis lâinterface web dans les paramĂštres du âdomaine principalâ correspondant (comme changer le nom du portail, le logo, le thĂšme par dĂ©faut, le message personnalisĂ©, âŠ). Chaque utilisateur peut Ă©galement choisir le thĂšme dans sa propre page de paramĂštres.
- Notez que si vous avez personnalisĂ© lâancien portail, cette personnalisation ne sera pas migrĂ©e vers le nouveau portailâŠ
- Une nouvelle option pour rendre la liste des applications publiques consultable par les visiteur·e·s
- Lâancien âoverlay de tuiles yunohostâ nâexiste plus
- Il est techniquement possible dâĂ©crire un portail utilisateur complĂštement diffĂ©rent et indĂ©pendant (tant quâil interagit correctement avec lâAPI du portail)
Concernant les Conditions de Service de YunoHost
Lors de lâinstallation ou de la mise Ă niveau vers YunoHost 12, vous serez invitĂ© Ă accepter les Conditions de Service de YunoHost.
Lâobjectif de ce document est de clarifier et dâĂȘtre plus transparent concernant les services gĂ©rĂ©s par le projet YunoHost, dont votre serveur peut dĂ©pendre, ainsi que les personnes qui font vivre YunoHost, quâil sâagisse de contributeurices de code ou de support.
Le document est disponible Ă lâadresse General and Specific Conditions of Services operated by the YunoHost project | Yunohost Documentation et inclut un rĂ©sumĂ© âcourtâ.
Nous tenons à remercier les nombreuses personnes qui ont aidé à rendre cette version possible en adaptant des applications, testant la version 12.0 et la migration, et en fournissant des retours précieux sur le forum, le chat et ailleurs !
Contributeurs principaux et en traduction : alexAubin, Ali Ăırçır, AndrĂ© ThĂ©o Lauret, Axolotle, Ayoub Bellahbib, Bram, ButterflyOfFire, Carlos SolĂs, chri2, Chris Vogel, Christian Wehrli, cjdw, clecle226, craftrac, cristian amoyao, cube, Emmanuel Averty, Ăric Gaspar, Eric Geldmacher, Eryk Michalak, Ătienne Deparis, FĂ©lix PiĂ©dallu, Florent, Florian, Francescc, Grzegorz Cichocki, Ilya, Ivan Davydov, Jinx, John Hackett, John Schmidt, Jorge-vitrubio, JosĂ© M, Jose Riha, JosuĂ© Tille, Kayou, Krakinou, Krzysztof Nowakowski, Kuba Bazan, lapineige, Lasse Gismo, liimee, ljf, manor-tile, massyas, mathieuw, Mer, Metin Bektas, mh4ckt3mh4ckt1c4s, motcha, Neko Nekowazarashi, Nicolas Palix, oleole39, OniriCorpe, orhtej2/Mateusz, Pierre de La Morinerie, Poesty Li, ppr, QuentĂ, rosbeef andino, Saeba Ryo, Sebastian Gumprich, selfhoster1312, stanislas, sudo, Suleyman Harmandar, taco, Tagada, Tharyrok, Thatoo, theo-is-taken, Thomas, tituspijean, Tommi, Tymofii-Lytvynenko, xabirequejo, xaloc33, Yann Autissier, YapWC, yolateng0, Zwiebel
Comment installer
Vous pouvez dĂ©ployer YunoHost 12 / Bookworm sur un serveur frais en utilisant la documentation dâinstallation classique :
- sur un ordinateur x86 (amd64 ou i386)
- sur un Raspberry Pi
- sur dâautres cartes ARM
- au-dessus dâun Debian 12 / Bookworm frais
Comment mettre Ă niveau
Si vous hĂ©bergez des services de production critiques, vous voudrez peut-ĂȘtre attendre la premiĂšre itĂ©ration mineure de cette version, qui sera plus soignĂ©e.
Avant de procĂ©der Ă la mise Ă niveau, veuillez vĂ©rifier que toutes les applications que vous utilisez sont compatibles avec Bookworm. Une bonne façon de le vĂ©rifier est via le tableau de bord des mainteneurs dâapplications.
Vous devez aussi ĂȘtre sur la derniĂšre version de YunoHost 11.3, donc mettez dâabord Ă jour votre serveur comme vous le feriez normalement (via la Webadmin ou la ligne de commande).
Depuis lâinterface web
- Allez dans âOutilsâ > âMigrationsâ. Si aucune migration nâest disponible, mettez Ă jour votre systĂšme.
- Lisez attentivement le message de migration, et une fois que vous ĂȘtes dâaccord, cochez la case et cliquez sur le bouton vert !
- Cela peut prendre plusieurs minutes, servez-vous votre boisson prĂ©fĂ©rĂ©e ! Vous devrez vous reconnecter Ă lâinterface web une fois cela fait.
- En raison dâun problĂšme connu : il est possible que lâinterface affiche une âerreur 500â. Nâayez pas peur, essayez de rafraĂźchir la page.
- Une fois que vous ĂȘtes de nouveau connectĂ©, assurez-vous que tout sâest bien passĂ© (coche verte ) dans Outils > Journaux. VĂ©rifiez les migrations en cours dans Outils > Migrations.
Ou depuis la ligne de commande
Mettez Ă jour vers la derniĂšre version de YunoHost 11.3 :
$ sudo yunohost tools update
$ sudo yunohost tools upgrade system
Puis lancez la migration et acceptez le message :
$ sudo yunohost tools migrations run
Plus de dĂ©tails peuvent ĂȘtre trouvĂ©s dans la documentation.
Notes pour les utilisateurs avancés
Les configurations pour SSH, nginx et postfix ont été mises à jour. Vous devez vous assurer de propager manuellement les changements si vous les avez modifiés. Veuillez vérifier la différence en utilisant
yunohost tools regen-conf ssh nginx postfix --dry-run --with-diff
.
AprĂšs lâinstallation ou la mise Ă niveau
Veuillez vous assurer que tout fonctionne comme prévu. Une FAQ sur les problÚmes généraux est présente dans la documentation.
Enfin, veuillez nous signaler tout problĂšme que vous rencontrez (et comment vous lâavez rĂ©solu) afin que nous puissions lâajouter Ă la FAQ ou trouver un moyen de corriger les problĂšmes pour tout le monde !
En particulier, la refonte du SSO pourrait avoir cassĂ© certaines applications sâappuyant sur âBasic Authâ et pourrait nĂ©cessiter des ajustements de notre part. Si vous constatez des problĂšmes dâauthentification anormaux, faites-le nous savoir !
Autres nouvelles du projet
Comme toujours, il se passe beaucoup de choses en coulisses, et de nombreuses amĂ©liorations ont Ă©tĂ© apportĂ©es dans divers aspects du projet depuis la version 11.0 il y a deux ans ! Rien que sur les dĂ©pĂŽts âcoreâ de YunoHost, 100 000 lignes ont Ă©tĂ© modifiĂ©es et une centaine de personnes ont contribué⊠et cela sans mĂȘme regarder les dĂ©pĂŽts dâapplications !
Le packaging des applications a Ă©tĂ© amĂ©liorĂ© avec le nouveau âformat v2â qui apporte de nombreuses amĂ©liorations UI/UX (comme des notifications prĂ©/post installation) tout en Ă©tant plus robuste et plus facile Ă mettre en Ćuvre pour les packagers. Contre toute attente, la totalitĂ© du catalogue a Ă©tĂ© convertie en environ un an Ă ce nouveau format, grĂące au travail mĂ©ticuleux de lâĂ©quipe de packaging ! Depuis deux ans, environ 150 nouvelles applications ont Ă©tĂ© ajoutĂ©es au catalogue pour atteindre un impressionnant ~500 applications disponibles !
Notez que le nouveau format de packaging nous permet Ă©galement dâavoir des mises Ă niveau semi-automagiques pour rĂ©cupĂ©rer les changements en amont, aidant ainsi Ă maintenir le catalogue Ă jour (bien que nous devions toujours tester/valider manuellement chaque mise Ă niveau).
Un nouvel outil, le GĂ©nĂ©rateur de paquets a Ă©tĂ© dĂ©veloppĂ© pour simplifier lâĂ©criture du squelette dâune nouvelle appli.
Il y a un an, on lançait notre superbe app store ! Nâoubliez pas que vous pouvez voter (mettre une Ă©toile, un favori, peu importe le terme !) pour les applications qui vous intĂ©ressent. Ces votes permettent aux contributeurices dâorienter leurs efforts sur les applis qui mĂ©ritent une attention particuliĂšre. De plus, vous pouvez proposer et voter pour des applis qui ne sont pas encore dans le catalogue via la wishlist. (Pour cela, connectez-vous avec votre compte du forum YunoHost ; et on se rĂ©serve le droit de refuser certaines applis.)
Ce mois dernier, lâinfrastructure YunoHost a Ă©tĂ© entiĂšrement migrĂ©e vers un nouveau serveur dĂ©diĂ© puissant, fourni par nos amis de Globenet ! Cela devrait allĂ©ger les coĂ»ts de maintenance de notre infrastructure tout en nous offrant plus de marges pour nos tests automatisĂ©s.
Enfin, nous venons de lancer notre nouvelle page dâaccueil retravaillĂ©e pour le projet YunoHost, que nous espĂ©rons donner un nouveau look au projet (moins geek, plus fleuri ?) et fournir une explication plus simple de ce quâest YunoHost et comment commencer.
Enfin, nous prĂ©voyons dâĂ©crire un autre post dans les semaines Ă venir pour dĂ©tailler la feuille de route du projet et publier notre rapport budgĂ©taire pour ĂȘtre plus transparent sur la façon dont nous utilisons vos dons. Bien sĂ»r, entre-temps, vous pouvez continuer Ă soutenir le projet via notre plateforme de dons !