> ## Documentation Index
> Fetch the complete documentation index at: https://namespace.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Start building with Namespace

> Everything you need to integrate Namespace into your applications. From first API call to production.

Build directly on Namespace for your own workloads, or build a platform that runs workloads for your customers, each in their own isolated tenant.

> [card] [Build a platform](https://namespace.so/docs/platform/tenants/quickstart.md)
>
> Give each customer a tenant, and act inside it on their behalf.

> [card] [Run workloads](https://namespace.so/docs/platform/instances/quickstart.md)
>
> Create your first instance with your `nsc login`.

```typescript TypeScript theme={null}
const created = await computeClient.compute.createInstance({
  shape: {
    virtualCpu: 2,
    memoryMegabytes: 4096,
    machineArch: "amd64",
    os: "linux",
  },
  documentedPurpose: "quickstart",
  deadline: timestampFromDate(new Date(Date.now() + 60 * 60 * 1000)),
  containers: [
    {
      name: "demo",
      imageRef: "busybox",
      args: ["sh", "-c", "echo hello from Namespace"],
    },
  ],
});
```

```go Go theme={null}
resp, err := computeClient.Compute.CreateInstance(ctx, &computepb.CreateInstanceRequest{
	Shape: &computepb.InstanceShape{
		VirtualCpu:      2,
		MemoryMegabytes: 4 * 1024,
		MachineArch:     "amd64",
		Os:              "linux",
	},
	DocumentedPurpose: "quickstart",
	Deadline:          timestamppb.New(time.Now().Add(1 * time.Hour)),
	Containers: []*computepb.ContainerRequest{{
		Name:     "demo",
		ImageRef: "busybox",
		Args:     []string{"sh", "-c", "echo hello from Namespace"},
	}},
})
```

```bash curl theme={null}
curl -sS -X POST "$COMPUTE_API/$SERVICE/CreateInstance" \
  -H "Authorization: Bearer $NSC_TOKEN" \
  -H "Content-Type: application/json" \
  -d @- <<JSON
{
  "shape": {
    "virtualCpu": 2,
    "memoryMegabytes": 4096,
    "machineArch": "amd64",
    "os": "linux"
  },
  "documentedPurpose": "quickstart",
  "deadline": "$DEADLINE",
  "containers": [
    {
      "name": "demo",
      "imageRef": "busybox",
      "args": ["sh", "-c", "echo hello from Namespace"]
    }
  ]
}
JSON
```

The same call works in both cases. Only the credential behind `computeClient` changes: your `nsc login` while you develop, or a tenant token when your platform acts for a customer.
See the [Instances quickstart](https://namespace.so/docs/platform/instances/quickstart.md) for the full call, including authentication and waiting for the instance to become ready.

## Authenticate

Every call authenticates with a credential that decides where it acts.
While you develop, your `nsc login` acts in your own workspace.
A platform uses partner credentials to manage its tenants, and tenant tokens to act inside each one.

> [card] [Build on your own workspace](https://namespace.so/docs/platform/authentication/local-development.md)
>
> Start with your `nsc login`, no partner account needed.

> [card] [Partner credentials](https://namespace.so/docs/platform/authentication/partner-credentials.md)
>
> Authenticate as your platform to manage tenants.

> [card] [Tenant tokens](https://namespace.so/docs/platform/authentication/tenant-tokens.md)
>
> Act inside a customer's tenant.

## Building blocks

Pick the infrastructure that fits your stack.

> [card] [Compute](https://namespace.so/docs/platform/compute.md)
>
> Linux and macOS machines, shapes, resource limits, and observability.

> [card] [Networking](https://namespace.so/docs/platform/networking.md)
>
> Ingress, access controls, egress policy, and performance.

> [card] [Storage](https://namespace.so/docs/platform/storage.md)
>
> Cache volumes, the container registry, artifacts, and secrets.

The full API reference is at [API and SDKs](https://namespace.so/docs/reference/api.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.