nself region

Set the preferred datacenter region for ɳCloud managed deployments. Affects where new managed instances are provisioned.

Quick start

# See available regions
nself region list

# Set your preferred region
nself region set eu-central

# Confirm current region
nself region get

Synopsis

nself region <SUBCOMMAND> [FLAGS]

Description

nself region applies to ɳCloud managed deployments only. When you provision a new managed instance via nself cloud provision, the CLI uses the region preference set here to choose the closest datacenter.

Self-hosted deployments are not affected by this setting — region for self-hosted is determined by where you run the CLI and which VPS you point it at.

The region preference is stored in ~/.nself/config.json and is scoped to your local machine. It does not affect existing managed instances — only new ones provisioned after the preference is set.

Subcommands

nself region list

List all available ɳCloud regions with their location, latency from your current IP, and availability status.

nself region list
# REGION          LOCATION              LATENCY   STATUS
# eu-central  ★   Frankfurt, Germany    12ms      available
# us-east         Ashburn, VA, USA      98ms      available
# us-west         San Jose, CA, USA     142ms     available
# ap-southeast    Singapore             231ms     available
# ap-northeast    Tokyo, Japan          267ms     available
#
# ★ current preference

JSON output:

nself region list --json

nself region set <region>

Set the preferred region. Takes effect for all subsequent nself cloud provision commands on this machine.

nself region set eu-central
# ✓ Region preference set to eu-central (Frankfurt, Germany)

nself region set us-east
# ✓ Region preference set to us-east (Ashburn, VA, USA)

nself region get

Print the current region preference.

nself region get
# eu-central (Frankfurt, Germany)

JSON output:

nself region get --json
# {"region":"eu-central","location":"Frankfurt, Germany","status":"available"}

Flags

Available regions

Additional regions may be added as ɳCloud infrastructure expands. Run nself region list for the live list.

Examples

Pick the lowest-latency region automatically

# The list sorts by latency — the top entry is fastest from your location
nself region list
# Then set it:
nself region set eu-central

CI pipeline: set region before provisioning

nself region set us-east
nself cloud provision --plan starter --domain myapp.com

Exit codes

• 0 — success
• 1 — unknown region ID or API error
• 2 — invalid arguments

Related

• nself cloud — provision and manage ɳCloud managed instances
• nself deploy — deploy to a self-hosted VPS (region not relevant)