shrizt/dosbox-x repository overview

⁠DOSBox-X for Docker Server with VNC access and audio (sound blaster + midi) support!

Based on ubuntu:latest This is new step from my shrizt/dosbox container, according the requests I've got - now with DosBox-X (ver 2024-03) and pulseaudio/midi enabled! DosBox-X is an updating and evolving DOS emulator with accurate emu-model. IPX networking support is available - just use ipxnet command from DOS console - no need config changes (verified). You may run few containers and setup ipx networking between em.

⁠Update 27 March 2024: Now in public beta-2 version. Changes:

• Added mapping file to fix wrong keyboard layout (please delete old /config files)
• Removed dosbox, lot of unnecessary packets, added multi-stage build to reduce image file (over 2x times smaller now)
• DOSBOXSLEEP replaced with AUTOSLEEP env var and in addition it put to sleep pulseaudio to save CPU if no VNC client connected
• IPX networking configured and verified
• Logs stored in separate dir, config of dosbox-x tuned and available in mounted /config folder for your editing
• Drive C included with a game and midi player with some songs for quick start/test

Any feedback and ideas are highly appreciated and welcome to shrizt(9)gmail.c0m! :)

⁠Install and run

Image is available and being updated on REPO https://hub.docker.com/r/shrizt/dosbox-x⁠ Any network mode is supported. Port 5901 is exposed as default.

Simple command-line minimal run: docker run -d --name dosbox1 -p=5901:5901 -v /path/on/host:/config shrizt/dosbox-x

Connection VNC password will be generated automatically and logged.

Better way to run container using docker compose stack Parameters for container in compose format:

environment:
  - VNCPASSWORD=333 #password for VNC connection
  - VNCGEOMETRY=800x600 #resolution for VNC, 1024x768 is default (640x480 - 1024x768 works tested)
  - VNCDEPTH=16 #Bit color depth, 16 is default
  - AUTOSLEEP=1 #To enable auto-sleep of container if not connected via VNC (0 by default)
volumes:
  - /path/on/host:/config #conf files, log dir and drive_d folder will be created there and may be edited
ports:
  - 5901:5901 #VNC port to expose

⁠Installed files

On first run in attached /config folder config files will be created (if not exist) and may be customized for future launch. Remove config files to recreate defaults. Also /config/drive_d will be created if not exist and mounted to drive D: in DosBox. Put your DOS apps there. Drive C: included to image for fun.

⁠Environment variables

• VNCPASSWORD can set the password for the VNC console (maximum 8 characters, a limitation of tightvncserver). If you do not set one, a random password will be assigned on each start of the container, and logged in the docker logs.

• VNCGEOMETRY resolution for VNC (1024x768 default now and is a maximum working one)

• VNCDEPTH Bit color depth for VNC sessions. Any 8-32 should work fine.

• AUTOSLEEP Auto-sleep feature enabled if ="1".

Check log of container and /config/log files if any issues.

⁠VNC-based console

VNC is exposed on port 5901. You can connect to this port. You will see, by default, an xterm (white) and a DOSBox terminal (black) running there.

You may put commands to execute on start up of dosbox-x in /config/start.bat file.

⁠Source / Ext links

As it's beta build - sources not yet ready to public view :)

Expect it on my GitHub: https://github.com/Shrizt/⁠