Skip to content
daniel@cosenza:~/blog
FreeDOSHow-To September 10, 2025 3 min read

How to Install and Configure Applications on FreeDOS

A complete walkthrough installing a text editor and a couple of common utilities on FreeDOS, and wiring them into your PATH and environment properly.

This walks through installing and properly configuring applications on FreeDOS — using the bundled EDIT text editor as the primary example, plus the general pattern for adding any additional package afterward.

Step 1: check what’s already installed

FreeDOS’s Base package set includes a text editor already — confirm it’s present before installing anything extra:

C:\>DIR C:\FREEDOS\BIN\EDIT.EXE

Step 2: launch and get familiar with EDIT

C:\>EDIT CONFIG.SYS

EDIT provides a full-screen, menu-driven text editing experience (accessible via Alt to open the menu bar) — considerably more approachable than line-oriented alternatives, and sufficient for editing configuration files like CONFIG.SYS and AUTOEXEC.BAT directly.

Step 3: install additional packages via FDIMPLES

For anything not included in your initial installation’s package selection, use FDIMPLES’ menu-driven interface:

C:\>FDIMPLES

Navigate the category list, select packages you want (space bar typically toggles selection), and confirm to install — this handles downloading (if networked) or installing from local media, and registering the package in FreeDOS’s package database.

Step 4: install a package directly via FDNPKG, if you know its name

C:\>FDNPKG install nasm

Useful when you know exactly what you want (in this example, the NASM assembler) without navigating FDIMPLES’ full category menu.

Step 5: confirm where the new package actually installed

C:\>FDNPKG list

Most FreeDOS packages install under C:\FREEDOS\BIN\ or a dedicated subdirectory — confirm the new executable’s location before assuming it’s reachable from your PATH.

Step 6: make sure your PATH actually includes it

C:\>PATH

If the new application’s directory isn’t already in your PATH, add it in AUTOEXEC.BAT so it’s available at every boot, not just for the current session:

SET PATH=%PATH%;C:\FREEDOS\BIN;C:\NASM

Step 7: for applications needing specific environment variables

Some applications (compilers and development tools especially) expect specific environment variables pointing to their own installation or data directories — check the application’s own documentation and add these to AUTOEXEC.BAT alongside the PATH update:

SET NASM_HOME=C:\NASM

Step 8: reboot and confirm the application launches from anywhere

C:\>CD \
C:\>NASM -v

Running the new command from a directory other than where it’s installed confirms your PATH update actually took effect, rather than the command only working because you happened to be in its own directory.

Step 9: for applications distributed outside FreeDOS’s package system

Not every useful DOS-era application is available as a FreeDOS package — for anything distributed as a standalone .zip or self-extracting archive, extract it to its own directory under C:\, and follow the same pattern: confirm the executable’s location, add it to PATH if you want it globally reachable, and set any environment variables its documentation specifies.

Why FDIMPLES/FDNPKG plus manual PATH management, together

FreeDOS’s package tools handle installing files to a sensible default location and registering them in the package database, but — unlike a modern package manager — they don’t automatically manage your shell’s PATH or environment variables for you. Understanding this two-part model (the package tool installs files; you wire them into your environment via AUTOEXEC.BAT) is what makes troubleshooting “installed but not found” issues straightforward rather than mysterious.