qubes-doc/developer/releases/3_1/release-notes.rst
Marek Marczykowski-Górecki b93b3c571e
Convert to RST
2024-05-21 20:59:46 +02:00

96 lines
2.9 KiB
ReStructuredText

========================
Qubes R3.1 release notes
========================
New features since 3.0
----------------------
- Management Stack based of Salt Stack in dom0 -
:doc:`documentation </user/advanced-topics/salt>`
- Out of the box Whonix setup
- UEFI support
- LIVE edition (still alpha, not part of R3.1-rc1)
- Updated GPU drivers in dom0
- Colorful window application icons (instead of just colorful lock
icon)
- PV Grub support (:doc:`documentation </user/advanced-topics/managing-vm-kernels>`)
- Out of the box USB VM setup, including `handling USB mouse <https://github.com/QubesOS/qubes-app-linux-input-proxy/blob/master/README.md>`__
- Xen upgraded to 4.6, for better hardware support (especially Skylake
platform)
- Improve updates proxy flexibility - especially repositories served
over HTTPS
You can get detailed description in `completed github issues <https://github.com/QubesOS/qubes-issues/issues?q=is%3Aissue+sort%3Aupdated-desc+milestone%3A%22Release+3.1%22+label%3Arelease-notes+is%3Aclosed>`__
Known issues
------------
- Installation image does not fit on DVD, requires either DVD DL, or
USB stick (5GB or more)
- Windows Tools: ``qvm-block`` does not work
- Some icons in the Qubes Manager application might not be drawn
correctly when using the Xfce4 environment in Dom0. If this bothers
you, please use the KDE environment instead.
- USB mouse (in the case of USB VM) does not work at first system
startup (just after completing firstboot). Workaround: restart the
system.
- For other known issues take a look at `our tickets <https://github.com/QubesOS/qubes-issues/issues?q=is%3Aopen+is%3Aissue+milestone%3A%22Release+3.1%22+label%3Abug>`__
It is advised to install updates just after system installation to apply
bug fixes for (some of) the above problems.
Downloads
---------
See :doc:`Qubes Downloads </user/downloading-installing-upgrading/downloads>`.
Installation instructions
-------------------------
See :doc:`Installation Guide </user/downloading-installing-upgrading/installation-guide>`.
Upgrading
---------
From R3.0
^^^^^^^^^
The easiest and safest way to upgrade to Qubes R3.1 is to install it
from scratch and use :doc:`qubes backup and restore tools </user/how-to-guides/how-to-back-up-restore-and-migrate>` for migrating of all of the user VMs.
Users of Qubes R3.0 can upgrade using :doc:`experimental procedure </user/downloading-installing-upgrading/upgrade/3_1>`.
From R2 or earlier
^^^^^^^^^^^^^^^^^^
When upgrading from earlier versions the easiest and safest way is to
install it from scratch and use :doc:`qubes backup and restore tools </user/how-to-guides/how-to-back-up-restore-and-migrate>` for migrating of all of the user VMs.
Alternatively you can :ref:`upgrade to R3.0 using <developer/releases/3_0/release-notes:upgrading>` first, then follow
the instructions above. This will be time consuming process.