AUTOEXEC.BAT is a system file that was originally on DOS-type operating systems. It is a plain-text batch file in the root directory of the boot device. The name of the file is an abbreviation of "automatic execution", which describes its function in automatically executing commands on system startup; the filename was coined in response to the 8.3 filename limitations of the FAT file system family.
AUTOEXEC.BAT is read upon startup by all versions of DOS, including MS-DOS version 7.x as used in Windows 95 and Windows 98. Windows ME only parses environment variables as part of its attempts to reduce legacy dependencies, but this can be worked around. In Korean versions of MS-DOS/PC DOS 4.01 and higher (except for PC DOS 7 and 2000), if the current country code is set to 82 (for Korea) and no
/P:filename is given and no default
AUTOEXEC.BAT is found,
COMMAND.COM will look for a file named
KAUTOEXE.BAT instead in order to ensure that the DBCS frontend drivers will be loaded even without properly set up
Under DOS, the file is executed by the primary copy of the command-line processor (typically
COMMAND.COM) once the operating system has booted and the
CONFIG.SYS file processing has finished. While DOS by itself provides no means to pass batch file parameters to
AUTOEXEC.BAT processing, the alternative command-line processor 4DOS supports a
AutoExecParams directive and
//AutoExecParams= startup option to define such parameters. Under Concurrent DOS, Multiuser DOS and REAL/32, three initial parameters will be passed to either the corresponding
STARTxxy.BAT (if it exists) or the generic
AUTOEXEC.BAT startup file,
%1 holds the virtual console number,
%2 the 2-digit terminal number (xx) (with 00 being the main console) and
%3 the 1-digit session number (y).
Windows NT and its descendants Windows XP and Windows Vista parse
AUTOEXEC.BAT when a user logs on. As with Windows Me, anything other than setting environment variables is ignored. Unlike
CONFIG.SYS, the commands in
AUTOEXEC.BAT can be entered at the interactive command line interpreter. They are just standard commands that the computer operator wants to be executed automatically whenever the computer is started, and can include other batch files.
AUTOEXEC.BAT is most often used to set environment variables such as keyboard, soundcard, printer, and temporary file locations. It is also used to initiate low level system utilities, such as the following:
- Virus scanners
- Disk caching software
- Mouse drivers
- Keyboard drivers
- CD drivers
- Miscellaneous other drivers
In early versions of DOS,
AUTOEXEC.BAT was by default very simple. The
TIME commands were necessary as early PC and XT class machines did not have a battery backed-up real-time clock as default.
ECHO OFF CLS DATE TIME VER
In non-US environments, the keyboard driver (like
KEYBFR for the French keyboard) was also included. Later versions were often much expanded with numerous third-party device drivers. The following is a basic DOS 5 type
AUTOEXEC.BAT configuration, consisting only of essential commands:
@ECHO OFF PROMPT $P$G PATH C:\DOS;C:\WINDOWS SET TEMP=C:\TEMP SET BLASTER=A220 I7 D1 T2 LH SMARTDRV.EXE LH DOSKEY LH MOUSE.COM /Y
This configuration sets common environment variables, loads a disk cache, places common directories into the default PATH, and initializes the DOS mouse / keyboard drivers. The
PROMPT command sets the prompt to "C:\>" (when the working directory is the root of the C drive) instead of simply "C>" (the default prompt, indicating only the working drive and not the directory therein).
In general, device drivers were loaded in
CONFIG.SYS, and programs were loaded in the
AUTOEXEC.BAT file. Some devices, such as mice, could be loaded either as a device driver in
CONFIG.SYS, or as a TSR in
AUTOEXEC.BAT, depending upon the manufacturer.
In MS-DOS 6.0 and higher, a DOS boot menu is configurable. This can be of great help to users who wish to have optimized boot configurations for various programs, such as DOS games and Windows.
@ECHO OFF PROMPT $P$G PATH C:\DOS;C:\WINDOWS SET TEMP=C:\TEMP SET BLASTER=A220 I7 D1 T2 GOTO %CONFIG% :WIN LH SMARTDRV.EXE LH MOUSE.COM /Y WIN GOTO END :XMS LH SMARTDRV.EXE LH DOSKEY GOTO END :END
GOTO %CONFIG% line informs DOS to look up menu entries that were defined within
CONFIG.SYS. Then, these profiles are named here and configured with the desired specific drivers and utilities. At the desired end of each specific configuration, a
GOTO command redirects DOS to the
:END section. Lines after
:END will be used by all profiles.
Dual-booting DOS and Windows 9x
When installing Windows 95 over a preexisting DOS/Windows install,
AUTOEXEC.BAT are renamed to
AUTOEXEC.DOS. This is intended to ease dual booting between Windows 9x and DOS. When booting into DOS, they are temporarily renamed
AUTOEXEC.BAT. Backups of the Windows 9x versions are made as
Windows 9x also installs a different
MSDOS.SYS file, regarded as a "fake" by some[who?], but it's actually a configuration file, if parameter
BOOTGUI=0, then Windows 95/98 will not boot, and instead a
DOS PROMPT will appear on the screen (Windows can still be loaded by calling the
WIN command (file WIN.COM). This file contains some switches that designate how the system will boot, one of which controls whether or not the system automatically goes into Windows. This "BootGUI" option must be set to "0" in order to boot to a DOS prompt. By doing this, the system's operation essentially becomes that of a DOS/Windows pairing like with earlier Windows versions. Windows can be started as desired by typing
WIN at the DOS prompt.
When installing Caldera DR-DOS 7.02 and higher, the Windows version retains the name
AUTOEXEC.BAT, while the file used by the DR-DOS
COMMAND.COM is named
AUTODOS7.BAT, referred to by the startup parameter
/P:filename.ext in the SHELL directive. It also differentiates the
CONFIG.SYS file by using the name
The equivalent to
AUTOEXEC.BAT under OS/2 is the OS/2
STARTUP.CMD file, however, genuine DOS sessions booted under OS/2 continue to use
On Windows NT and its derivatives, Windows 2000, Windows Server 2003 and Windows XP, the equivalent file is called
AUTOEXEC.NT and is located in the
%SystemRoot%\system32 directory. The file is not used during the operating system boot process; it is executed when the MS-DOS environment is started, which occurs when a DOS application is loaded.
AUTOEXEC.BAT file may often be found on Windows NT, in the root directory of the boot drive. Windows only considers the
PATH statements which it contains, in order to define environment variables global to all users. Setting environment variables through this file may be interesting if for example MS-DOS is also booted from this drive (this requires that the drive be FAT- formatted) or to keep the variables across a reinstall. This is an exotic usage today so the file usually remains empty. The TweakUI applet from the PowerToys collection allows to control this feature (Parse AUTOEXEC.BAT at logon).
- ""Subst" Command Does Not Work in AUTOEXEC.BAT File in Windows Millennium Edition". Microsoft.
- Ashumov, V. (2017) . "Some features of MS-DOS 8.0". Archived from the original on 2010-10-22. Retrieved 2010-11-21.
- Paul, Matthias (2001-10-25). "System file settings". comp.os.msdos.programmer. Archived from the original on 2017-09-10. Retrieved 2014-08-06.
- Brothers, Hardin; Rawson, Tom; Conn, Rex C.; Paul, Matthias; Dye, Charles E.; Georgiev, Luchezar I. (2002-02-27). 4DOS 8.00 online help.
- Concurrent DOS Multiuser/Multitasking Operating System - Print Spooler User's Guide (PDF). Digital Research. 1989-02-01. Archived (PDF) from the original on 2016-11-05. Retrieved 2014-08-12.
- "FYI - Configuring CSPOOL". Novell. 1992-12-29. FYI.M.1901. Archived from the original on 2016-11-05. Retrieved 2014-08-12.
- "INFO: Configuring Parsing of the AUTOEXEC.BAT" (1 ed.). Microsoft. 2007-03-20. ID 124551. Retrieved 2017-09-10.
- "Mouse Doesn't Work with MS-DOS Shell". Microsoft.
- DR-DOS 7.02 User Guide - Chapter 1: Introduction to DR-DOS. Caldera, Inc. 1998. Archived from the original on 2016-11-05. Retrieved 2013-08-10.
- DR-DOS 7.02 User Guide. Caldera, Inc. 1998. Archived from the original on 2016-11-05. Retrieved 2013-08-10.
- "FYI - Configuring LOADER.COM for Multiple Operating System Boots - Installing DR DOS on NEC DOS 3.3 Partitions". Novell. 1993-01-05. FYI.M.1909. Archived from the original on 2016-10-05. Retrieved 2014-08-12.
- "The Windows 98 CONFIG.TXT file - Microsoft Windows 98 README for MS-DOS Config.sys Commands" (1 ed.). Microsoft Corporation. 2014-06-19 [April 1998]. ID 232557. Retrieved 2017-09-10.