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
| Field | Requirement |
|---|---|
| Schedule | Required; generated by the schedule builder; maximum 200 characters. |
| Command | Required 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-weekEach field accepts a wildcard, number, numeric range, wildcard step or comma-separated numeric list. Examples:
| Expression | Meaning |
|---|---|
0 2 * * * | Daily at 02:00 in the scheduler's timezone. |
*/15 * * * * | Every 15 minutes. |
0 9 * * 1-5 | At 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
- Choose the schedule in the builder.
- Enter the command and arguments.
- Select Create Cron Job.
- Review the schedule and command in the confirmation.
- Confirm and read the result.
- 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.