Audience: Admin

Boot Parameters

NeuralDrive supports several kernel command-line parameters to modify system behavior during the boot process.

Supported Parameters

ParameterDefaultDescription
neuraldrive.ssh=1unsetEnables the SSH server on boot. Required for remote management.
neuraldrive.safe=1unsetSafe Mode: Skips GPU detection and driver loading. Forces CPU inference.
neuraldrive.debug=1unsetEnables verbose logging during the entire boot sequence.
neuraldrive.ip=<IP>DHCPSets a static IP address for the primary network interface.
persistencesetEnables the persistence partition if detected on the USB media.
toramunsetLoads the entire system image into system RAM. Required for CD mode.
nomodesetunsetDisables Kernel Mode Setting (KMS), providing a generic VGA console.

How to Modify Parameters

One-time Modification

To temporarily add a parameter during boot:

  1. Reboot the system and wait for the GRUB menu to appear.
  2. Press e to edit the current boot entry.
  3. Locate the line starting with linux.
  4. Add your parameter(s) to the end of that line.
  5. Press Ctrl+X or F10 to boot with the modified parameters.

Permanent Modification

To permanently change boot parameters in a custom NeuralDrive image, you must modify the GRUB configuration template before generating the final ISO:

  1. Edit /boot/grub/grub.cfg in your source directory.
  2. Update the linux lines with your desired defaults.

Warning: Modifying the persistence parameter may result in data loss if not configured correctly for your target media.

Note: For issues related to system startup, consult the Boot Failures troubleshooting guide.