The ready command allows you to specify a command that will determine template sandbox readiness before a snapshot is created. It is executed in an infinite loop until it returns a successful exit code 0. This way you can control how long should we wait for the start command or any system state.

​
How to add ready command

When you are building a sandbox template you can specify the ready command by using the --ready-cmd option:
Bash
novita-sandbox-cli template build --ready-cmd "<your-ready-command>"

​
Sandbox template config

You can specify the ready command inside the novita.toml in the same directory where you run novita-sandbox-cli template build.
Toml
template_id = "0r0efkbfwzfp9p7qpc1c"
dockerfile = "novita.Dockerfile"
template_name = "my-agent-sandbox"
ready_cmd = "<your-ready-command>"

​
Default values

By default, the ready command is set to sleep 0, which means the sandbox template will be ready immediatelly. If the start command is defined, the default is set to sleep 20, which means that the template sandbox will wait for 20 seconds before taking the snapshot.

​
Examples

Here are some examples of the ready command you can use.

​
Wait for URL to return 200 status code

Bash
ready_cmd = 'curl -s -o /dev/null -w "%{http_code}" http://localhost:3000 | grep -q "200"'

​
Wait for a specific process to start

Bash
ready_cmd = 'pgrep my-process-name > /dev/null'

​
Wait for a file to exist

Bash
ready_cmd = '[ -f /tmp/ready.flag ]'