Hello everyone!
following the successful experience we had for YunoHost 2.5, we invite you to test with us the BETA release 2.6!
Our process is designed to increase the quality of Yunohost and ensure smooth evolution of the software. To achieve this, new features and bugfixes are carefully reviewed by several contributors before being accepted. To go even further, before releasing the new version as ‘stable’, we propose to open a public beta-test so that you can give us feedback and report bugs!
The beta period is also a good time to contribute to the translation!
Therefore, if you are an advanced user or have translation skills, you can help YunoHost !
Since we do core review and testing before merging code modications, you should have a pretty stable version in result (no critical bug), but expect to have (small) bugs (that’s the point :p).
The 2.6 includes many important security fixes and improvement for SSOwat.
On the app side : many new helpers have been added to help the packaging ; app scripts are now ran as root
; and apps now have the possibility to ship a script to change the domain/url on which they are installed.
On the core side, the mechanics to later have global settings have been introduced (this will help in the future to customize/configure your instance) ; the backup/restore have been optimized and preparations have been made to later include Borg ; DNSmasq is now really used and DNS resolution is now made using the FFDN’s and other friendly DNS resolvers (cf. this list) ; a script has been added to easily reset the admin password if you’re logged as root ; and nginx ciphers were updated following the Mozilla ‘intermediate’ compatibility recommendation. We also started adding unit/functionnal tests to help the development process and increase quality and stability !
Many other small fixes/improvements are included, as well as translations updates.
Thanks to every contributors and translators !
Major changes in 2.6
Yunohost
- [enh] Introduce global settings mechanism (#229)
- [enh] Refactor backup management to pave the way to borg (#275)
- [enh] Use ssl-cert group for certificates, instead of metronome (#222)
- [enh] Allow regen-conf to manage new files already present on the system (#311)
- [enh] Add unit test mechanism (#254)
- [enh] Include a script to reset admin password (#217)
- [enh] Set main domain as hostname (#219)
- [fix] Properly manage resolv.conf, dns resolvers and dnsmasq (#290)
- [enh] Update nginx ciphers according to Mozilla ‘intermediate’ compatibility recommendation (#259, #298) (Note for testers : we moved away from the ‘modern’ compatibility since it was too tight for some hardwares like phones with old Android versions)
- [enh] Allow apps to ship a script to change its url (#185)
- [enh] App scripts are now ran as
root
(#188) (i.e. no need to ‘sudo’ in app scripts) - New apps helpers:
-
ynh_normalize_url_path
(#234) -
ynh_package_remove
&ynh_package_autoremove
-
ynh_abort_if_errors
(#245) -
ynh_install_app_dependencies
(and remove) withequivs
(#247) -
ynh_use_logrotate
andynh_remove_logrotate
(#248) -
ynh_no_log
: (#230) ynh_clean_setup
-
ynh_replace_string
(#280) -
ynh_local_curl
(#288) -
ynh_secure_remove
(#281) -
ynh_setup_source
(#282) -
ynh_webpath_available
andynh_webpath_register
(#235) -
ynh_mysql_generate_db
andynh_mysql_remove_db
(#236) -
ynh_store_file_checksum
andynh_backup_if_checksum_is_different
(#286)
-
- Misc fixes, and many updates in the translations !
Yunohost-admin
- [enh] Display help text from manifest during app installation. (#152)
- [fix] Show version only when connected (#149)
- Many updates in the translations
SSOwat
- [enh] uses caching for hash to avoid heavy recalculation and process spawning (#84)
- [fix] Use a cryptographically secure source of randomness (#79)
- [fix] Use hmac_sha512 instead of md5 for cookie hashing. Don’t store the key in token anymore (#80)
- [fix] Don’t include IP in token (#81)
- [fix] Important security fix (issue 921 : CDA reveals arbitrary nginx cache content) (#82)
- [fix] Important security fix (issue 918 : Basic HTTP Authentication bypasses ACL) (#77)
- [fix] Fix tile not displayed when app is installed on root (#71)
- Many updates in the translations
Moulinette
- [fix] Use ordered dict for the actionmap cache (#136)
- [fix] Show positional arguments first in --help / usage (#138)
- Many updates in the translations
Full changelogs can be found here :
How to participate to the beta-testing
You can participate to the beta-testing using one of your YunoHost instance and using the testing
repository.
Before jumping in, you should be fully aware that a beta may contain bugs. You should not use this on critical infrastructure. We also recommend to set up a good backup solution (ideally daily, and remote).
Convert your instance to a beta instance
- Open a root terminal
sudo -i
- Update your instance
apt-get update && apt-get dist-upgrade
- Setup the testing repository in place of the stable repository
echo 'deb http://repo.yunohost.org/debian/ jessie stable testing' > /etc/apt/sources.list.d/yunohost.list
- Update and upgrade the instance
apt-get update && apt-get dist-upgrade
- Subscribe to this topic to be warned if there is a dangerous bug
N.B. : this testing version is a rolling beta, so your server won’t return automatically in stable mode after the publication.
Giving us feedback or reporting bugs
Please open a ticket on the bug tracker or come chat with us on the dev chatroom !
Return to the stable version
- Open a root terminal
sudo -i
- Setup the stable repository in place of the testing repository
echo 'deb http://repo.yunohost.org/debian/ jessie stable' > /etc/apt/sources.list.d/yunohost.list
- Update and upgrade the instance
apt-get update && apt-get dist-upgrade
N.B. : your version will only return on stable version after the publication of new stable packages.
Specific items to test
Here are some specific items that you can test
- install, remove and remove some applications to confirm everything works smoothly, and report any compability issue or unexpected behavior you encounter ;
- try to backup and remove some application or part of the system ;
- The debian package ‘resolvconf’ should now be installed, and ‘/etc/resolv.conf’ should point to 127.0.0.1 (i.e. dnsmasq). Please test that DNS resolution works smoothly, using commands like
host wikipedia.org
(should show the IP of wikipedia) ; - You can test to reset the admin password using the new script : run
yunohost-reset-ldap-password
and follow instructions. Then make sure that the administration password have effectively been changed ; - Try changing the main domain with
yunohost tools maindomain -n the.new.main.domain.tld
. The hostname should automatically be changed to the new main domain. You can make sure of this by typinghostname
. This should also be the case after a fresh postinstall. -
yunohost service regen-conf
should not show any message such asconf /foo/bar.conf is not managed yet and won't be updated
. - If you know about app packaging, try the new helpers.
How to contibute to the translation
This beta is also a good occasion to participate to the translation of YunoHost. As any other translation work, you can have fun by translating the various messages and texts into your language, such that non-technical end-user may be able to use YunoHost easily!
Where do I go?
The translation process is ongoing here: https://translate.yunohost.org/
Feel free to create an account to start working!
Remember:
- a good translation percentage doesn’t means it’s perfect, a review is always welcomed!
- do your best to keep the minimum English words so the content is accessible to non-geek and non-technical users,
- create issues on http://dev.yunohost.org if you notice errors in English content or approximative content,
- don’t translate if you’re not a native speaker or at least fluent, or ask someone you know for review, good writing is difficult.
What needs to be translated?
- The web administration interface (yunohost-admin)
- The command-line core (moulinette and yunohost)
- The single sign-on (SSOWat)
See the different projects here : https://translate.yunohost.org/projects/yunohost/
What’s the status for my language?
See here: https://translate.yunohost.org/languages/
How can I get notified if something changes?
Weblate has many RSS or email alerts possibilities. Please have a look in your profile.
Other ways to contribute
Feel free to check out all the other ways you can contribute to the Yunohost project on this page !