Skip to Content
Browse documentation

Add a Cron Job in UAPP

Configure a five-field cron schedule and single-line command, review the preview and create an account cron job in UAPP.

Open Cron Jobs → Add Cron Job.

Fields

FieldRequirement
ScheduleRequired; generated by the schedule builder; maximum 200 characters.
CommandRequired single line; maximum 500 characters; include needed executable/script paths and arguments.

The initial schedule is * * * * *, meaning every minute. Choose the intended timing before submitting.

Schedule syntax

The server requires exactly five whitespace-separated fields in this order:

minute hour day-of-month month day-of-week

Each field accepts a wildcard, number, numeric range, wildcard step or comma-separated numeric list. Examples:

ExpressionMeaning
0 2 * * *Daily at 02:00 in the scheduler's timezone.
*/15 * * * *Every 15 minutes.
0 9 * * 1-5At 09:00 Monday through Friday.

The form validator accepts these shapes; it does not fully check numeric bounds or every scheduler rule. Use valid minute/hour/day/month values. Named weekdays/months, @reboot, @daily, seconds fields and combined range-step expressions are not accepted by this validator.

There is no timezone selector. Verify the effective server timezone before relying on a specific wall-clock time.

Command

Use an absolute executable path and the intended script path where possible. Do not assume the scheduled command uses the same environment or runtime as a web request or interactive shell.

The command cannot contain newlines, carriage returns, nulls or other unsupported control characters. It is not a multiline script editor. Passing validation does not prove the executable exists, permissions allow it or the script is correct.

Review frequency and side effects

An every-minute job can overlap itself if it runs longer than a minute. Arrange application-level locking where needed and test the command appropriately before scheduling destructive or resource-intensive work. This panel does not supply an overlap-control field.

Create

  1. Choose the schedule in the builder.
  2. Enter the command and arguments.
  3. Select Create Cron Job.
  4. Review the schedule and command in the confirmation.
  5. Confirm and read the result.
  6. Open Cron Jobs and verify the new definition.

Creation saves a definition and requests a crontab rebuild; it does not execute the job immediately or verify its output. If saving reports a failure, refresh before trying again to avoid duplicates.

Use the notification-address control in the job list for cron mail. Keep secrets out of the command and confirmation.