Skip to content

A jff (just for fun) project that aims to create a model railroad assets manager with DCC capabilities


Notifications You must be signed in to change notification settings


Repository files navigation

Django Railroad Assets Manager (django-ram)

Django CI

Screenshot 2023-09-18 at 21-57-33 Company RGS - Railroad Assets Manager

A jff (just for fun) project that aims to create a model railroad assets manager that allows to:

  • Create a database of assets (model trains) and consists with their metadata
  • Manage the database via a simple but rationale backoffice
  • Expose main data via an HTML interface to show how beautiful is your collection to the outside world
  • Act as a DCC++ EX REST API gateway to control assets remotely via DCC. By anyone, if you'd like (seriously?).


This project is work in progress. It is intended for fun only and it has been developed with a commitment of few minutes a day; it lacks any kind of documentation, code review, architectural review, security assesment, pentest, ISO certification, etc.

This project probably doesn't match your needs nor expectations. Be aware.

Your model train may also catch fire while using this software.

Check out my own instance.


Project is based on the following technologies and components:

It has been developed with:


  • Python 3.10+
  • A USB port when running Arduino hardware (and adaptors if you have a Mac)

Web portal installation

Using containers

coming soon

Manual installation

Setup your virtualenv

$ python3 -m venv venv
$ source ./venv/bin/activate

Install dependencies

$ pip install -r requirements.txt
# Development stuff
$ pip install -r requirements-dev.txt

Bootstrap Django

$ cd ram
$ python migrate
$ python createsuperuser

Run Django

$ python runserver

Browse to http://localhost:8000

DCC++ EX connector

The DCC++ EX connector exposes an Arduino board running DCC++ EX Command Station, connected via serial port, to the network, allowing commands to be sent via a TCP socket. A response generated by the DCC++ EX board is sent to all connected clients, providing synchronization between multiple clients (eg. multiple JMRI instances).

Its use is not needed when running DCC++ EX from a WiFi capable board (like when using an ESP8266 module or a Mega+WiFi board).

Customize the settings

The daemon comes with default settings in config.ini. Settings may need to be customized based on your setup.

Using containers

$ cd daemons
$ podman build -t dcc/net-to-serial .
$ podman run --group-add keep-groups --device /dev/ttyACM0 -p 2560:2560 dcc/net-to-serial

Manual setup

$ cd daemons
$ pip install -r requirements.txt
$ python ./

Test with a simulator

A QEMU AVR based simulator running DCC++ EX is bundled togheter with the daemon into a container. To run it:

$ cd daemons/simulator
$ podman build -t dcc/net-to-serial:sim .
$ podman run --init --cpus 0.1 -d -p 2560:2560 dcc/net-to-serial:sim

To be continued ...



Screenshot 2023-09-18 at 22-00-39 RGS C-19 #40 - Railroad Assets Manager

Screenshot 2023-09-18 at 21-59-30 RGS 1930s short train - Railroad Assets Manager

Dark mode

Screenshot 2023-09-18 at 21-58-22 Company RGS - Railroad Assets Manager





Rest API



A jff (just for fun) project that aims to create a model railroad assets manager with DCC capabilities








No packages published