---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "dokploy_schedule Resource - dokploy"
subcategory: ""
description: |-
  A cron job Dokploy runs on a schedule.
  schedule_type selects where the command runs:
  application — inside a running application container; set application_id.compose — inside one service of a Compose stack; set compose_id and service_name.server — on a remote server; set server_id.dokploy-server — on the Dokploy host itself.
  ~> A schedule targeting an application runs inside its container, so the container has to be running when the cron fires.
---

# dokploy_schedule (Resource)

A cron job Dokploy runs on a schedule.

`schedule_type` selects where the command runs:

* `application` — inside a running application container; set `application_id`.
* `compose` — inside one service of a Compose stack; set `compose_id` and `service_name`.
* `server` — on a remote server; set `server_id`.
* `dokploy-server` — on the Dokploy host itself.

~> A schedule targeting an application runs inside its container, so the container has to be running when the cron fires.



<!-- schema generated by tfplugindocs -->
## Schema

### Required

- `command` (String) Command to run.
- `cron_expression` (String) Standard five-field cron expression, for example `0 3 * * *`.
- `name` (String) Display name of the schedule.

### Optional

- `app_name` (String) Docker service name the schedule targets. Derived by Dokploy when omitted.
- `application_id` (String) Application this schedule belongs to.
- `compose_id` (String) Compose stack this schedule belongs to.
- `description` (String) Free-form description.
- `enabled` (Boolean) Whether the schedule is active.
- `schedule_type` (String) Where the command runs. Valid values: `application`, `compose`, `server`, `dokploy-server`. Defaults to `application`.
- `script` (String) Multi-line script to run instead of a single command.
- `server_id` (String) Server this schedule runs on.
- `service_name` (String) Service inside a Compose stack to run the command in.
- `shell_type` (String) Shell used to interpret the command. Valid values: `bash`, `sh`. Defaults to `bash`.
- `timezone` (String) IANA timezone the cron expression is evaluated in, for example `Europe/Berlin`.

### Read-Only

- `created_at` (String) RFC 3339 timestamp of when the schedule was created.
- `id` (String) Unique schedule identifier.