Troubleshooting: Kali Linux VM Stuck on Installation

Kali Linux virtual machines often hang during installation due to ISO corruption, insufficient RAM allocation, or VirtualBox configuration errors. This guide resolves common stuck states by verifying the disk image integrity, adjusting memory settings, and correcting boot sequence parameters to ensure a smooth deployment process.

Verify ISO Integrity

The most frequent cause of an installation hanging at the initial loading screen is a corrupted or incomplete download. Kali Linux ISO files are large, typically exceeding 3 GB, which increases the risk of transmission errors. If you downloaded the file via a browser or a torrent client that interrupted the stream, the checksum will not match the official release. Always verify the SHA256 sum against the values provided on the official Kali website before attaching the ISO to your virtual machine. A mismatched hash indicates that the file is unreadable by the installer, causing the process to freeze indefinitely.

Adjust Virtual Machine Resources

Insufficient resources allocated to the virtual machine can cause the installer to stall, particularly if it runs out of memory while loading packages. By default, VirtualBox may assign only 1 GB of RAM, which is often too low for modern Kali versions. Navigate to the VM Settings, select the System tab, and increase the Base Memory to at least 4096 MB (4 GB). Additionally, ensure that the Processor section has at least two CPU cores assigned to allow the installer to handle parallel tasks efficiently. If your host system allows, allocating more cores can significantly reduce installation time and prevent timeout errors.

Check Storage Configuration

Storage controller settings play a critical role in how the installer reads data from the virtual hard drive. Ensure that the SATA controller is selected rather than IDE, as SATA offers better performance and compatibility with modern operating systems. If you are using dynamic storage, refer to our guide on How to Configure Linux Guest with Dynamic Space in VirtualBox to ensure the virtual disk is properly formatted and accessible. The virtual disk should be initialized as a VDI file with dynamically allocated size, allowing the installer to write data without hitting immediate capacity limits.

Review Boot Order and Media

Sometimes the issue lies in the boot sequence or the way the ISO is attached. Go to the VM Settings under the System tab and ensure that the Optical Drive is set as the first boot device. If the ISO is not detected, try re-attaching it by selecting "Choose Disk" and browsing to the local file path. In some cases, switching the optical drive controller from SATA to IDE can resolve detection issues on older VirtualBox versions. After making changes, restart the VM and watch for the GRUB menu to appear, which confirms the media is being read correctly.

Enable Hardware Virtualization

Hardware-assisted virtualization must be enabled in both your BIOS/UEFI and VirtualBox settings for the installation to proceed smoothly. Check your host computer's BIOS settings to ensure Intel VT-x or AMD-V is active. Inside VirtualBox, go to the VM Settings, select the System tab, and under the Acceleration section, ensure that Paravirtualization Interface is set to Default. If you encounter specific USB-related errors later, such as those affecting network adapters, consult Troubleshooting USB Attachment of Realtek 802.11n WLAN Adapter in Kali Linux Virtual Machine for detailed USB passthrough configurations. Proper virtualization support prevents the guest OS from crashing during low-level hardware initialization.

Frequently Asked Questions

Why does the installation freeze at 99 percent?

This usually indicates a failure in writing the final package configurations or a full virtual disk. Check your host storage space and ensure the virtual disk has enough headroom for expansion. Restarting the VM often forces the installer to retry the failed step, completing the setup.

Can I use a different virtualization software instead of VirtualBox?

Yes, VMware Workstation and Hyper-V are viable alternatives that handle Kali Linux installations well. Each platform has specific requirements for guest additions and network adapter types. You may need to adjust driver settings differently depending on the hypervisor chosen.

What should I do if the GRUB menu does not appear?

Ensure that the ISO is correctly mounted as a virtual optical drive in the VM settings. Verify that the boot order prioritizes the CD/DVD drive over the hard disk. If the ISO is valid, try pressing F12 during startup to manually select the boot device.

Does increasing CPU cores speed up the installation?

Allocating more CPU cores can improve performance during package extraction and compilation steps. However, assigning too many cores may cause context-switching overhead on the host system. Two to four cores are generally sufficient for a standard Kali installation.

How do I fix a black screen after the installation finishes?

A black screen often results from missing video drivers or incorrect display settings in VirtualBox. Install the Guest Additions package after the first boot to enable proper graphics support. Adjust the display resolution in the VM settings to match your host screen dimensions.