# Create a hosted core

Deploy a managed 5G core from the dashboard, CLI, or API.

Product: Hosted Core

Human documentation: https://www.1sc.dev/docs/quickstart

Documentation index: https://www.1sc.dev/llms.txt

## Deploy from the dashboard

- [Sign in to 1sc.dev](https://www.1sc.dev/sign-in) and open Dashboard.
- Under Deploy 5G Core, fill out your preferences.
- Click Deploy 5G Core.

The deployment page opens automatically and shows launch progress, endpoints, logs, and attach evidence.

## Deploy from the CLI

### Command

Command: `npx @1sc-hq/1sc deploy`

| Field | Flag | Type | Requirement | Default | Details |
| --- | --- | --- | --- | --- | --- |
| name | --name | text | Required unless agent is set |  | Example: radio-lab Required unless Agent mode is on. With Agent mode on, leaving this empty generates a name such as agent-core-20260717-123456. |
| agent | --agent | boolean | Optional | true | Runs this deployment end-to-end without interactive babysitting. Turns on --json, so output is machine-readable. Turns on --yes, so it skips the billable-action confirmation prompt. Turns on waiting, so the command does not exit right after creating the deployment. Turns on hosted attach verification, so after the core is ready it runs UERANSIM validation. Defaults cleanup to stop unless you change it. |
| radioSource | --radio-source | cidr | Optional |  | Example: 203.0.113.42/32 Leave auto-detect off the command, or set a public radio source CIDR. |
| core | --core | select | Optional | fivegc | Options: fivegc, free5gc, open5gs Selects the hosted core runtime. |
| cleanup | --cleanup | select | Optional | stop | Options: keep, stop, destroy Stops compute after verification by default. |

Approve the browser login if prompted. The example generates a name, deploys the core, verifies hosted attach, and stops compute afterward.

| Option | Required | Default / options | Purpose |
| --- | --- | --- | --- |
| --name <name> | Required unless --agent is set | Any deployment name | Names the deployment. |
| --agent | Optional | Flag | Enables JSON output, --yes, wait, hosted attach verification, and generated naming defaults. |
| --radio-source <cidr\|auto> | Optional | CIDR or auto | Restricts N2/N3 access to the radio source. auto detects the caller's IPv4 /32. |
| --core <fivegc\|free5gc\|open5gs> | Optional | fivegc, free5gc, open5gs; default fivegc | Selects the hosted core implementation. |
| --verify | Optional | Flag | Waits for readiness, then runs hosted attach verification. |
| --cleanup <keep\|stop\|destroy> | Optional | keep, stop, destroy; default keep | Keeps, stops, or destroys the deployment after verification. |
| --timeout <duration> | Optional | Example: 45m; default 30m | Sets the maximum wait time for readiness, attach verification, and cleanup. |
| --yes | Required unless --agent is set | Flag | Confirms the billable deployment action. |
| --api-url <url> | Optional | URL | Overrides the 1sc API URL. |
| --json | Optional | Flag | Prints JSON output. |

## Deploy from the API

- [Create an Operator API token](https://www.1sc.dev/dashboard/agent-access), store it in ONE_SC_API_TOKEN, then create the deployment.

### Create deployment request

Endpoint: `POST https://www.1sc.dev/api/v1/deployments`

| Field | Flag | Type | Requirement | Default | Details |
| --- | --- | --- | --- | --- | --- |
| name |  | text | Required | radio-lab | Example: radio-lab Stored on the deployment record. |
| managedAws |  | boolean | Required | true | Required for the hosted launch path. |
| radioSourceCidr |  | cidr | Optional |  | Example: 203.0.113.42/32 Use auto-detect when the API caller and radio share the same public source. |
| coreImplementation |  | select | Optional | fivegc | Options: fivegc, free5gc, open5gs Selects the runtime to launch. |
| coreProfile |  | select | Required | minimal-sa-lab | Options: minimal-sa-lab Only the minimal SA lab profile is currently supported. |

| Field | Required | Default / options | Purpose |
| --- | --- | --- | --- |
| name | Required | Any deployment name | Names the deployment. |
| managedAws | Required | true | Creates and launches the managed AWS runtime. |
| radioSourceCidr | Optional | Empty string for caller IPv4 /32 auto-detect, or a public CIDR | Restricts N2/N3 access to the radio source. |
| coreImplementation | Optional | fivegc, free5gc, open5gs; default fivegc | Selects the hosted core implementation. |
| coreProfile | Required | minimal-sa-lab | Selects the supported hosted lab profile. |

## Manage the deployment

Open Dashboard → Deployments to inspect status, endpoints, logs, attach results, and lifecycle controls.