scott 5899ca619a
Some checks failed
Docker Build and Publish / Build Docker image and publish to Gitea (push) Failing after 41s
Fix dpkg udev dependency in Docker build
The .deb declares a dependency on udev but udev is a host service, not
needed inside the container. Use --force-depends to skip that check.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-07 12:40:53 -04:00

usb-crash-cart

Docker container wrapper for the NOTECONS02 USB Crash Cart Adapter software.

The vendor software (usb-crash-cart-adapter v20240517) was built against Ubuntu 16.04 (Python 2.7, wxWidgets 2.9/GTK2) and is incompatible with modern Fedora. This repo runs it inside an Ubuntu 16.04 container with X11/XWayland passthrough.

New host setup (one-time)

Clone the repo and install the udev rules so the crash cart adapter is accessible without root:

git clone git@git.sdgarren.com:scott/usb-crash-cart.git
cd usb-crash-cart
sudo ./install-udev-rules.sh

Reconnect the adapter if it was already plugged in.

Running

Pull the pre-built image from the Gitea registry and launch:

docker pull git.sdgarren.com/scott/usb-crash-cart:latest
./docker-run.sh

docker-run.sh handles X11/XWayland socket sharing and USB device passthrough automatically.

Notes

  • The container uses ubuntu:16.04 to match the original build environment.
  • The app bundles its own libpython2.7, libwx_gtk2u-2.9, libpng12, etc. — the container only needs GTK2 and X11 system libs from the OS.
  • On Fedora with Wayland, XWayland provides X11 compatibility — no extra configuration needed.
  • The Docker image is built automatically by Gitea Actions on every push to main.
Description
Docker container wrapper for the NOTECONS02 USB Crash Cart Adapter software (Ubuntu 16.04 base with X11/XWayland passthrough)
Readme 22 MiB
Languages
Shell 65.6%
Dockerfile 34.4%