SUSE Support

Here When You Need Us

Setting the resolution or character size for boot and text consoles on SLE 12 and newer

This document (7017979) is provided subject to the disclaimer at the end of this document.


SUSE Linux Enterprise Server or Desktop versions 12 and newer.


The auto-detected text based resolution during boot and at text consoles (terminal/tty1-6) may not be optimal and needs to be changed.


Grub2 provides settings for the initial screen resolution.  A kernel parameter can also be added for the KMS (kernel mode setting) resolution.  If the auto-detection of the native resolution is not correct it would be appropriate to use both of these settings (grub2 and kernel parameter).

Both the grub2 settings and the kernel parameter can be added to the grub2 boot loader configuration.  Follow these steps as the root user to make the changes:

Edit /etc/default/grub

Locate this line:
Change it to the desired resolution.  Lets use an example of 1280x1024:

Look for this entry.  If it doesn't exist add it under the GRUB_GFXMODE setting:

For the kernel parameter locate the line that begins with:
Go to the end of that line and add this entry (again using 1280x1024 as an example):
The full line would look similar to this:

GRUB_CMDLINE_LINUX_DEFAULT="resume=/dev/disk/by-uuid/0e618837-2b33-4ed1-ba0d-ec8b1dfad196 splash=silent quiet showopts crashkernel=97M,high crashkernel=72M,low video=1280x1024"

Save the file then run the following command to write the changes to the grub2 bootloader configuration:

grub2-mkconfig -o /boot/grub2/grub.cfg

Reboot the system to have the changes take effect.


Additional Information

For systems that are also running a graphic desktop these settings should have no affect on the graphic resolution.

In some cases KMS being enabled causes trouble with the graphic desktop.  This is common in VM's and in situations where the hardware is not properly detected for some reason.  This may result in adding the kernel parameter "nomodeset" which disables the kernel KMS.  In that case the kernel parameter mentioned above "video=1280x1024" (or whatever the desired resolution is) should not be added.  KMS is already disabled and will not change the resolution set by the GRUB_GFXMODE setting.
For those that are familiar with the "vga=" parameter used in earlier kernel versions, this setting is depreciated and should no longer be used.  It will still work if KMS is disabled but is no longer the preferred method and will be removed eventually.


This Support Knowledgebase provides a valuable tool for SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented "AS IS" WITHOUT WARRANTY OF ANY KIND.

  • Document ID:7017979
  • Creation Date: 24-Aug-2016
  • Modified Date:03-Mar-2020
    • SUSE Linux Enterprise Desktop
    • SUSE Linux Enterprise Server

< Back to Support Search

For questions or concerns with the SUSE Knowledgebase please contact: tidfeedback[at]

SUSE Support Forums

Get your questions answered by experienced Sys Ops or interact with other SUSE community experts.

Support Resources

Learn how to get the most from the technical support you receive with your SUSE Subscription, Premium Support, Academic Program, or Partner Program.

Open an Incident

Open an incident with SUSE Technical Support, manage your subscriptions, download patches, or manage user access.