Meta tags:
description= Run full Linux machines with your choice of distro, integrated Linux and Mac commands, fast file sharing, and easy setup. Supports Intel emulation, resource efficiency, SSH agent forwarding, and advanced automation via cloud-init or CLI.;
Headings (most frequently used words):
machines, linux, x86, resource, get, started, learn, more, features, docker, containers, kubernetes, compare, legal, services, file, transfer, run, mac, commands, from, copy, files, between, ssh, usage, machine, creation, limits, cloning, import, export, intel, emulation, graphical, apps, user, accounts, usb, devices, environment, variables, boot, logs, nested, virtualization, kernel, headers, macos, executables, keys, agent, server, automatic, setup, programs, emulating, other, cpu, architectures, multi, architecture, debugging, with, gdb, lldb, root, access, password, additional, users, cloud, init,
Text of the page (most frequently used words):
ubuntu (35), the (33), for (30), linux (29), you (28), #machines (26), machine (25), can (25), orb (23), and (22), run (22), bash (20), with (16), mac (16), orbstack (15), arch (15), set (14), use (13), commands (12), create (12), new (11), using (10), are (10), sudo (9), amd64 (9), intel (9), more (8), from (8), example (8), see (8), user (8), your (8), server (8), install (8), x86 (8), support (7), command (7), password (7), main (7), ssh (7), apple (6), macos (6), default (6), this (6), files (6), root (6), programs (6), multi (6), deb (6), http (6), com (6), lunar (6), restricted (6), universe (6), multiverse (6), ports (6), cpu (6), file (6), setup (6), foo (6), not (5), available (5), silicon (5), also (5), devices (5), usb (5), apt (5), distro (5), copy (5), init (5), kernel (4), but (4), logs (4), editor (4), export (4), all (4), allows (4), them (4), additional (4), without (4), gdb (4), qemu (4), distros (4), security (4), arm (4), bit (4), other (4), open (4), limits (4), config (4), cloud (4), information (4), page (3), kubernetes (3), that (3), supported (3), tar (3), boot (3), wsl (3), aws_access_key_id (3), orbenv (3), forward (3), variables (3), fastboot (3), adb (3), link (3), directly (3), creating (3), same (3), access (3), another (3), x86_64 (3), debug (3), lldb (3), libraries (3), archive (3), arm64 (3), architecture (3), program (3), two (3), built (3), import (3), data (3), settings (3), disk (3), memory (3), line (3), any (3), mnt (3), services (3), start (3), docker (3), isolated (2), modules (2), possible (2), have (2), nearly (2), update (2), headers (2), currently (2), nested (2), virtualization (2), output (2), one (2), environment (2), list (2), seamlessly (2), installed (2), usual (2), versions (2), tools (2), details (2), users (2), log (2), when (2), name (2), configured (2), passwordless (2), etc (2), choose (2), graphical (2), apps (2), 1234 (2), hello (2), static (2), connect (2), search (2), appropriate (2), updates (2), fix (2), add (2), which (2), both (2), needed (2), above (2), rosetta (2), there (2), cpus (2), binaries (2), than (2), emulation (2), utm (2), zst (2), cloning (2), usage (2), clone (2), app (2), resource (2), like (2), automatically (2), script (2), older (2), quick (2), creation (2), efficiency (2), agent (2), servers (2), homebrew (2), prefix (2), similar (2), executables (2), txt (2), transfer (2), sharing (2), networking (2), system (2), nginx (2), policy (2), network (2), containers (2), menu (2), features (2), navigation (2), docs (2), 2024, orbital, labs, llc, next, previous, pager, please, note, building, custom, officially, will, rebuild, every, sys, kheaders, kvm, waiting, side, view, console, compatibility, scripts, written, wslenv, proceeding, apply, terraform, forwards, limited, avoid, causing, issues, colon, separated, works, most, cases, they, were, including, working, either, then, alternatively, android, developers, way, linking, pass, through, standard, useradd, adduser, passwd, creates, asking, disable, edit, sudoers, specific, ubuntu2, created, accounts, does, running, x11, option, xrdp, xquartz, continue, remote, target, terminal, attach, emulated, processes, under, enabled, debugging, instructions, vary, libc6, sources, tee, echo, repos, dpkg, enable, some, installing, macs, long, statically, linked, i386, aarch64, armhf, emulating, architectures, means, missing, options, error, failed, elf, lib64, ways, flag, uses, much, faster, providing, near, native, performance, back, move, starts, original, independent, afterward, copied, demand, doesn, double, make, their, own, share, global, bytes, 68719476736, disk_bytes, cores, mib, 4096, memory_mib, change, later, 64g, limit, allowed, advanced, format, aws, ec2, providers, ansible, automatic, jammy, version, easy, less, minute, fast, connections, gui, automate, idle, compared, baseline, dozens, breaking, sweat, has, multiplexes, need, each, forwarded, push, git, keys, between, opt, bin, path, gcc, compile, mach, binfmt_misc, useful, development, uname, pbcopy, clipboard, text, common, aliased, tab, finder, localhost, depending, may, systemd, openrc, runit, configure, systemctl, web, full, windows, subsystem, these, highly, integrated, lightweight, work, almost, exactly, traditional, virtual, variety, source, licenses, subprocessors, privacy, public, sector, amendment, master, software, license, agreement, terms, service, legal, colima, desktop, compare, distributions, host, volumes, mounts, images, bar, sound, container, image, volume, https, domains, shell, bulletins, licensing, benchmarks, learn, what, frequently, asked, questions, home, get, started, sidebar, return, top, appearance, demo, overview, skip, content,
Text of the page (random words):
linux machines 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 linux machines orbstack can run full linux machines with a variety of distros similar to the windows subsystem for linux wsl these are highly integrated lightweight machines that work almost exactly like traditional virtual machines services you can run services in linux machines using your distro s init system for example to run a web server on ubuntu bash apt install nginx systemctl start nginx depending on your distro the init system may be systemd openrc or runit you can configure services to start on boot as usual servers are available at localhost see networking for more information file transfer mac files are available in linux machines at mnt mac and linux files are available from mac at orbstack or the orbstack tab in finder see file sharing for more information file transfer commands are also available run mac commands from linux common mac commands are aliased by default so you can run them from linux bash open foo txt in the default mac text editor open foo txt copy ps output to mac clipboard ps pbcopy you can prefix any command with mac bash mac uname a see commands for more information macos executables similar to wsl you can also run macos executables mach o from linux using binfmt_misc which can be useful for development for example bash compile a c program for macos mac gcc o foo foo c run it mac prefix not needed foo this allows you to add macos binaries to your linux path for example opt homebrew bin to run homebrew commands from linux copy files between machines you can access files from other linux machines at mnt machines bash ls mnt machines foo ssh keys agent your ssh agent is automatically forwarded to linux machines so you can push to git and connect to ssh servers without any additional setup server orbstack has a built in ssh server that multiplexes access to all linux machines so there is no need to install an ssh server in each machine resource usage idle linux machines use nearly no additional cpu compared to orbstack s baseline so you can run dozens of machines without breaking a sweat see efficiency for more information machine creation creating machines with any supported distro is easy and quick less than 1 minute on fast connections you can use the gui or automate creation using the command line bash orb create ubuntu new ubuntu an older version orb create ubuntu jammy new ubuntu intel machine on apple silicon orb create arch amd64 ubuntu new ubuntu see distros for more details automatic setup to set up new machines automatically use the command line to create a machine and run a setup script for example to create a new ubuntu machine and run the setup sh script bash orb create ubuntu new ubuntu orb m new ubuntu setup sh cloud init for more advanced setup you can use cloud init with the same user data format as aws ec2 and other cloud providers or other tools like ansible with the built in ssh server resource limits you can limit the memory cpu and disk a machine is allowed to use set limits when creating a machine bash orb create memory 4g cpus 2 disk 64g ubuntu my machine you can also change them later in the machine s settings in the app or with orb config set bash orb config set machine my machine memory_mib 4096 mib orb config set machine my machine cpu 2 cpu cores orb config set machine my machine disk_bytes 68719476736 bytes machines without their own limits share orbstack s global memory and cpu limits cloning to make a copy of a machine use orb clone bash orb clone ubuntu ubuntu copy the copy starts with all the data and settings of the original but the two are independent afterward data is copied on demand so cloning doesn t double your disk usage import export you can export a machine to a file to back it up or move it to another mac bash orb export ubuntu ubuntu tar zst to import a machine from a file bash orb import n new name ubuntu tar zst intel x86 emulation x86 machines on apple silicon orbstack uses rosetta to run linux machines with intel x86_64 amd64 binaries this is much faster than emulation with qemu or utm seamlessly providing near native performance to create an intel machine use the arch flag bash orb create arch amd64 ubuntu new ubuntu x86 programs there are two ways to run programs built for intel x86 cpus on apple silicon create an intel machine see above and run the program in it install multi arch support in an arm machine if you see rosetta error failed to open elf at lib64 ld linux x86_64 so it means you re missing multi arch support choose one of the two options above to fix it emulating other cpu architectures orbstack can run 32 bit arm armhf 64 bit arm aarch64 32 bit intel i386 and 64 bit intel amd64 programs on both apple silicon and intel macs as long as you have the appropriate libraries installed or the program is statically linked multi architecture some linux distros support multi arch which allows you to run both x86 and arm programs in the same machine by installing the libraries needed to run x86 programs for example on ubuntu bash enable multi arch sudo dpkg add architecture amd64 fix repos echo deb arch arm64 http ports ubuntu com ubuntu ports lunar main restricted universe multiverse deb arch arm64 http ports ubuntu com ubuntu ports lunar updates main restricted universe multiverse deb arch arm64 http ports ubuntu com ubuntu ports lunar security main restricted universe multiverse deb arch amd64 http archive ubuntu com ubuntu lunar main restricted universe multiverse deb arch amd64 http archive ubuntu com ubuntu lunar updates main restricted universe multiverse deb arch amd64 http archive ubuntu com ubuntu lunar security main restricted universe multiverse sudo tee etc apt sources list install libraries sudo apt update sudo apt install libc6 amd64 instructions vary by distro and not all distros e g arch support multi arch search for the appropriate commands for your distro debugging with gdb lldb gdb and lldb can t attach directly to emulated x86 processes but you can run x86 programs under qemu with the debug server enabled and connect to the debug server using gdb lldb for example bash sudo apt install qemu user static qemu x86_64 static g 1234 hello in another terminal gdb hello target remote 1234 continue graphical apps orbstack does not currently support running graphical linux apps by default but you can set up xquartz and use it as an x11 server in linux xrdp is another option user accounts root access machines are created with passwordless sudo configured for your user you can log in as root directly using orb u root or orb m ubuntu2 u root to choose a specific machine this allows you to set a root password and use su for example to disable passwordless sudo edit etc sudoers d orbstack password by default orbstack creates a user with the same name as your macos user with no password set sudo is configured to run commands as root without asking for a password to set a password bash orb sudo passwd user you can also set a default password when creating a machine bash orb create set password ubuntu new ubuntu additional users use the standard adduser or useradd commands to create additional users you can log in as them directly using orb u user usb devices you can pass usb devices through to linux machines see usb devices for details alternatively you can use command linking to run the mac versions of usb tools from linux for example android developers can use adb and fastboot this way bash link commands mac link adb mac link fastboot then run them as usual adb devices fastboot devices this works seamlessly in most cases and allows you to run commands as if they were installed on linux including working with files on either linux or mac environment variables by default orbstack forwards a limited set of environment variables to avoid causing issues to forward more set orbenv to a colon separated list of variables to forward bash forward editor and aws_access_key_id for one command orbenv editor aws_access_key_id orb terraform apply or for all proceeding commands export orbenv editor aws_access_key_id for compatibility with scripts written for wsl wslenv is also supported boot logs to view a machine s boot logs and console output use the orb logs command bash orb logs ubuntu nested virtualization it s not currently possible to support nested kvm virtualization on apple silicon we re waiting for apple to support it on the macos side kernel headers headers for the linux kernel are available at sys kernel kheaders tar xz please note that building custom kernel modules is possible but not officially supported you will have to rebuild modules for nearly every orbstack update pager previous page using kubernetes next page isolated machines 2024 orbital labs llc
|