Meta tags:
description= Pass USB devices through to Linux machines and containers. Share serial adapters and FIDO security keys with macOS, or dedicate any USB device to Linux. Manage everything from the Devices tab or the orb usb command.;
Headings (most frequently used words):
devices, serial, uart, usb, get, started, learn, more, features, docker, containers, kubernetes, linux, machines, compare, legal, use, cases, forwarded, vs, dedicated, tab, command, line, security, keys, limitations, tested, miscellaneous, ethernet, wi, fi, sdr,
Text of the page (most frequently used words):
usb (31), and (21), #devices (20), linux (18), serial (16), the (14), #device (10), with (10), macos (10), you (9), adapter (9), security (9), uart (8), use (8), orbstack (7), machines (7), passthrough (7), can (7), your (7), orb (7), from (7), keys (6), forwarded (6), adapters (6), attach (5), dedicated (5), list (5), that (4), realtek (4), ethernet (4), fido (4), available (4), are (4), them (4), for (4), they (4), network (4), containers (4), detach (4), shared (4), labs (3), page (3), not (3), work (3), open (3), link (3), wireless (3), ttl (3), flash (3), isolated (3), like (3), while (3), bash (3), connected (3), mac (3), through (3), drives (3), hardware (3), docker (3), using (3), sound (2), container (2), image (2), volume (2), files (2), most (2), should (2), sdr (2), silicon (2), hid (2), ccid (2), adb (2), fastboot (2), what (2), tested (2), aren (2), only (2), u2f (2), interface (2), key (2), automatically (2), ssh (2), inside (2), ports (2), such (2), usable (2), same (2), time (2), which (2), first (2), attached (2), all (2), since (2), details (2), command (2), line (2), see (2), pass (2), return (2), away (2), both (2), tab (2), app (2), other (2), drivers (2), file (2), android (2), development (2), this (2), policy (2), kubernetes (2), menu (2), features (2), install (2), navigation (2), docs (2), 2024, orbital, llc, next, previous, pager, explicitly, listed, please, find, doesn, issue, rtl, blog, rtl2832u, wn727n, ralink, rt5390, rtl8188cus, rtl8192cu, edup, wifi, mediatek, mt7921u, plugable, 5gbe, rtl8157, amazon, basics, 1gbe, asix, ax88179a, gearmo, 232, ftdi, ft232r, dsd, tech, cp2102n, cp2102, adafruit, cable, prolific, pl2303, yubikey, nfc, ykman, google, pixel, lexar, drive, miscellaneous, give, idea, following, have, been, limitations, forwarding, covers, smart, card, functions, piv, gpg, those, instead, yubikeys, sudo, webauthn, remain, apps, browser, appear, character, guest, stay, ubuntu, choose, machine, joins, column, non, share, one, instance, info, show, also, manage, terminal, select, its, type, vendor, product, speed, number, attaching, port, asks, confirm, takes, currently, grouped, how, any, passed, exclusively, taken, until, staying, unlike, normal, never, disconnected, handles, two, ways, anything, else, needs, tooling, ext4, btrfs, disks, mounting, systems, support, monitor, mode, packet, injection, penetration, testing, over, similar, interfaces, debugging, lets, tools, real, opens, things, possible, cases, even, without, disconnecting, capability, unique, plugged, into, shows, works, phones, optical, tape, sdrs, lab, instruments, source, licenses, subprocessors, privacy, public, sector, amendment, master, software, license, agreement, terms, service, legal, utm, colima, desktop, compare, distributions, sharing, commands, cloud, init, host, networking, volumes, mounts, images, bar, https, domains, debug, shell, older, versions, bulletins, licensing, settings, architecture, benchmarks, efficiency, learn, more, new, frequently, asked, questions, quick, start, home, get, started, sidebar, top, appearance, demo, overview, main, search, skip, content,
Text of the page (random words):
usb devices orbstack docs skip to content orbstack docs search k main navigation overview docker linux install demo appearance menu return to top sidebar navigation get started home features quick start frequently asked questions what s new learn more install efficiency benchmarks architecture settings licensing security bulletins older versions features debug shell domains https container image volume files usb sound menu bar app command line ci docker containers using containers network images volumes mounts host networking kubernetes using kubernetes linux machines using linux machines isolated machines cloud init commands network file sharing ssh distributions compare docker desktop colima utm legal terms of service master software license agreement u s public sector amendment privacy policy subprocessors security policy open source licenses on this page usb devices orbstack can pass usb devices through to linux so hardware plugged into your mac shows up inside your machines and containers this works with serial uart adapters security keys usb ethernet and wi fi adapters android phones flash drives optical and tape drives sdrs lab instruments and most other usb devices serial uart devices and security keys can even be shared with linux without disconnecting them from macos a capability unique to orbstack use cases usb passthrough lets you use linux s drivers and tools with real hardware which opens up things that aren t possible on macos hardware development and debugging over serial uart and similar interfaces android development with adb and fastboot wi fi penetration testing with adapters that support monitor mode and packet injection mounting linux file systems like ext4 and btrfs from usb flash drives and disks anything else that needs linux drivers or tooling forwarded vs dedicated orbstack handles devices in two ways forwarded serial uart adapters and fido security keys are shared with linux while staying usable on macos so you can use them in both at the same time unlike normal passthrough the device is never disconnected from your mac dedicated passthrough any other usb device can be passed through to linux exclusively while attached it s taken away from macos until you detach it devices tab open the devices tab in the orbstack app to see all connected usb devices grouped by how they re shared forwarded serial uart ports and security keys available to both macos and linux passthrough devices currently dedicated to linux not shared devices only in use by macos select a device to see its details such as type vendor product id speed and serial number use attach to pass a device through to linux and detach to return it to macos attaching a forwarded device serial port or security key for dedicated passthrough asks you to confirm first since it takes the device away from macos command line you can also manage usb passthrough from the terminal bash list connected usb devices orb usb list show details for a device orb usb info i d attach a device to linux orb usb attach i d detach a device orb usb detach i d use the id from the first column of orb usb list attached devices are available to all of your non isolated machines and containers since they share one linux instance for usb network adapters you can choose which machine the network interface joins with m bash orb usb attach i d m ubuntu serial uart devices serial and uart ports connected to your mac such as usb to serial adapters are automatically forwarded to linux and appear as character devices in the guest they stay usable on macos at the same time list them with bash orb serial list security keys fido u2f security keys e g yubikeys are automatically forwarded to linux so you can use them for ssh sudo and webauthn inside your machines while they remain available to macos apps like your browser forwarding only covers the fido u2f hid interface not ccid smart card functions like piv or gpg to use those in linux attach the key with dedicated passthrough instead limitations devices aren t available in isolated machines tested devices to give you an idea of what devices should work the following devices have been tested with orbstack miscellaneous lexar usb flash drive google pixel 6 adb fastboot yubikey 5c nfc fido hid ccid ykman serial uart adafruit usb to ttl serial cable prolific pl2303 usb to ttl serial adapter silicon labs cp2102 dsd tech usb to ttl serial adapter silicon labs cp2102n gearmo usb to serial rs 232 adapter ftdi ft232r ethernet amazon basics usb c 1gbe ethernet adapter asix ax88179a plugable usb c 5gbe ethernet adapter realtek rtl8157 wi fi edup usb wifi 6e adapter mediatek mt7921u tp link wireless n usb adapter realtek rtl8192cu tp link wireless n usb adapter realtek rtl8188cus tp link tl wn727n wireless n usb adapter ralink rt5390 sdr rtl sdr blog v3 realtek rtl2832u most devices not explicitly listed should work please open an issue if you find a device that doesn t work pager previous page container image volume files next page sound 2024 orbital labs llc
|