Public | Automated Build

Last pushed: 2 months ago
Short Description
x/84 Python BBS (automated build)
Full Description

x/84 Docker image

This is a Dockerfile for creating a Docker image to run an installation of the
x/84 BBS software. It is based on the
ubuntu:16.04 Docker image.

This will build a fully-contained environment with all of the operating system
and Python dependencies necessary to run an ssh/telnet/https setup of x/84 --
including dosemu, libssl, and libffi.

Get it from Docker Hub

Easy peasy:

$ sudo docker pull haliphax/x84


The image exposes the following ports:

6022 ssh
6023 telnet
8443 https


The image exposes the following volumes:


These are for your data files, custom scripts, and sftp root, respectively.

Build it

To build it yourself rather than using
Docker Hub, run the
supplied script. It's just a simple wrapper around docker build.

Use the script like so:

$ ./


$ ./ <image name/tag>

Run it

bash script

An example startup script, init/, is included which maps three
directories into the Docker container via the persist folder, which will be
created on demand:

bbs  -> /home/x84/bbs            # bbs scripts if you want to change
                                 # your scriptpath from the default

data -> /home/x84/.x84           # configuration files, databases, etc.

sftp -> /home/x84/x84-sftp_root  # root directory for the sftp server

Simply run:

$ init/


$ init/ <image name/id>


In the init directory, there is an upstart file. Rename it, modify it to fit
your system, and reinitialize your upstart configuration to enable x84 as a
service (as root):

# cp init/upstart /etc/init/x84.conf

edit /etc/init/x84.conf to fit your system

# initctl reload-configuration
# start x84

Other init system configurations will be added soon.


The image comes complete with dosemu and a basic setup. It attempts to route
the D: drive in dosemu to /home/x84/bbs/dos within the image. This is
where you should place your doors, FOSSIL drivers, and utilities. If you're
using init/ to run your system, then this will be mapped to the
persist/bbs/dos folder (if it exists).

Docker Pull Command
Source Repository