vastai execute

Execute a (constrained) remote command on a machine

Usage

vastai execute id COMMAND

Arguments

id · integer · required

id of instance to execute on

COMMAND · string · required

bash command surrounded by single quotes

Options

--schedule · string

try to schedule a command to run hourly, daily, or monthly. Valid values are HOURLY, DAILY, WEEKLY For ex. —schedule DAILY Choices: HOURLY, DAILY, WEEKLY

--start_date · string · default: "2026-02-24"

Start date/time in format ‘YYYY-MM-DD HH:MM:SS PM’ (UTC). Default is now. (optional)

--end_date · string · default: "2026-03-03"

End date/time in format ‘YYYY-MM-DD HH:MM:SS PM’ (UTC). Default is 7 days from now. (optional)

--day · parse_day_cron_style · default: "0"

Day of week you want scheduled job to run on (0-6, where 0=Sunday) or ”*”. Default will be 0. For ex. —day 0

--hour · parse_hour_cron_style · default: "0"

Hour of day you want scheduled job to run on (0-23) or ”*” (UTC). Default will be 0. For ex. —hour 16

Description

Examples: vastai execute 99999 ‘ls -l -o -r’ vastai execute 99999 ‘rm -r home/delete_this.txt’ vastai execute 99999 ‘du -d2 -h’

available commands: ls List directory contents rm Remote files or directories du Summarize device usage for a set of files

Return value: Returns the output of the command which was executed on the instance, if successful. May take a few seconds to retrieve the results.

Global Options

The following options are available for all commands:

Option	Description
--url URL	Server REST API URL
--retry N	Retry limit
--raw	Output machine-readable JSON
--explain	Verbose explanation of API calls
--api-key KEY	API key (defaults to ~/.config/vastai/vast_api_key)