---
title: "Managing Jobs Through a Command Line Interface"
canonical: "https://documentation.chaos.com/space/VCLOUD/126076078/Managing%20Jobs%20Through%20a%20Command%20Line%20Interface"
format: markdown
---
[Managing Jobs Rendered in Chaos Cloud](https://docs-chaos.atlassian.net/wiki/spaces/VCLOUD/pages/126075967)This page provides information on managing render jobs through a command line interface in Chaos Cloud Rendering.
## **Overview **
---
With Chaos Cloud Rendering you are able to submit, queue, monitor, and organize your render jobs across projects. To manage render jobs in Chaos Cloud you can use its web-based interface or a command line interface. This page explains how to manage render jobs via а command line interface. All of the functions can be carried out manually with any command line tool, without opening a browser. To do so, you first have to navigate to the location of **chaoscloud** or **chaoscloud.exe** on your machine.
For some more examples on how to use the command-line interface of Chaos Cloud Rendering, see the [Common Use Cases](https://docs-chaos.atlassian.net/wiki/spaces/VCLOUD/pages/126050235) page.
Default locations:
- **Windows** – %APPDATA%\Chaos\Cloud\client\ccloud.exe
- **macOS **– $HOME/.Chaos/Cloud/client/ccloud
- **Linux** –** **$HOME/.Chaos/Cloud/client/ccloud.bin
** **
## **Managing Jobs Through a Command Line Interface**
---
The table below lists all available flags and commands. All commands can be run with multiple tags.
| **Command** | **Flag(s)** | **Flag meaning** | **Function** | **Examples** |
| --- | --- | --- | --- | --- |
| **auth login** | – | – | Logs in to Chaos Cloud. | **ccloud auth login** |
| **auth logout** | – | – | Logs out of Chaos Cloud. | **ccloud auth logout** |
| **pack** | **-h, --help, ** | Help for pack | Pack a V-Ray scene and all of its assets into a single directory. | **ccloud pack --sceneFile /drive/me/scenes/alfa-red-scene/alfa-red.vrscene --output /drive/me/store/** |
| **--output (string)** | Output directory | The result from this operation is a directory, called 'package' which contains everything this scene needs to be rendered with V-Ray Standalone. The name of the package directory is the same as the name of the scene file. |
| **--sceneFile (string)** | Path to a .vrscene file | All the resources referenced in the .*vrscene* file are set together into a 'resources' sub directory in the package. The .*vrscene* file itself is copied as well but transformed so that relative paths to these resources are used instead of the original paths, which may be absolute. This ensures the scene can then be rendered on other computers. |
| **eula** | – | – | Prints out the EULA. | **ccloud eula** |
| **job cancel** | **--id (required)** | Render Job ID | Cancels a Chaos Cloud job. | **ccloud job cancel --id=X8hC6Xg2cb8JeL5** |
| **job delete** | **--id (required)** | Render Job ID | Deletes a Chaos Cloud job. | **ccloud job delete --id=X8hC6Xg2cb8JeL5** |
| **job download** | **--id (required)** | Render Job ID | Downloads outputs of a Chaos Cloud job. Multiple jobs can be requested with multiple instances of the --id flag or by separating them with commas, e.g.: '*job1,job2,job3*'. | **ccloud job download --id=X8hC6Xg2cb8JeL5 --output="C:\Users\Me\Desktop"**
**ccloud job download --id JobID1,JobID2,JobID3 --output "C:\Users\Me\Desktop"** |
| **--no-progress** | Do not display progress when downloading |
| **--output (required)** | Path to output folder |
| **job list** | **--format (string)** | – | Sets the format of each job line. Formatting is done via 'verbs', each of which corresponds to a particular property of the job. Verbs are added in double curly braces, following a dot, e.g. *'.Verb'*. The supported verbs for a job are: **Name**, **ID**, **Status**, **Project**, **CreatedAt**. Special formats such as '*full*' are recognized. They define a particular format string.
If the **--json **global flag is used, then **--format** is ignored and JSON is always emitted for every job. (default ".ID\ {{.Name}}") | **ccloud job list --project PROJ1 --project PROJ2** |
| **--name (string)** | - | Filters only jobs which have one of the names. |
| **--project (string)** | - | Filters only jobs which belong to this project. |
| **--status (string)** | - | Filters jobs with this status. Possible statuses: **uploading**, **upload-failed**, **upload-cancelled**, **uploaded**, **active**, **completed**, **failed**, **cancelled**, **paused.** |
| **job pause** | **--id (required)** | Render Job ID | Pauses a Chaos Cloud job. | **ccloud job pause --id=X8hC6Xg2cb8JeL5** |
| **job rename** | **--id (required)** | Render Job ID | Renames a Chaos Cloud job. | **ccloud job rename --id=X8hC6Xg2cb8JeL5 --title="Marbles" ** |
| **--title (required)** | The new title of the V-Ray Cloud job |
| **job submit** | **--sceneFile (required)** | Path to .vrscene file | Submits a V-Ray scene to Chaos Cloud. | ccloud** job submit --sceneFile="C:\Users\Me\Desktop\soccer.vrscene--project="Project Cloud" --width=1280 --height=720 --creditLimit 0.01**
** **
ccloud **job submit --batchFile**
{
"project": "Project Name",
"scenes": [
{
"path": "path/to/file.vrscene",
"name": "Example Job Name",
"creditLimit": 2
},
{
"path": "path/to/second/scene.vrscene",
"name": "Second Job",
"colorCorrections": "path/to/corrections/file",
"frameRange": "59-300",
"frameStep": 2,
"width": 640,
"height": 480,
"onlyCPU": true,
"onlyUpload": true
},
{
"path": "path/to/third/simple.vrscene"
}
],
"layers": true
} |
| **--animation** | Renders animation instead of a single shot |
| **--colorCorrectionsFile** | Path to color corrections file |
| **--creditLimit** | Sets credit limit per job (still images only) |
| **--frameRange** | Frame range of the animation |
| **--frameStep** | Frame step of the animation |
| **--height** | Height of the rendered image |
| **--width** | Width of the rendered image |
| **--ignoreWarnings** | Ignore warnings in scene file processing |
| **--name** | Name of the rendering job |
| **--no-progress** | Do not display progress while submitting |
| **--preserveAlpha** | Preserve alpha channel of PNG output |
| **--project** | Name of the rendering project |
| **--allCameras** | Render all cameras in the scene. Applicable for multi-camera scenes |
| **--batchFile****[*](https://docs-chaos.atlassian.net/wiki/spaces/VCLOUD4EDIT/pages/112558500)** | String Path to a JSON file which describes a batch submit |
| **--onlyUpload** | Uploads the scene without rendering |
| **--downloadOutput** | Uploads a set of scenes, waits them to complete rendering and download the outputs |
| **--camera (stringArray) ** | Render specific cameras. The names given need to match those of the cameras in your scene, which you want to render. |
| **job resubmit** | **--id** **(required)** | Render Job ID | Resubmits a V-Ray scene to Chaos Cloud. | **ccloud job resubmit --sceneFile="C:\Users\Me\Desktop\soccer.vrscene --project="Chaosology" --animation --frameRange=30 --ignoreWarnings** |
| **--animation** | Renders animation instead of a single shot |
| **--colorCorrectionsFile** | Path to color corrections file |
| **--frameRange** | Frame range of the animation |
| **--frameStep** | Frame step of the animation |
| **--height** | Height of the rendered image |
| **--width** | Width of the rendered image |
| **--ignoreWarnings** | Ignore warnings in scene file processing |
| **--name** | Name of the rendering job |
| **--no-progress** | Do not display progress while submitting |
| **--preserveAlpha** | Preserve alpha channel of PNG output |
| **--project** | Name of the rendering project |
| **--onlyUncompleted** | Clones a job only with the frames that are not in a completed state (failed, canceled, paused) |
| **job start** | **--id (required)** | Render Job ID | Starts a V-Ray Cloud job. | **ccloud job start --id=X40YITIaqtb_94E** |
| **job status** | **--id (required)** | Render Job ID | Prints status info for a Chaos Cloud job. If an animation has uncompleted frames, it prints information about them, too. | |
| **job report** | **--json (required)** | Formats the data into a .json message | Fetches report information on specified jobs and formats it into a .json file. | --json job report --id X8hC6Xg2cb8JeL5 --id X40YITIaqtb_94E |
| **--id (required)** | The ID of the job, for which the report is generated. There can be multiple ID flags, depending on how many jobs need to be included in the report. |
| **project create** | **--name (required)** | Name of the project | Creates a new project. | **ccloud project create --name="Cloudy" --default** |
| **--default** | Marks the project as default |
| **project delete** | **--name (required)** | Name of the project | Deletes a project. | **ccloud project delete --name="Drains"** |
| **project list** | – | – | Lists available projects. | **ccloud project list** |
| **project rename** | **--name (required)** | Name of the project | Renames a Chaos Cloud project. | **ccloud project rename --name="Marbles" --to="Drains"** |
| **--to (required)** | The new name of the project |
| **update** | – | – | Updates the Chaos Cloud Client. | **ccloud update** |
| **version** | – | – | Prints Chaos Cloud Client version info. | **ccloud version** |
| **version check** | – | – | Prints out if there is a newer version than the installed and/or if the current version is deprecated. | **ccloud version check** |
| **help** | – | – | Prints command information. | **ccloud help; ccloud job help; ccloud job submit help** |
> Macro (anchor)
*** **A 'batch' is a set of *.vrscene* files which are submitted at once. Individual settings for each file must be placed in the batch file itself. When used, the following flags are ignored:
--height
--width
--creditLimit
--colorCorrectionsFile
--name
--project
--frameStep
--frameRange
--onlyUpload
## **How to Get a Job ID**
---
The ID of a render job can be obtained in two ways:
- from the Chaos Cloud's URL of the web interface when the Job Details page is open
- upon submission, through а command line interface, as shown in the image below
For more information, see [Submitting Render Jobs Through the Chaos Cloud application (command line)](https://docs-chaos.atlassian.net/wiki/spaces/VCLOUD/pages/125655710/Submitting+Jobs+to+Render+in+Chaos+Cloud#vcloud_cli).
> ℹ️ 