configure dosbox
Geoff Williams

Geoff Williams



6,841 latest version

2.0 quality score

Version information

  • 0.1.0 (latest)
released Jul 3rd 2019

Start using this module


geoffwilliams/dosbox — version 0.1.0 Jul 3rd 2019


Build Status

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with dosbox
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module


Install and configure dosbox

Module Description

Manages the dosbox package, adds a global configuration file and a wrapper script to invoke it. Also manages a directory to use as a virtual disk drive so that dosbox is ready to use right away.


What dosbox affects

  • dosbox package
  • global config file
  • script at /usr/local/bin to wrap dosbox and use above config file (used due to higher path priority)
  • some settings in config file are managed
  • creates directory at /srv/files/dos to use as virtual drive c: with sticky group set
  • creates dosbox group to grant access to files in c: (add users to it externally)

Beginning with dosbox

include dosbox

Install dosbox with the default settings. The class is parameterised to allow customisation. See source code for details.


class { "dosbox":
  fullscreen      => true,
  scaler          => "advinterp3x",
  output          => "opengl",
  aspect          => true,
  fullresolution  => "1920x1080",

Override the config file defaults to give a nicer scaler and use OpenGL


  • dosbox - configure dosbox
  • dosbox::params - externalised variables (params pattern)


Tested on Ubuntu but will probably work elsewhere.


PRs accepted