Cheat Codes

From Knoppix Documentation Wiki
Revision as of 15:04, 21 December 2004 by Kyle (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

German Version: Cheat CodesDeutsch / French Version: Cheat CodesFrench / Versión español: Cheat CodesSpanish

Cheatcodes are used to pass values to KNOPPIX, to help with getting it working on difficult hardware. You type them into the boot screen, shown to the left, and press enter/return. The format is "kernel opt opt opt ...". Usually "knoppix" is the right selection for the "kernel", options as listed below (in Gnoppix is Credativ).

Example: "knoppix xvrefresh=60 noscsi floppyconfig"

You can type more than one cheatcode before press enter (i.e. knoppix lang=us knoppix xmodule=fbdev).


specify language/keyboard

You can click on to see the two-letters code meanings.

For example, typing knoppix lang=us you change the keyboard/language to US english.

If you don´t change the keyboard, in the default DE-bootimage, Knoppix boots with the german keyboard layout (i.e. '=' letter is located at Shift-0 at this keyboard). Print the german keyboard layout for your reference.

specify only console keyboard

specify [Xfree86 X] keyboard

Do NOT use SCSI-Emulation for IDE CD-Roms - Knoppix V3.4 and later

Use specified WM instead of KDE

Use specified Screen resolution for X

xvrefresh=60 or vsync=60 
Use 60 Hz vertical refresh rate for X

xhrefresh=80 or hsync=80 
Use 80 kHz horizontal refresh rate for X

Use specified X-Server

Use specified XFree4-Module

The mouse is a wheelmouse - not needed since 2003-04-15

Regular PS/2 mouse - 2003-04-15 and after.

Runlevel 2, Textmode only

myconfig=scan or floppyconfig or floppyconf (in recent versions) 
Run from a floppy. The "floppyconfig" option allows you to reconfigure the system after autoconfig, or install your own config files, by mounting a floppy disk and running a bourne shell script called from the root directory on this floppy. There is a GUI to create such a configuration floppy disk calles "saveconfig" (also located in the KDE menu under "KNOPPIX", but experts also know how to do this by creating their own shellscripts. The configuration with network and graphics setup are stored in configs.tbz. A file called, if located in the toplevel KNOPPIX directory on CD, will also be executed at startup. This makes it easier to create customized versions without having to change anything on the compressed filesystem KNOPPIX/KNOPPIX.

Run "" from a partition - Knoppix V3.4

myconf=scan (or config=scan) 
Try to find "" automatically - Knoppix V3.4

noapic noagp noapm nodma nomce nofirewire nopcmcia noscsi noswap nousb nosmp noaudio 
Skip parts of Hardware-detection, In case of a failing hardware autodetection, try booting with any of the "no-" options as shown in the table above, like in knoppix noagp noapm noapic nodma nopcmcia noscsi nousb to skip some critical parts of the autodetection system. The "noswap" option is useful for a forensic analysis without touching existing swap partitions.

Notebook if PS/2 mouse doesn't work, Try "knoppix pci=irqmask=0x0e98" if (you have a notebook and) your PS/2 mouse doesn't work. (Possibly caused by a BIOS-flaw on your board.)

ide2=0x180 nopcmia 
boot from PCMIA-CD (Transmeta notebooks)

Will force the use of the BIOS assigned Interrupt ReQuests on the PCI bus. Possible cure for non-functioning hardware. Very handy for unruly IRQ conflicts. Look at dmesg and cat /proc/pci to find out if you have any such troubles..

Specify Memory size in MByte, Some Boards apparently don't pass the proper memory size to the linux-kernel. It may cause the message "Panic cannot mount root file system" and the system hangs. Use "knoppix mem=128M" to solve that problem if your system has 128MByte memory for example (caution you MUST use a capital "M" here).

Do NOT eject CD after halt

Its especially useful in combination with noeject. With noprompt, Knopix won't eject the CD and ask for a keypress. It was a much asked feature some time ago. Version 2003-09-22 and later.

skip dhcp/network broadcast detection

It shows the upper half of the KDE splash-screen, while booting up. You can press Esc anytime to see all the messages. Ever wanted to hide those cryptic messages? Version 2003-09-22 and later.
  • New in 3.4: Animations (see for yourself) and the ability to press any key.

This cheatcode allows you to insert a floppy disk with additional modules, for example USB-stick or similar. Yes, its also possible with "expert", but there you loose the automatic configuration afterwards. Version 2003-09-22 and later.

Copy CD to RAM and run from there. Version 2003-09-05 and later.

You can now do a "poor mans install" on vfat and ext2-Partitions with, knoppix tohd=/dev/hda1 Version 2003-09-22 and later.

With this cheatcode the CD-Roms are ignored, so you can finally boot your "poor mans install" with just the original cdrom. Version 2003-09-05 and later. note - Cheatcode "toram" and "fromhd" work now together. Usage fromhd=/dev/hda1.

Access Image then boot from previously copied CD-Image (enables booting from NTFS / ReiserFS) - Knoppix V3.4

Access image, boot from ISO-Image. - Knoppix V3.4

NOTE: bootfrom needs access to a running Knoppix-System with the same Kernel as the Bootkernel, before it is able to mount the partition / ISO-Image. This should allow a poor mans install from NTFS-Partitions and makes it also possible to boot an ISO-Image directly. You can also use wildcards in the ISO-Filename, but it must be unique. So: If you have just one KNOPPIX.iso on /dev/hda1 you can access it as: bootfrom=/dev/hda1/K*.iso, but if there are several, you need to make clear, which one you want. (Feature added by Fabian Franz.)
CAUTION: The 2.4 kernel that is in the KNOPPIX 3.4 CD does not support the ext3 filesystem so make sure that the ISO is stored in an ext2 filesystem.

Hardware clock is set to GMT/UCE

No-framebuffer mode, but X

50-line TEXT mode

enable DMA for all IDE drives

Set home directory. 'scan' will search for knoppix.img in the root of all partitions. To create a home directory, go K-menu -> Knoppix -> Configure -> Create persistant home directory. Be carefull when creating the home-dir, Do NOT use the entire partition unless you know what you are doing. Other options could be, home=/dev/hda1/knoppix.img home=/mnt/hda1/knoppix.img . If you are using a USB memory stick type home=/dev/sda1/knoppix.img but home=scan will probably do.

Start Braille-Terminal (no X)

Parameters for Braille device.

For more information on brltty parameters see

Autoconfigure alsa for an pci-soundcard

Configure alsa for the snd-es1938.o-module pci-soundcard

Check CD data integrity, If your KNOPPIX CD makes strange noises during boot, or you see frequent errors like "cloop read error", or programs on your KDE desktop keep crashing randomly, then your CD image is probably defective or incomplete, or your CD-burner created a defective CD due to wrong writing speed or bad media. This is the most common error reported. Please boot with "knoppix testcd" to check if the CD is OK, and/or even better, verify the MD5 checksums that are present on the mirrors before writing the CD. Also, please read the KNOPPIX-FAQ.

No PnP Bios initialization

Disable ACPI Bios completely

Workaround for bad PCI controllers

Directory to search for on the CD.

Cloop-File to search for on the CD.


Default settings

Boot the 2.6 kernel for use with the new Knoppix 3.4 and 3.4 c't Edition.

knoppix26 acpi=off  
Disable ACPI configuration in Kernel 2.6

No framebuffer at startup

fb1280x1024 or fb1024x768 or fb800x600 
Use fixed framebuffer graphics

Boot with (almost) no hardware detection

Interactive setup for experts, The "expert" mode provides a very simple and not yet well tested interface to loading additional Kernel modules from floppy disks (ext2 or vfat), plus interactive configuration of mouse/keyboard/soundcard/xserver. "expert" mode supports the same boot options as "knoppix".

The same as above only with 2.6 kernel - Knoppix V3.4

knoppix -b 
Quick-n-dirty boot, almost no HW detection, only 1 VT; hit enter at root-password prompt and start typing commands. Good if you just need to fdisk IDE devices, activate a different partition for booting, DD stuff, and you are planning on rebooting Real Fast after you're done. You can actually Alt-SysRQ-B safely ie. immediate reboot w/o worrying about shutting down nicely or anything, because nothing is mounted r/w at ALL - not even swap. Also works on other Linux distros.

Run memtest86 instead of Linux - Knoppix V3.4


If you have an old (VGA) monitor and get only flickering with the defaults, try "knoppix-txt xvrefresh=60" or "fb800x600"
Most of the boot options are parsed in /etc/init.d/knoppix-autoconfig and the rest is found in /KNOPPIX/boot.img -> miniroot.gz -> linuxrc.


Updated for Knoppix 3.1 2003-01-05

Updated for Knoppix 3.2 
desktop=gnome is no longer available... (use Gnoppix).

See also: