Gravis UltraSound in DOSBox: Turning the GUS On — In Plain Words
gus=false. Turning it on is one edit in the [gus] section of your config file: gus=true. The game’s own setup then has to be told about the card, and if it asks for numbers, the config file’s defaults are the ones to give it: base address 240, IRQ 5, DMA 3. One honesty note the manual itself prints, and this page keeps: in plain DOSBox 0.74, the GUS’s MIDI side was “left out,” and Gravis music needs the Gravis drivers installed inside DOSBox. DOSBox Staging — a different program, covered in its own labelled section below — does the patch-file MIDI side in full.
Honest labels, up front. Everything on this page is copied from the configuration file DOSBox itself writes out, the DOSBox manual, and — in one clearly marked section — the DOSBox Staging manual, which describes a different program and is never blended with the DOSBox 0.74 directions. This page prints no download route for GUS patch files or driver packs: patch files carry licensing restrictions (DOSBox Staging’s manual says they cannot be distributed with it for exactly that reason), so where they come from is left to you, the same rule this collection applies to Roland MT-32 ROMs. Nothing here was tested by playing a game for this page: the DisBox settings collection this page belongs to holds 0 settings verified by actual play.
These settings are part of the DisBox collection. DisBox OS — the system being built to run games with settings like these — is in the works; its interface comes first, so there is no finished OS to download yet.
The six lines, exactly as DOSBox writes them
The [gus] section of the configuration file DOSBox 0.74 writes out documents itself. Its six settings, with the file’s own descriptions and defaults:
[gus] gus=false gusrate=44100 gusbase=240 gusirq=5 gusdma=3 ultradir=C:\ULTRASND
- gus — “Enable the Gravis Ultrasound emulation.” Default
false: the card is not there until you turn it on. - gusrate — “Sample rate of Ultrasound emulation.” Default 44100; possible values 44100, 48000, 32000, 22050, 16000, 11025, 8000, 49716.
- gusbase — “The IO base address of the Gravis Ultrasound.” Default 240; possible values 240, 220, 260, 280, 2a0, 2c0, 2e0, 300.
- gusirq — “The IRQ number of the Gravis Ultrasound.” Default 5; possible values 5, 3, 7, 9, 10, 11, 12.
- gusdma — “The DMA channel of the Gravis Ultrasound.” Default 3; possible values 3, 0, 1, 5, 6, 7.
- ultradir — “Path to Ultrasound directory.” Default
C:\ULTRASND— a folder inside the DOSBox world, on one of your mounted drives.
If a game’s setup utility asks you to type the card’s address, interrupt, and DMA channel, it is asking for the middle three. Leave them at the defaults and give the game those same numbers — 240, 5, 3 — and the two sides agree.
What ultradir and the patch files are for
The real GUS carried no built-in instrument sounds; its music was played from patch files — recordings of real instruments loaded from disk. The configuration file’s comment on ultradir describes the expected layout: “In this directory there should be a MIDI directory that contains the patch files for GUS playback. Patch sets used with Timidity should work fine.” So the folder your ultradir names needs a MIDI subfolder holding the patch files, for the games that play music that way.
What the 0.74 manual honestly says about its own GUS
The manual’s list of emulated sound hardware describes the Gravis Ultrasound entry with a limitation stated up front: “The emulation of this hardware is nearly complete, though the MIDI capabilities have been left out, since an MPU-401 has been emulated in other code. For Gravis music you also have to install Gravis drivers inside DOSBox. It is disabled as default.” Two practical consequences, both printed here rather than smoothed over:
gus=truemakes the card exist; it does not by itself install the Gravis software the manual says Gravis music requires inside DOSBox.- A game that only talks to the GUS through MIDI is, in 0.74, talking to the part the manual says was left out — 0.74 routes MIDI through its MPU-401 emulation instead (the subject of this collection’s MT-32 guide).
The manual does name the GUS as a working alternative in one place: its no-sound answer ends, “In certain cases it might be useful to use a different emulated sound device like a soundblaster pro (sbtype=sbpro1 in the DOSBox configuration file) or the gravis ultrasound (gus=true).”
If you run DOSBox Staging instead
DOSBox Staging is a separate program, and its Gravis UltraSound page covers the ground the 0.74 manual says 0.74 left out. The facts below are Staging’s, labelled as such. Staging spells the switch gus = on (its values are on/off, not true/false), and it sorts GUS software into three kinds needing different setups: native games, which “upload their own samples to the GUS’s on-board RAM — no patch files or drivers needed” and “need only gus = on in the config”; GUS MIDI games, whose built-in driver loads patch files from the MIDI subdirectory under ultradir; and UltraMID games, which need Gravis’s ULTRAMID.EXE loaded before the game starts. Staging is blunt about the patches: “Due to licensing restrictions, these patch files can’t be distributed with DOSBox Staging, so you’ll need to obtain them separately” — the reason this page prints no source for them either. Its defaults match 0.74’s numbers (base 240, IRQ 5, DMA 3), which Staging says were “selected to avoid conflicts with the Sound Blaster card, allowing both to coexist”; it also documents a factory settings variant (base 220, IRQ 11, DMA 1) for titles that fail to detect the card at the coexistence defaults — Staging advice for Staging, not a 0.74 instruction, and note that its gusbase value list (210, 220, 230, 240, 250, 260) is not the same list 0.74’s configuration file prints. Staging also sets the ULTRASND and ULTRADIR environment variables itself at startup from the [gus] section — “You should never set them manually” — which is another Staging-only behaviour, not something 0.74 does for you.
The one-minute version: In the config file’s [gus] section, change gus=false to gus=true, leave base/IRQ/DMA at 240/5/3, and tell the game’s setup those same numbers. Expect games written for the card to find it; expect Gravis music in plain 0.74 to need the Gravis drivers installed inside DOSBox, as the manual says — and know that 0.74’s manual states its GUS MIDI side was left out entirely, which is the gap Staging’s version fills.
Sources
The configuration file DOSBox 0.74 writes out — the [gus] section in full: the six settings, the file’s own one-line descriptions, the defaults (gus=false, gusrate=44100, gusbase=240, gusirq=5, gusdma=3, ultradir=C:\ULTRASND), every value list quoted, and the ultradir comment (a MIDI directory holding the patch files; Timidity patch sets should work). Read in full; two printings of the shipped file agree on this section word for word. (The DOSBox Wiki’s dedicated Configuration:GUS page does not exist — the Dosbox.conf page links to it, but the link is unfilled — so the shipped file itself is this page’s authority for the section.)
DOSBox (dosbox.com) — “DOSBox v0.74-3 Manual” — the Start FAQ’s emulated-sound-hardware list (the Gravis Ultrasound entry: nearly complete, MIDI capabilities left out, Gravis drivers to be installed inside DOSBox, disabled as default) and the no-sound answer (gus=true named as an alternative device). https://www.dosbox.com/DOSBoxManual.html
DOSBox Staging — “Gravis UltraSound” manual page — the labelled Staging section: the gus = on spelling, the native / GUS MIDI / UltraMID three-way split, the MIDI subdirectory layout, the licensing reason patch files are not distributed, the coexistence defaults (240/5/3) and the factory-settings variant (220/11/1), its differing gusbase value list, and the automatically injected ULTRASND/ULTRADIR variables. Staging is a separate program; its facts are labelled as such on this page. https://www.dosbox-staging.org/0.83/manual/sound/sound-devices/gravis-ultrasound/
Checked November 7, 2026
Related guides: Running The Oregon Trail (DOS) on a Modern PC, Roland MT-32 Music in DOSBox, SimCity 2000 Has No Sound in DOSBox? What the Tests Show, DOSBox Config for Warcraft and CD-ROM Drive Not Found in DOSBox? MOUNT and IMGMOUNT.