HelixDB Docs

Reference

Restart an existing background local instance in place. Local only.

Usage

helix restart [INSTANCE]

Argument	Description
`INSTANCE`	Local instance to restart. Defaults to `dev`, then the only local instance, then a picker in a terminal; otherwise the command fails and lists the local instances.

Flag	Description	Default
`--json`	Print `instance` as JSON on stdout, and never prompt.	Off

Restarts the existing container with its current image and container settings. It never pulls an image or creates a replacement container.
If the container has been removed (for example after helix stop or helix prune), the command fails. Use helix start to create a container.
Readiness is checked with GET /healthz on the container’s published port, including a temporary helix start --port override.
Default local data is in-memory and is wiped by every restart. Disk-mode instances keep data in their local SeaweedFS volume, and S3 data is never deleted.
restart takes no overrides. To change the image, port, or storage mode, use helix start, adding --persist to save the change.

# Restart the default 'dev' instance
helix restart dev

# Restart 'dev' or the only local instance, or pick one
helix restart