logo

Quickstart

Namespace provides a suite of container workflows specifically designed for development and testing purposes. It offers a wide range of essential features with minimal effort required. Enjoy high-performance capabilities at an affordable and manageable cost.

To get started, pick one of the supported workflows:

Faster GitHub Actions
Accelerate your GitHub Actions while saving cost.
Continuous Integration
Faster Docker Builds
Get started with Namespace's high-performance remote builders.
Command Line
Previews
Fast and secure Previews for developers who want rapid feature sharing and iteration.
Command Line

Faster GitHub Actions

Namespace offers performant and configurable GitHub Runners that boot in a few seconds and come with caching capabilities to speed up your GitHub workflows.

1

Connect your GitHub organization to Namespace

2

Update your workflows

Change the runs-on field in a workflow file to a Namespace profile or label.

  jobs:
    build:
-     runs-on: ubuntu-latest
+     runs-on: namespace-profile-default
      steps:
        - name: Checkout
          uses: actions/checkout@v4
      ...
To read more about the available configuration options, including machine sizes, see Runner machine resources.
3

Done!

Your GitHub workflow will now run on Namespace!

What to try next?

Zero-latency caching
Store dependencies, tools, and any data that needs to be available across invocations.
Guide
Docker image caching
Skip expensive Docker pulls and image unpacking.
Guide
Pre-installed dependencies
Accelerate your worflows further by pre-installing Ubuntu packages.
Guide

Faster Docker Builds

Perform remote multi-platform builds with cross-invocation caching and zero configuration. These builds run on high-capacity resources, typically 16+ cores and 32+ GB of RAM, which will give you a comfortable speed-up compared with most hosted CI providers.

1
Download the nsc CLI.
$ curl -fsSL https://get.namespace.so/cloud/install.sh | sh
2
Login to your Namespace account.
$ nsc login
3
Run nsc build where you would have called docker build.
$ nsc build . --name myimage --push
4
And you're building!
nsc will push the resulting image to Namespace's Container Registry.

What to try next?

Seamless Docker integration
Keep using Docker CLI while benefiting from higher performance builds.
Guide
Build Performance debugging
Understand where your builds spend time and how to speed them up.
Guide

Previews

Fast and secure Previews for developers who want rapid feature sharing and iteration.

1
Download the nsc CLI.
$ curl -fsSL https://get.namespace.so/cloud/install.sh | sh
2
Login to your Namespace account.
$ nsc login
3
Run nsc run where you would have called docker run.
$ nsc run --image nginx -p 80
4
And you're running a preview!
nsc created a fresh ephemeral environment and started nginx in it. Port 80 is exported to a public, authenticated endpoint.

What to try next?

Developing with Previews
Share your changes with your teammates on a public authenticated URL.
Guide
Previews on Kubernetes
Rapid feature sharing and iteration on Kubernetes.
Guide