---
title: "vakna: box <box> is suspended"
description: "Run vakna resume <box>, then run your command again."
code: "suspended"
generated: scripts/generate.ts
verified:
  cli: "0.0.0-mock"
  date: "2026-10-20"
---

Run `vakna resume <box>`, then run your command again.

## Why can't I run a command in a suspended box?

A suspended box bills no compute, so Vakna never resumes one as a side effect of another command. Resume it on purpose and the command runs.

## What it looks like

```sh
$ vakna shell docs -- ls
```

```prints
vakna: box docs is suspended
hint: vakna resume docs  # suspended 2h 10m
```

Exit code 255.

## As JSON

With `--format json` the error is one JSON line. Branch on its `code`, not on the message or the exit code.

```prints
{"v":1,"event":"error","code":"suspended","message":"box docs is suspended","hint":"vakna resume docs  # suspended 2h 10m","docs":"https://vakna.com/docs/errors/suspended","mocked":true}
```

## Commands that print it

[`vakna shell`](https://vakna.com/docs/commands/shell), [`vakna fork`](https://vakna.com/docs/commands/fork).