---
title: How to run a Serverless Job
description: Learn how to run jobs in Scaleway Serverless platform efficiently.
tags: run execute start serverless job scaleway contextual-options parameters
dates:
  validation: 2025-06-09
  posted: 2023-11-14
---
import Requirements from '@macros/iam/requirements.mdx'


This page shows you how to manually run a Serverless Job from the Scaleway console. You can also run a Serverless Job with contextual options that only apply to one run.

<Requirements />

- A Scaleway account logged into the [console](https://console.scaleway.com)
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
- [Created a job](/serverless-jobs/how-to/create-job/)

## How to run a job

1. Click **Jobs** in the **Serverless** section of the side menu. The Serverless Jobs page displays.
2. Click the name of the job you want to run. The job **Overview** tab displays.
3. Click the **Actions** button, then click **Run job** in the drop-down menu. Your job starts, and a new entry appears in the **Job runs** section.

The **Job runs** section contains basic monitoring information for your jobs:
    - A status, that can be `running`, `succeeded`, `canceled`, or `failed`
    - A unique identifier
    - A start date and an end date
    - The duration of the job execution
<Message type="tip">
  - Use [Cockpit](/cockpit/quickstart/) for in-depth monitoring of the activity of your Serverless Jobs.
  - Refer to the [dedicated documentation](/serverless-jobs/how-to/manage-job-retries/) for more information on how to manage job retries in case of failed runs.
</Message>

## How to run a job with contextual options

1. Click **Jobs** in the **Serverless** section of the side menu. The Serverless Jobs page displays.
2. Click the name of the job you want to run. The job **Overview** tab displays.
3. Click the **Actions** button, then click **Run job with options** in the drop-down menu. The contextual options wizard displays.
4. Enter the following elements in the wizard:
    - **Number of jobs to run**: the number of simultaneous jobs to execute at the same time.
    - **Contextual environment variables**: the environment variables to use for this specific job run (in case of collision, overrides environment variables with the same key defined in the job definition).
     - **Contextual startup command and arguments**: the `startup_command` array and `args` array to use for this specific job run (override the startup command and arguments defined in the job definition).
5. Click **Run job**. Your job starts, and a new entry appears in the **Job runs** section.

The **Job runs** section contains basic monitoring information for your jobs:
    - A status, that can be `running`, `succeeded`, `canceled`, or `failed`
    - A unique identifier
    - A start date and an end date
    - The duration of the job execution

## Permissions and product dependencies

Depending on the settings used, Serverless Jobs can have dependencies on other products, such as:

- **Serverless Jobs**: base product permissions
- **Secret Manager**: to securely inject data into jobs
- **Container Registry**: to store images of jobs

Executing a Serverless Job can fail if some permissions are not defined properly in an [IAM policy](/iam/how-to/create-policy/), for example:

- `ServerlessJobsFullAccess` is required to start the Job.
- If the job definition uses an image from **Container Registry**, add the `ContainerRegistryReadOnly` permission.
- If the job definition consumes data from **Secret Manager**, add the `SecretManagerSecretAccess` permission.

Refer to the [dedicated documentation](/serverless-jobs/how-to/monitor-job/) for comprehensive information on how to monitor jobs using Scaleway Cockpit.