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:

Remote Builds
Get started with Namespace's high-performance remote builders.
Command Line
Ephemeral Clusters
Container-optimized compute, perfect for testing. Use any API: containerd, Docker, or Kubernetes.
Command Line
Faster GitHub Actions
Seamlessly perform remote builds and run workloads in ephemeral clusters from GitHub Actions.
Continuous Integration

Remote 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?

Remote Builders in the real world
Explore how you can use Remote Builders in an end-to-end real-world example.
Guide

Ephemeral Clusters

Create disposable Kubernetes clusters, which become ready in seconds and are perfect for running tests.

1
Download the nsc CLI.
$ curl -fsSL https://get.namespace.so/cloud/install.sh | sh
2
Login to your Namespace account.
$ nsc login
3
Create an ephemeral cluster.
$ nsc cluster create
Created cluster "abcyxz"
4
Deploy an application.
$ nsc kubectl abcxyz create deployment nginx -- --image=nginx
That's it! Nginx is running in a new Kubernetes cluster.

Faster GitHub Actions

Namespace provides GitHub actions that allow you to use remote builds and ephemeral clusters from your workflows seamlessly.

1
Add namespacelabs/nscloud-setup(docs) to your Github workflow
 permissions:
   id-token: write
   contents: read
 steps:
   - uses: namespacelabs/nscloud-setup@v0
2
Replace docker build calls with nsc build in your workflow or any scripts or programs invoked within your workflow.
 steps:
   - run: nsc build . --name myimage --push
3
And you're building!
nsc will push the resulting image to Namespace's Container Registry.

What to try next?

Explore our Up and Running examples.