Files
usb-crash-cart/README.md
scott 40288dfd61 Update README with pull-based workflow
Replaces build-from-source instructions with docker pull from the Gitea
registry, since the image is now built automatically by Gitea Actions.

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

1.3 KiB

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.