{"id":21186669,"url":"https://github.com/geontech/docker-swarm-usb","last_synced_at":"2026-03-16T20:37:14.409Z","repository":{"id":146038833,"uuid":"102126933","full_name":"Geontech/docker-swarm-usb","owner":"Geontech","description":"Scripts to enable USB permissions on a Redhawk Docker Swarm container","archived":false,"fork":false,"pushed_at":"2017-10-12T17:40:47.000Z","size":17,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-01-21T12:48:46.167Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Geontech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-09-01T15:27:58.000Z","updated_at":"2024-07-28T05:10:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"c82f4e54-f45e-437a-b034-d43d97ccd3ac","html_url":"https://github.com/Geontech/docker-swarm-usb","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Geontech%2Fdocker-swarm-usb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Geontech%2Fdocker-swarm-usb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Geontech%2Fdocker-swarm-usb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Geontech%2Fdocker-swarm-usb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Geontech","download_url":"https://codeload.github.com/Geontech/docker-swarm-usb/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243639557,"owners_count":20323511,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-20T18:25:07.453Z","updated_at":"2025-12-29T20:47:31.815Z","avatar_url":"https://github.com/Geontech.png","language":"Makefile","readme":"# Docker Swarm USB\n\nThis repository contains scripts to enable USB permissions on a [Redhawk](https://redhawksdr.github.io/Documentation/) Docker Swarm container. It is intended to be a complement to the [docker-redhawk-swarm](https://github.com/Geontech/docker-redhawk-swarm) repository.\n\n## Background\n\nThis package is a necessary workaround (*ahem* hack) because USB devices are not officially supported by a Docker Service. It is heavily based on user @brubbel's comment on this [issue](https://github.com/docker/swarmkit/issues/1244). This approach uses a system listener to wait for a specific Docker Container to be launched on the host. When the Container is detected based on the Docker Image name, a symlink to a USB device (created by UDEV rules) is read and the permissions for the device are forced into the Container's configuration file.\n\n## Prerequisites\n\n### Docker\n\nFor this guide, it is assumed that you are installing this package on an existing Unix-based Docker Swarm Node. If you haven't set up your Docker Swarm Node yet, see our guide [here](http://geontech.com/docker-redhawk-swarm/).\n\n### Supported Hardware\n\nThe following devices have been tested with this package and [docker-redhawk-swarm](https://github.com/Geontech/docker-redhawk-swarm):\n* USRP: Ettus b200 mini\n* GPS: bu353s4\n* RTLSDR: NooElec R820T\n\nThere are many other devices that are theoretically supported, including the Ettus USRP1, Ettus B100, and almost every variant of RTL SDR. Since these devices are untested, additional development could be required to get them working. Currently only one device per category (USRP, GPS, or RTLSDR) is supported for a single machine due to how the symlinks are created in the UDEV rules.\n\n## Installing\n\nUse the following command to install the package:\n\n\u003e Note: You will need administrative privileges to complete the install.\n\n    $ make install\n\nThe following warning messages will appear after the installation is complete:\n\n    A reboot is REQUIRED if you are planning on using the RTL SDR!!!\n\n    Note: After a reboot, the RTL SDR will ONLY work with Docker!\n          Uninstall this application and reboot to re-enable the local kernel modules.\n\nThese warning messages appear because the installation blacklists the kernel modules for the RTL SDR, meaning that your local installation of the RTL SDR libraries will no longer work. The RTL SDR will only work within the Docker container. The reboot is required to load in the `.conf` blacklist file, so if you don't have the RTL SDR kernel modules to begin with, then you don't need to reboot! You can check if you have these modules with the command `lsmod | grep rtl`.\n\n## Running\n\nRun the following command to get a list of steps to perform depending on the device you are enabling on this Docker Swarm Node:\n\n    $ make info\n\nThe following message appears:\n\n    Post Installation Steps:\n     * To use the bu353s4 USB GPS with Docker Swarm, execute the following as root:\n          /usr/local/bin/docker-swarm-listener /dev/usb_gps geontech/redhawk-bu353s4 \u0026\n\n     * To use the b200 USB USRP with Docker Swarm, execute the following as root:\n          /usr/local/bin/docker-swarm-listener /dev/usb_usrp geontech/redhawk-usrp \u0026\n\n     * To use the rtl2832u USB SDR with Docker Swarm, execute the following as root:\n          /usr/local/bin/docker-swarm-listener /dev/usb_rtlsdr geontech/redhawk-rtl2832u \u0026\n\nFollow these instructions and remember to `sudo su` before the command to run it as root! The `\u0026` at the end of the command forces the process to the background. The `docker-swarm-listener` script is easily extended to be given any device symlink path with any image name. The format of the command is below:\n\n    $ sudo su\n    $ /usr/local/bin/docker-swarm-listener \u003cdevice_symlink_path\u003e \u003cimage_name\u003e \u0026\n\n## Uninstalling\n\nUse the following command to uninstall the package:\n\n\u003e Note: You will need administrative privileges to uninstall the package.\n\n    $ make uninstall\n\nReminder: A reboot may be required to re-enable the RTL SDR kernel modules.\n\nAs always, [let us know](https://geontech.com/contact-us/) how we can help you with all your Redhawk and SDR needs!\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeontech%2Fdocker-swarm-usb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeontech%2Fdocker-swarm-usb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeontech%2Fdocker-swarm-usb/lists"}