---
id: applet-test-run-index
title: run
sidebar_position: 1156
---
# run

Run applet tests on signageOS devices


## Description

Executes previously uploaded applet tests on remote signageOS devices. This command
triggers test execution and provides real-time feedback on test progress and results.
Tests can be run on specific devices or across multiple devices for comprehensive testing.

## Usage

```bash
sos applet test run [options]
```

## Options

| Option                      | Description                                                                               |
| --------------------------- | ----------------------------------------------------------------------------------------- |
| `--no-default-organization` | Prevent using the defaultOrganizationUid from ~/.sosrc (boolean)                          |
| `--device-uid`              | Device UID (string)                                                                       |
| `--organization-uid`        | Organization UID (string)                                                                 |
| `--applet-uid`              | Applet UID (string)                                                                       |
| `--test`                    | Specify the test identifiers/files to be run. If not specified, all will be run. (string) |
| `--yes`                     | Allow to run applet test without confirmation step (boolean)                              |

## Examples

```bash
# Run all applet tests
sos applet test run --applet-uid my-applet --device-uid device123

# Run specific tests
sos applet test run --applet-uid my-applet --device-uid device123 --test "test1,test2"

# Run without confirmation
sos applet test run --applet-uid my-applet --device-uid device123 --yes
```

## Since

0.10.0

## Global Options

All commands support the following global options:

| Option | Alias | Description |
|--------|-------|-------------|
| `--help` | `-h` | Display help information for any command |
| `--version` | `-v` | Display the installed version of the CLI |
| `--api-url` | `-u` | Override the API URL for REST requests |
| `--profile` | | Use a specific profile from ~/.sosrc config |

### Examples

```bash
# Show version
sos --version

# Get help for any command
sos applet --help
sos applet upload --help

# Use custom API endpoint
sos --api-url https://api.example.com applet upload

# Use specific profile
sos --profile production organization list
```


## See Also

- [Upload test configuration command](../upload/)