nkapp run

Deploy services only, without touching infrastructure. Useful when infrastructure is already provisioned and you only need to update application containers. Now supports targeting specific services.

nkapp run [service] [options]

Options

Flag	Type	Default	Description
-e, --env <env>	string	local	Target environment
-b, --branch <name>	string	—	Explicitly work with a database branch (isolate data)

The positional [service] accepts a service name or a database name — running nkapp run my_db reconciles just that database instance.

---

When to Use

Scenario	Command
First setup (infra + services)	nkapp up
Infrastructure already running, services need update	nkapp run
Only want to see what would change	nkapp plan

nkapp run is essentially the service-only half of nkapp up. It skips the infrastructure planning and provisioning phases entirely.

---

Examples

# Reconcile all services locally
nkapp run -e local

# Reconcile only the "docs" service
nkapp run docs -e local

# Update services on staging
nkapp run -e stage

# Update only the "api" service on staging
nkapp run api -e stage