{"id":14667,"date":"2026-10-05T01:00:00","date_gmt":"2026-10-05T05:00:00","guid":{"rendered":"https:\/\/www.both.org\/?p=14667"},"modified":"2026-10-03T13:53:08","modified_gmt":"2026-10-03T17:53:08","slug":"booting-new-freedos-kernels","status":"publish","type":"post","link":"https:\/\/www.both.org\/?p=14667","title":{"rendered":"Booting new FreeDOS kernels"},"content":{"rendered":"
\r\n
\r\n \r\n <\/i>\r\n <\/a>\r\n <\/span>\r\n<\/div><\/div>\n

In late June this year, FreeDOS released an updated kernel. Thanks to the hard work of our kernel developers, maintained by Jeremy Davis, the new kernel includes a ton of new work aimed at supporting Windows 3.1 in “386 Enhanced” mode. FreeDOS has been able to run Windows 3.1 in “Standard” mode for years, but “Enhanced” mode requires supporting a lot of compatibility “edge” cases for Windows 3.1. It is no small feat to add this support.<\/p>\n\n\n\n

Since that time, we’ve included this updated kernel in every monthly test release<\/a> starting with FreeDOS T2607 (July 2026). If you install the test release, you’ll automatically install the new kernel. Please help us to test the new kernel; the test release will become the next FreeDOS distribution.<\/p>\n\n\n\n

FreeDOS 1.4 (kernel version 2043)<\/h2>\n\n\n\n

But what if you’re already running FreeDOS 1.4 and don’t want to re-install just to try out the new kernel<\/em>? Installing a new FreeDOS kernel is actually quite easy. Let’s demonstrate by upgrading FreeDOS 1.4 to use the new kernel.<\/p>\n\n\n\n

For this demonstration, I started with a tiny QEMU disk image. I don’t need to install all of FreeDOS 1.4 just to test this, so a few megabytes would be enough. I created a virtual QCOW2 disk image that was 10 megabytes in size:<\/p>\n\n\n\n

$ qemu-img create -f qcow2 tiny.q 10M\nFormatting 'tiny.q', fmt=qcow2 cluster_size=65536 extended_l2=off compression_type=zlib size=10485760 lazy_refcounts=off refcount_bits=16<\/code><\/pre>\n\n\n\n
I already downloaded the FreeDOS 1.4 installation media as FD14LIVE.iso<\/strong> in a 1.4<\/strong> directory. I booted QEMU with the LiveCD as the “CD-ROM” image, and the tiny.q<\/strong> disk image as the “C:” drive:<\/p>\n\n\n\n
$ qemu-system-i386 -cdrom 1.4\/FD14LIVE.iso -hda tiny.q<\/code><\/pre>\n\n\n\n
The LiveCD boots into a DOS prompt by default, so I used the fdisk<\/strong> command to verify that the “C:” drive was empty, then created a new partition on it. You can use fdisk<\/strong> either as an interactive program or as a command line tool; I used it from the command line:<\/p>\n\n\n\n
D:\\>fdisk 1 \/info\n\nCurrent fixed disk drive: 1   20160 sectors, geometry 20\/016\/63\n\nNo partitions defined.\n\nLargest continuous free space for primary partition = 9 MBytes\n\nD:\\>fdisk 1 \/auto \n\nD:\\>fdisk 1 \/info\n\nCurrent fixed disk drive: 1   20160 sectors, geometry 20\/016\/63\n\nPartition   Status   Mbytes   System           Usage    Start CHS       End CHS\n C: 1   1      A          9   FAT-12            100%     0\/001\/01     19\/015\/63\n\nLargest continuous free space for primary partition = 0 MBytes<\/code><\/pre>\n\n\n\n
Like any DOS, the FreeDOS kernel only reads the disk partition information when it boots up. If you add or delete partitions on the disk, you need to reboot before FreeDOS will “see” them. After rebooting the system using the reboot<\/strong> command (which is really an alias to fdapm<\/strong> with the \/warmboot<\/code> command line option) I was back at DOS prompt and could create a DOS filesystem on the “C:” drive using the format<\/strong> command. To make the disk bootable with a kernel and a copy of the command.com<\/strong> shell, add the \/S<\/code> (“system”) option to the format<\/strong> command line.<\/p>\n\n\n\n
D:\\>format C: \/S\n DRIVE C: WILL BE LOST! PLEASE CONFIRM!\nProceed with Format (YES\/NO)?YES\n##  Boot sector unreadable, disk not yet formatted\n Disk size: 10 Mbytes, FAT12. ***\nCannot find existing format - not saving UNFORMAT data.\nPlease enter volume label (max. 11 chars): TINY \n QuickFormatting (only flushing metadata)\n Warning: Resets bad cluster marks if any.\n Preparing FAT area...\n100 percent completed.\n\nQuickFormat complete.\n\nRunning SYS in a shell: sys C:\nSystem transferred.\n\n\n    10,289,664  bytes total disk space (disk size)\n    10,264,576  bytes available on disk (free clusters)\n\n         4,096  bytes in each allocation unit.\n         2,506 allocation units on disk.\n\n Volume Serial Number is 2021-1824<\/code><\/pre>\n\n\n\n
To make it easier to shut down the virtual machine later, I also copied the fdapm<\/strong> command to the new virtual disk. When I was done, my new “C:” drive had a copy of the kernel as KERNEL.SYS<\/code>, the command shell as COMMAND.COM<\/code>, and the Advanced Power Management command as FDAPM.COM<\/code>:<\/p>\n\n\n\n
D:\\>copy \\freedos\\bin\\FDAPM.COM C:\n\\freedos\\bin\\FDAPM.COM =>> C:FDAPM.COM\n\nD:\\>dir C: \/w\n Volume in drive C is TINY\n Volume Serial Number is 2021-1824\n Directory of C:\\\n\nCOMMAND.COM    FDAPM.COM      KERNEL.SYS\n         3 file(s)        141,462 bytes\n         0 dir(s)      10,117,120 bytes free<\/code><\/pre>\n\n\n\n
Having installed a minimal<\/em> version of “FreeDOS 1.4,” I could shut down using fdapm<\/strong> one more time:<\/p>\n\n\n\n
D:\\>fdapm \/poweroff<\/code><\/pre>\n\n\n\n
If you boot back into the “tiny” virtual disk, you can see that the FreeDOS kernel identifies itself as version 2043:<\/p>\n\n\n\n
$ qemu-system-i386 -hda tiny.q\n\nBooting from Hard Disk...\nFreeDOS kernel 2043 (build 2043 OEM:0xfd) [compiled May 14 2021]\nKernel compatibility 7.10 - WATCOMC - 80386 CPU required - FAT32 support\n\n(C) Copyright 1995-2012 Pasquale J. Villani and The FreeDOS Project.\nAll Rights Reserved. This is free software and comes with ABSOLUTELY NO\nWARRANTY; you can redistribute it and\/or modify it under the terms of the\nGNU General Public License as published by the Free Software Foundation;\neither version 2, or (at your option) any later version.<\/code><\/pre>\n\n\n\n
Upgrading the kernel (version 2046)<\/h2>\n\n\n\n
To install the new kernel without reinstalling FreeDOS<\/em>, you can just replace the KERNEL.SYS<\/code> file. It’s that easy because of how DOS boots up: I’ll skip over some of the details, but eventually the system starts the FreeDOS boot loader<\/em> which looks for a kernel called KERNEL.SYS<\/code>. If you replace that system file with another one, the boot loader will load the new kernel.<\/p>\n\n\n\n
Let’s replace the “FreeDOS 1.4” kernel with the one from the latest FreeDOS test release (FreeDOS T2610, October 2026). One way to do that is to boot the virtual machine with the FreeDOS T2610 installation media as a separate drive, and copy the kernel to the “C:” drive.<\/p>\n\n\n\n
Since my “tiny” virtual disk doesn’t have a CD-ROM driver, I couldn’t use the LiveCD image from the FreeDOS test release\u2014at least, not if I wanted to do the work from the virtual disk. Instead, I downloaded the FreeDOS T2610 “Full USB” image as T2610FULL.img<\/code> and booted with that as the “D:” drive. I used the tiny.q<\/code> virtual disk image as the “C:” drive:<\/p>\n\n\n\n
$ qemu-system-i386 -hda tiny.q -hdb T2610\/T2610FULL.img<\/code><\/pre>\n\n\n\n
By default, the FreeDOS kernel looks for its configuration file as \\FDCONFIG.SYS<\/code>; if it can’t find that file, it also looks for \\CONFIG.SYS<\/code>. Since I didn’t create this file on my virtual disk, the FreeDOS kernel assumes some defaults and loads \\COMMAND.COM<\/code> as the command shell. The shell looks for \\AUTOEXEC.BAT<\/code> to set the initial environment; but this doesn’t exist either so the command shell prompts for the date and time, then puts me into a shell prompt where I can type commands:<\/p>\n\n\n\n
Booting from Hard Disk...\nFreeDOS kernel 2043 (build 2043 OEM:0xfd) [compiled May 14 2021]\nKernel compatibility 7.10 - WATCOMC - 80386 CPU required - FAT32 support\n\n(C) Copyright 1995-2012 Pasquale J. Villani and The FreeDOS Project.\nAll Rights Reserved. This is free software and comes with ABSOLUTELY NO\nWARRANTY; you can redistribute it and\/or modify it under the terms of the\nGNU General Public License as published by the Free Software Foundation;\neither version 2, or (at your option) any later version.\nC: HD1, Pri[ 1], CHS=    0-1-1, start=     0 MB, size=     9 MB\nD: HD2, Pri[ 1], CHS=    0-1-1, start=     0 MB, size=  1023 MB\n\nFreeCom version 0.86 - WATCOMC - XMS_Swap [Dec 30 2024 22:10:51]\nCurrent date is Sat 10-03-2026\nEnter new date (mm-dd-[cc]yy): \nCurrent time is  5:12:22 pm\nEnter new time:\nC:\\><\/code><\/pre>\n\n\n\n
I first made a backup of the KERNEL.SYS<\/code> kernel file, then copied the new kernel from the “D:” drive to the “C:” drive. You can do this with the shell’s built-in copy<\/strong> command:<\/p>\n\n\n\n
C:\\>copy kernel.sys kernel.000\nkernel.sys =>> kernel.000\n\nC:\\>copy D:\\kernel.sys kernel.sys\nOverwrite 'kernel.sys' (Yes\/No\/All\/Quit) ? y\nD:\\kernel.sys =>> kernel.sys<\/code><\/pre>\n\n\n\n
That’s it! I now have a backup copy of the “old” kernel as KERNEL.000<\/code> and the “new” kernel is KERNEL.SYS<\/code>. You can see that the files are different using the dir<\/strong> command:<\/p>\n\n\n\n
C:\\>dir kernel.*\n Volume in drive C is TINY\n Volume Serial Number is 2021-1824\n Directory of C:\\\n\nKERNEL   SYS        48,889  10-01-26 10:14a\nKERNEL   000        46,256  04-02-25 10:22a\n         2 file(s)         95,145 bytes\n         0 dir(s)      10,067,968 bytes free<\/code><\/pre>\n\n\n\n
After I reboot the system using the fdapm<\/strong> command with the \/warmboot<\/code> option, I can verify the system is now running with the new kernel:<\/p>\n\n\n\n
Booting from Hard Disk...\n..............123\nFreeDOS kernel 2046 (build 2046 OEM:0xfd) [compiled Jun 29 2026]\nKernel compatibility 7.10 - WATCOMC - 80386 CPU required - FAT32 support\n\n(C) Copyright 1995-2023 Pasquale J. Villani and The FreeDOS Project.\nAll Rights Reserved. This is free software and comes with ABSOLUTELY NO\nWARRANTY; you can redistribute it and\/or modify it under the terms of the\nGNU General Public License as published by the Free Software Foundation;\neither version 2, or (at your option) any later version.<\/code><\/pre>\n\n\n\n
You can power off the virtual machine using the fdapm<\/strong> command one more time, with the \/poweroff<\/code> option.<\/p>\n\n\n\n
D:\\>fdapm \/poweroff<\/code><\/pre>\n\n\n\n
\n\n\n\n
By design, DOS is a simple operating system. And this simplicity makes DOS a great way to learn how computers work<\/em>. You can see all of the “moving parts” in DOS: when the kernel boots up, it looks for its “config” file, which sets systemwide parameters. Then the kernel starts the command shell, which uses its own “bat” file to set the initial environment. After that, you’re at the command line and can enter commands and run programs.<\/p>\n\n\n\n
Please help us test the next version of FreeDOS! Thanks to Jerome Shidel, our distribution manager, we are able to share a new “test” distribution every month. These monthly releases collect all new changes, and act as a “test bed” to become the next official FreeDOS distribution, and we would like your help to test it. The new “T2610” test release includes updates to VSBHDA, SBEMU, Himem, TinyAsm, Blocek, Lynx, FDNPKG16, plus several new translations. Since August, we’ve also included the updated kernel and other tools. Download the test release<\/a> and let us know<\/a> if you have any problems.<\/p>\n","protected":false},"excerpt":{"rendered":"
Replacing the FreeDOS kernel is just a simple copy command<\/p>\n","protected":false},"author":33,"featured_media":4599,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_lmt_disableupdate":"","_lmt_disable":"","footnotes":"","_members_access_role":[],"_members_access_error":""},"categories":[340,90,89],"tags":[267,223,683],"class_list":["post-14667","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-freedos","category-in-depth","category-system-administration","tag-freedos","tag-in-depth","tag-system-administration"],"modified_by":"David Both","_links":{"self":[{"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts\/14667","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/users\/33"}],"replies":[{"embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=14667"}],"version-history":[{"count":1,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts\/14667\/revisions"}],"predecessor-version":[{"id":14668,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts\/14667\/revisions\/14668"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/media\/4599"}],"wp:attachment":[{"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=14667"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=14667"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=14667"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}