Files
usb-crash-cart/docker-run.sh
scott 5e23e78b51 Add Dockerfile and run scripts for containerized crash cart adapter
Wraps the NOTECONS02 USB Crash Cart Adapter software (usb-crash-cart-adapter
v20240517) in an Ubuntu 16.04 Docker container to resolve incompatibilities
with modern Fedora. Includes X11/XWayland passthrough, USB device access,
and host udev rules for the crash cart adapter (vendor 152a, products 8460/8463).

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

32 lines
1.1 KiB
Bash
Executable File

#!/bin/bash
set -euo pipefail
IMAGE="usb-crash-cart"
# On Fedora with Wayland, XWayland provides X11 compatibility.
# DISPLAY is still set (e.g. :0 or :1) and /tmp/.X11-unix still exists.
if [ -z "${DISPLAY:-}" ]; then
echo "Error: DISPLAY is not set. Ensure XWayland is running (it should be by default on Fedora)."
exit 1
fi
# xhost grants the container access via hostname-based access control,
# bypassing the need to pass the raw cookie in some setups.
xhost +local:docker 2>/dev/null || echo "Warning: xhost failed — display access may not work"
# Under XWayland, X11 auth is cookie-based (XAUTHORITY file).
# Pass it into the container so the app can authenticate with XWayland.
XAUTH_ARGS=()
if [ -n "${XAUTHORITY:-}" ] && [ -f "${XAUTHORITY}" ]; then
XAUTH_ARGS=(-e XAUTHORITY="${XAUTHORITY}" -v "${XAUTHORITY}:${XAUTHORITY}:ro")
fi
# Pass all USB bus devices so the app can find the crash cart adapter.
# The udev rules (install via install-udev-rules.sh) set permissions on the host.
docker run --rm \
-e DISPLAY="${DISPLAY}" \
"${XAUTH_ARGS[@]}" \
-v /tmp/.X11-unix:/tmp/.X11-unix \
--device /dev/bus/usb \
"${IMAGE}" "$@"