cmd stop

nself stop

Gracefully shut down all services or specific named services.

Synopsis

nself stop [SERVICES...] [flags]

Alias: nself down

Description

nself stop shuts down the ɳSelf stack gracefully. By default it sends SIGTERM to running containers and waits for them to exit cleanly before running docker compose down. The graceful shutdown timeout is 30 seconds by default and can be adjusted with --graceful.

You can stop specific services by passing their names as positional arguments. When stopping individual services, only those containers are affected, the rest of the stack remains running.

Data is always preserved. Volumes are only removed when --volumes is explicitly passed (this is destructive and will delete your database and all stored data). When --volumes or --rmi is set, the graceful stop phase is skipped for speed.

Flags

Name	Shorthand	Type	Default	Env	Escalates to	JSON override	Description
--graceful		int	30				Graceful shutdown timeout in seconds
--no-monorepo		bool	false				Disable automatic monorepo backend detection
--remove-images		bool	false				Alias for --rmi
--remove-orphans		bool	false				Remove orphaned containers
--rmi		bool	false				Remove Docker images
--verbose		bool	false				Show detailed output
--volumes	-v	bool	false		destructive		Remove volumes (WARNING: deletes data)
--help	-h	bool	false				Show help

Contract

• Side effect: write
• Output: document
• JSON: envelope (data schema)
• Exit codes: none declared

Examples

# Stop all services gracefully
nself stop

# Using the alias
nself down

# Stop only specific services
nself stop postgres redis

# Stop and remove volumes (destroys all data)
nself stop --volumes

# Stop and remove Docker images
nself stop --rmi

# Clean up orphaned containers
nself stop --remove-orphans

# Extended graceful shutdown timeout
nself stop --graceful 60

See Also

• Commands — full command index
• Core-Services — what a stack is made of

← Commands | Home →