# :warning: This is a release candidate

Note that release candidates, due to the higher-than-usual amount of changes they contain, are statistically more likely to have a few quirks or bugs. Please refrain to use this version in critical production systems, unless it contains either a feature you really need, or a bugfix you've been waiting for, which may outweigh the potential drawbacks of using a release candidate.

This version will go stable in a few days if no regression is found.

# :bulb: Highlights

A lot of documentation landed in this version, such as [details about the access management](https://ovh.github.io/the-bastion/using/basics/access_management.html), [PIV keys support](https://ovh.github.io/the-bastion/using/piv.html), [SCP support](https://ovh.github.io/the-bastion/using/scp.html), [the HTTPS Proxy module](https://ovh.github.io/the-bastion/using/http_proxy.html). The reference of the [osh-http-proxy.conf](https://ovh.github.io/the-bastion/administration/configuration/osh-http-proxy_conf.html) file has also been published.

The following operating systems are no longer supported, as they've been EOL for quite a while. The code may continue to work, but these are no longer part of the tests:
- Debian 8
- Ubuntu 14.04
- OpenSUSE 15.0/15.1

# :pushpin: Changes

- OS support: drop EOL OSes: Debian 8, Ubuntu 14.04, OpenSUSE 15.0/15.1, add OpenSUSE 15.3
- feat: add admin and super owner accounts list in `info` plugin (#206)
- enh: replace bool 'allowUTF8' (introduced in rc1) by 'fanciness' enum
- enh: tests: refactor the framework for more maintainability
- fix: `setup-first-admin-account.sh`: support to add several admins (#202)
- fix: use local `$\_` before `while(<>)` loops
- doc: added a lot of new content
- doc: `clush`: document `--user` and `--port`
- doc: several other fixes here and there

# :fast_forward: Upgrading

- General upgrade instructions: [How to upgrade](https://ovh.github.io/the-bastion/installation/upgrading.html)
- Specific upgrade instructions: *Only if you're upgrading from rc1*: the `allowUTF8` option in `bastion.conf` has been renamed to `fanciness`. This is no longer a bool, but an enum. Replace `true` by `full` and `false` by `none`.