Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 0 additions & 22 deletions docs/edge.rst

This file was deleted.

22 changes: 22 additions & 0 deletions docs/hwe.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
###############
HWE ISO Images
###############

If you cannot boot or install Linux Mint because your hardware is too recent and is not properly detected, you may get better results with the "Hardware Enablement" ISO image.

In addition to its regular ISO images, Linux Mint sometimes provides an HWE ISO image for its latest release. This image ships with newer components to be able to support the most modern hardware chipsets and devices.

.. warning:: The HWE ISO image is not as stable as the other ISOs and may not support as many proprietary drivers. Only use it if you cannot boot or install with the other ISOs.

Latest HWE ISO image
---------------------

The latest HWE ISO image is `Linux Mint 22.3 Cinnamon HWE <https://www.linuxmint.com/hwe.php>`_.

It features the following upgraded components:

+--------------+-------+-----------+
| | 22.3 | 22.3 HWE |
+==============+=======+===========+
| Linux kernel | 6.14 | 6.17 |
+--------------+-------+-----------+
Binary file added docs/images/mintdrivers-2.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/mintdrivers.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/sysinfo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/sysinfo.png~
Binary file not shown.
2 changes: 2 additions & 0 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,9 @@ This Guide is not final. Content is being added slowly but surely :)
:maxdepth: 1
:caption: Drivers

nvidia
printers
hwe

.. toctree::
:maxdepth: 1
Expand Down
1 change: 1 addition & 0 deletions docs/mintupdate.rst
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,7 @@ Software updates aren't as important. They bring bug fixes or improvements which

In Linux Mint, kernel updates bring both security patches and bug fixes (and sometimes even new features), and they impact critical parts of the operating system. This makes kernel updates important from a security point of view, but also prone to regressions which can be hard to fix for novice users.

.. _kernal-updates:

Kernel updates
==============
Expand Down
104 changes: 104 additions & 0 deletions docs/nvidia.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
######################
Graphics Cards
######################

How to tell if my graphics cards have drivers already installed?
================================================================

Open up the *System Reports* program and navigate to System Information, Your graphics card and its driver should be listed.

.. image:: images/sysinfo.png

Alternatively, you can put ``LANG=C inxi -Gxxxc0`` into the *Terminal* program. There should be something in the ``driver:`` and something in the place of ``llvmpipe`` in ``renderer:``

If this is not the case for both, follow what is below.

AMD and Intel Cards
===================

All AMD drivers are bundled with Linux. You don't need to do anything unless it is a super recent piece of hardware, which you might need to :doc:`update your kernal for support <kernal-updates>` or install the :doc:`HWE version of Linux Mint <hwe>`.

For AMD cards, you may have to `upgrade the "amdgpu linux-firmware" <https://forums.linuxmint.com/viewtopic.php?t=424779#firmware>`_

NVIDIA Cards
============

These are not bundled with Linux and have to be installed separately. These instead will default to open-source drivers that may not work properly with your GPU.

.. note::

It is advised that you do not install NVIDIA drivers off of their website, as you will need to reinstall said drivers each time there is a kernal update.

How to install NVIDIA drivers
-----------------------------

How to access desktop
^^^^^^^^^^^^^^^^^^^^^

Restart, get to 'GNU GRUB 2.xx' screen by hitting Esc or holding shift.

.. hint::

UEFI systems press ``esc`` multiple times rapidly when the pc powers on

Legacy-BIOS systems press and hold ``shift`` for 8 seconds at least after powering on

.. image:: images/grub.png

This must done BEFORE you see a Mint logo or other OS logo on screen (ie - before handover to the operating system startup)

After this is done right, you should see a menu as pictured above.

**Once you see the GRUB menu:**

Press ``e`` to edit startup parameters.

This will let you boot in safe graphics mode.

Add ``nomodeset`` after the words "quiet splash" on the second last line of the set parameters black screen preceded by a single space.

Press F10 to boot up

This should now allow you to boot fully to a visible, usable desktop. From there, you can access the *Driver Manager*.

Using Driver Manager
^^^^^^^^^^^^^^^^^^^^^

Open up the *Driver Manager* program, and wait to see what drivers you will have to install.

Generally, you should install the recommended version of a driver.

.. image:: images/mintdrivers.webp

If you do not have internet, plug the USB (or DVD) you used to install Mint on into your computer and mount it inside of Driver Manager.

.. image:: images/mintdrivers-2.webp

After you install the driver, **Do not** reboot yet, Open up terminal and run the following,

.. code-block:: bash

sudo mokutil -i /var/lib/shim-signed/mok/MOK.der
mokutil --list-enrolled
sudo mokutil --test-key /var/lib/shim-signed/mok/MOK.der
sudo mokutil --enable-validation

.. warning::

At some point, It will ask you to create a password of minimum 8 characters.
**WRITE IT DOWN.**
When you reboot, you will likely have to choose ``enable MOK`` from a blue screen and have to input the password you put down, you can then reboot from the blue screen

Troubleshooting
===============

Have you

1. Checked your display ports and cables?
2. Done what's above troubleshooting first?
3. Checked if either DisplayPort or HDMI connections work?

If all else fails, `This guide <https://forums.linuxmint.com/viewtopic.php?t=424779>`_ from the Linux Mint Forums should help.

And if that doesn't work, Don't be afraid to ask! We are always willing to help!