Meta tags:
description= Namespace accelerates the development workflow of fast-moving software engineering teams. Best-in-class compute and development-supporting services that lead to 2x-10x faster builds, tests, and more.;
Headings (most frequently used words):
devboxes, idleness, spec, file, from, managing, machine, sizes, create, devbox, listing, starting, stopping, auto, stop, deleting, volume, size, reference, workspace, defaults, git, configuration, setting, up, github, cli, resource, monitoring, site, latency, self, update, next, steps, introducing, we, re, hiring, join, us, in, line, params, ephemeral, how, is, detected, sessions, environment, variables, network, policy, integrations, example, reading, stdin, repository,
Text of the page (most frequently used words):
nsc (75), the (72), #devbox (66), name (30), github (29), #devboxes (25), and (23), create (20), your (19), with (15), image (15), repository (15), list (15), dashboard (14), default (14), from (13), size (13), git (13), workspace (13), spec (12), cli (11), see (11), sessions (10), via (10), are (10), setup (10), all (10), base (9), site (9), when (9), you (9), token (9), yaml (9), ephemeral (9), registry (9), artifact (9), docker (9), ssh (8), this (8), integrations (8), use (8), actions (8), automatically (7), true (7), policy (7), tailscale (7), idle (7), instance (7), command (7), run (7), below (7), vault (7), required (7), cache (7), profile (7), namespacelabs (7), created (6), network (6), local (6), login (6), value (6), can (6), access (6), com (6), description (6), field (6), namespace (6), volume (6), describe (6), action (6), nscloud (6), overview (6), images (5), persistent (5), update (5), latency (5), available (5), usage (5), for (5), running (5), agents (5), file (5), auth (5), open (5), configuration (5), url (5), its (5), delete (5), storage (5), json (5), vcpu (5), custom (4), remote (4), resource (4), both (4), setup_github (4), share_auth (4), builtin (4), configure (4), how (4), timeout (4), defaults (4), network_policy (4), from_secret_id (4), env (4), npm (4), any (4), managing (4), environment (4), session (4), reference (4), container (4), stop (4), burst (4), upload (4), buildx (4), build (3), connect (3), check (3), page (3), connection (3), memory (3), cpu (3), shows (3), read (3), flag (3), pass (3), across (3), active (3), outbound (3), integration (3), private (3), mode (3), clone (3), set (3), api (3), egress_domains (3), test (3), dev (3), privileged (3), auto_stop_idle_timeout (3), volume_size_gb (3), supports (3), block (3), checkout (3), secrets (3), machine (3), options (3), data (3), interactive (3), deleting (3), tasks (3), stdin (3), toml (3), download (3), ingress (3), expose (3), kubernetes (3), started (3), last (2), restarts (2), development (2), next (2), creating (2), closest (2), metrics (2), detail (2), utilization (2), monitoring (2), authentication (2), step (2), requires (2), also (2), don (2), need (2), commands (2), operations (2), path (2), forward (2), user (2), email (2), click (2), dialog (2), values (2), shown (2), long (2), just (2), wide (2), shared (2), openai (2), github_token (2), production (2), app_env (2), watch (2), tests (2), server (2), ref (2), org (2), repo (2), 30m (2), access_mode (2), equivalent (2), domains (2), allowed (2), prefix (2), disabled (2), omit (2), out (2), branch (2), string (2), each (2), entry (2), has (2), one (2), variables (2), auto (2), mutually (2), exclusive (2), name_prefix (2), override (2), context (2), picker (2), force (2), skip (2), only (2), files (2), which (2), idleness (2), min (2), hours (2), retain (2), stopping (2), listing (2), prompts (2), sizes (2), status (2), trust (2), generate (2), sccache (2), pants (2), gradle (2), bazel (2), expiration (2), extend (2), job (2), logs (2), builds (2), circleci (2), security (2), limits (2), getting (2), logo (2), updated, june, 2026, tools, runtimes, pre, installed, terminal, that, survive, disconnections, code, cursor, zed, jetbrains, steps, keep, date, self, measures, selects, best, manually, sites, these, streamed, real, time, ping, indicator, showing, quality, current, percentage, history, overall, per, core, historical, graphs, live, before, missing, expired, fails, fast, because, forwards, activated, given, overrides, enable, part, acquiring, separate, transfers, configures, https, authenticated, setting, sets, author, used, header, enforced, take, precedence, locked, restrictions, tailnet, stay, members, allocation, admins, applied, newly, navigate, corp, main, false, 100, example, level, specs, authenticates, passing, object, reach, domain, include, subdomains, infrastructure, always, restricts, fall, back, explicitly, checked, tag, commit, sha, using, shorthand, skips, entirely, including, learn, manage, sec_8fumgjd5jk, secret, literal, expansion, variable, exactly, more, pairs, have, specified, startup, gib, case, insensitive, target, omitted, selected, into, either, generated, random, suffix, appended, exact, persisted, lifecycle, duration, 300, menu, without, argument, prompted, confirm, typing, confirmation, permanently, removes, associated, countdown, applies, once, none, conditions, above, present, exist, under, indicate, ongoing, users, was, within, minutes, there, whether, through, native, client, includes, connections, kept, ides, considered, not, following, detected, expand, section, advanced, control, stays, after, becoming, timeouts, hour, stopped, they, resume, seconds, button, presents, alias, shutdown, start, ide, starting, grouped, toggle, between, viewing, own, output, scripting, show, suit, short, lived, experimentation, where, tying, their, single, stops, deleted, restart, starts, fresh, cat, parsed, from_format, reading, works, acquire, yml, non, interactively, define, parameters, inline, specific, line, params, new, counts, represent, burstable, capacity, may, restrict, provide, same, configuring, support, center, soc2, changelog, revoke, relationships, add, share, expire, release, submodules, optimize, cleanup, attach, kubectl, kubeconfig, write, port, proxy, rdp, vnc, top, report, destroy, version, installation, turbocache, breakpoint, cluster, sdk, explorer, rwx, openid, gcp, aws, federation, permissions, audit, logging, residency, billing, workspaces, egress, filtering, performance, networking, volumes, shapes, display, observability, windows, macos, linux, compute, framework, claude, checkouts, nix, moonrepo, android, emulators, playwright, turborepo, coding, introduction, containers, previews, tracing, builders, optimizing, migration, guide, debugging, caching, roles, hiring, join, article, introducing, sidebar, get, company, resources, pricing, customers, cases,
Text of the page (random words):
managing devboxes namespace logo use cases customers pricing resources company get started login open sidebar introducing devboxes read article we re hiring join us open roles logo overview github actions getting started caching docker builds custom base images debugging github actions migration guide optimizing usage reference docker builders getting started container registry tracing logs previews containers kubernetes devboxes introduction managing devboxes remote development sessions custom images coding agents integrations bazel turborepo playwright android emulators gradle sccache circleci pants moonrepo nix git checkouts docker images claude tailscale any framework compute overview linux macos windows observability ssh remote display machine shapes resource limits storage overview cache volumes container registry artifact storage secrets networking overview ingress performance security egress filtering workspaces overview access billing and limits data residency security audit logging permissions federation overview aws gcp openid github actions circleci rwx dashboard github actions builds registry usage explorer api sdk github actions namespacelabs nscloud setup namespacelabs nscloud setup buildx action namespacelabs nscloud cluster action namespacelabs nscloud cache action namespacelabs nscloud checkout action namespacelabs nscloud expose kubernetes action namespace actions upload artifact namespace actions download artifact namespacelabs breakpoint action namespace actions setup turbocache cli installation nsc version nsc login nsc workspace describe nsc create nsc destroy nsc extend nsc list nsc instance report nsc logs nsc top nsc ssh nsc vnc nsc rdp nsc proxy nsc instance port forward nsc instance download nsc instance upload nsc kubeconfig write nsc kubectl nsc docker login nsc docker attach context nsc docker remote nsc docker buildx setup nsc docker buildx cleanup nsc docker buildx status nsc build nsc base image upload nsc base image optimize nsc run nsc expose container nsc expose kubernetes nsc ingress list nsc ingress generate access token nsc github profile nsc github profile create nsc github profile list nsc github profile describe nsc github profile update nsc github profile delete nsc github profile test build base image nsc github base image list nsc github base image describe nsc github job list nsc github job describe nsc git checkout update submodules nsc volume list nsc volume release nsc artifact upload nsc artifact download nsc artifact expire nsc artifact extend nsc artifact describe nsc artifact cache url nsc registry list nsc registry describe nsc registry share nsc registry update image expiration nsc registry policy nsc registry default expiration nsc cache bazel setup nsc cache gradle setup nsc cache pants setup nsc cache sccache setup nsc vault list nsc vault add nsc vault set nsc vault delete nsc auth check login nsc auth generate dev token nsc auth trust relationships nsc token create nsc token list nsc token revoke changelog trust center soc2 status support managing devboxes listing stopping deleting configuring defaults and monitoring resource usage machine sizes both the cli size and the dashboard provide the same size options size cpu memory s burst to 4 vcpu 8 gb m burst to 8 vcpu 16 gb l burst to 16 vcpu 32 gb xl burst to 32 vcpu 64 gb vcpu counts represent burstable capacity your workspace policy may restrict which sizes are available create devbox create a new devbox with interactive prompts devbox create in line params pass parameters inline to skip specific prompts devbox create name my devbox size m image builtin agents from a spec file define your devbox configuration in a spec file devbox yaml name my devbox image builtin agents size m repository github com your org your repo and create it non interactively with from devbox create from devbox yaml see spec file reference below for all available configuration options spec files can be json json yaml yaml yml or toml toml the from flag works with devbox acquire reading from stdin pass as the path to read the spec from stdin stdin is parsed as yaml by default use from_format to override json yaml or toml cat devbox yaml devbox create from ephemeral devboxes devboxes can be created as ephemeral tying their instance and storage to a single run when an ephemeral devbox stops both its instance and storage are automatically deleted on restart it starts fresh ephemeral devboxes suit short lived tasks or experimentation where you don t need to retain data across restarts create an ephemeral devbox with the ephemeral flag devbox create ephemeral listing devboxes via the cli devbox list by default this shows only your devboxes use show all to see all devboxes in the workspace output as json for scripting devbox list o json via the dashboard the devboxes dashboard shows all your devboxes grouped by repository toggle between viewing your own devboxes or all workspace devboxes starting stopping devboxes start automatically when you connect via devbox ssh devbox open ide or from the dashboard to stop a running devbox via the cli devbox shutdown this presents an interactive picker you can also use the alias devbox stop via the dashboard click the stop button on any running devbox in the dashboard or from the devbox detail page stopped devboxes retain all persistent storage they resume in seconds on the next connection idleness auto stop control how long a devbox stays running after becoming idle available timeouts 15 min 30 min 1 hour 4 hours or 8 hours cli devbox create auto_stop_idle_timeout 1h dashboard expand the advanced section in the create dialog to configure the idle timeout how idleness is detected a devbox is considered active not idle if any of the following are true there is an active ssh connection whether through devbox ssh or a native ssh client this includes ssh connections kept open by ides a session was created within the last 15 minutes files exist under namespace tasks which indicate ongoing tasks and can be created by users the idle timeout countdown only applies once none of the conditions above are present deleting deleting a devbox permanently removes it and its associated persistent volume via the cli devbox delete my devbox you ll be prompted to confirm by typing the devbox name skip the confirmation with force devbox delete my devbox force without a name argument an interactive picker is shown via the dashboard delete a devbox from its context menu in the dashboard volume size override the default persistent volume size devbox create volume_size_gb 300 spec file reference field description access_mode access mode private just you or shared workspace wide auto_stop_idle_timeout idle timeout duration e g 30m 1h env environment variables to set on the devbox container see below ephemeral when true the devbox is ephemeral no data is persisted across its lifecycle image image name or reference to use as the base environment required integrations integration configuration see below name exact devbox name required mutually exclusive with name_prefix name_prefix prefix for an auto generated name a random suffix is appended required mutually exclusive with name network_policy outbound network policy see below privileged run in privileged mode omit to use the image default repository git repository to clone into the devbox either a url string or a block of options see below sessions list of sessions to create automatically see below site target site if omitted the closest site is selected automatically size machine size s m l or xl required case insensitive volume_size_gb persistent volume size in gib sessions each entry in sessions has field description name session name required command command to run in the session required configure one or more session command pairs to have the devbox automatically create sessions and run the specified commands on startup sessions name server command npm run dev name tests command npm test watch environment variables each entry in env has a name and exactly one of value or from_secret_id field description name variable name required value literal value supports name name expansion from your local environment from_secret_id workspace vault secret id see nsc vault list env name app_env value production name github_token from_secret_id sec_8fumgjd5jk see managing secrets to learn how to create and manage vault secrets repository the repository block supports field description disabled when true skips the checkout entirely including any workspace default repository url git repository url to clone equivalent to using the string shorthand ref branch tag or commit sha to check out defaults to the repository s default branch omit repository to fall back to the workspace default to explicitly create a devbox with no repository checked out repository disabled true network policy the network_policy block restricts outbound network access field description egress_domains list of domains the devbox is allowed to reach prefix a domain with to include all of its subdomains namespace infrastructure domains are always allowed network_policy egress_domains github com api openai com integrations the integrations object supports field description github share_auth when true authenticates the gh cli and git on the devbox with your local github token see below equivalent to passing setup_github tailscale spec name of a workspace level tailscale integration spec use nsc integrations tailscale list to see available specs example devbox yaml name my devbox image builtin agents size m access_mode private volume_size_gb 100 auto_stop_idle_timeout 30m privileged false repository url github com my org my repo ref main sessions name server command npm run dev name tests command npm test watch integrations github share_auth true tailscale spec corp env name app_env value production name github_token from_secret_id my github token id network_policy egress_domains github com api openai com workspace defaults workspace admins can set default values applied to all newly created devboxes navigate to the defaults page in the dashboard to configure instance size default cpu and memory allocation image default base image git repository default repository to clone access mode private just you or workspace wide shared with all members idle timeout how long devboxes stay running when idle tailscale default tailscale integration spec to connect devboxes to your tailnet network policy default outbound network access restrictions when a workspace policy is active policy enforced values take precedence and are shown as locked in the ui git configuration configure the git author name and email used across your devboxes from the dashboard click your name in the devboxes header to open the git configuration dialog this sets user name and user email for git operations in all your devboxes setting up github cli forward your local gh cli authentication to a devbox devbox setup github my devbox this transfers your local github token to the devbox and configures both the gh cli via gh auth login and git via gh auth setup git to use it so gh commands and https git operations are authenticated this requires gh to be on the devbox s path you can also do this as part of creating or acquiring a devbox so you don t need a separate step pass setup_github devbox create setup_github or enable it in a spec file with integrations github share_auth devbox yaml name my devbox image builtin agents size m integrations github share_auth true the local gh token is read before the devbox is created so a missing or expired login fails fast because it forwards your local authentication this step requires the devbox to be activated when both are given the setup_github flag overrides the spec value resource monitoring the dashboard shows live resource metrics for running devboxes cpu utilization overall and per core usage with historical graphs memory utilization current usage percentage with history network latency ping indicator showing connection quality to your devbox s site these metrics are streamed in real time from the devbox detail page site latency devboxes are automatically created in the site closest to you to manually check latency to available sites devbox site latency the dashboard measures site latency automatically and selects the best site when creating a devbox self update keep the devbox cli up to date devbox update next steps remote development connect to your devbox via ssh vs code cursor zed or jetbrains sessions persistent terminal sessions that survive disconnections and devbox restarts custom images build custom base images with your tools and runtimes pre installed last updated june 3 2026
|
