Skip to content

Cron Jobs

This module is mainly used to manage scheduled tasks, such as periodically running a shell script, periodic backups, periodic URL visits, etc. Manual execution is also supported.

Basic concepts:

  • Task Type: Supports Shell Script, App Backup, Website Backup, Database Backup, Directory/File Backup, Log Backup, URL Visit, Website Log Rotation, Cache Cleanup, System Snapshot, Server Time Sync.
  • Group: Classify tasks into different groups for quick filtering.
  • Schedule: Custom schedule uses the minute hour day month weekday format (e.g., 0 0 * * *). See https://crontab.guru/ for reference. You can preview the latest 5 execution times after setting.
  • Retention: Keep only the latest n successful backups/logs to avoid unlimited growth.
  • Backup Account: Target storage for backup files, managed in Panel Settings → Backup Accounts. Multiple accounts are supported.
  • Default Download Account: One designated backup account used for download and file‑size checks. The task fails if this account upload fails; failures of other accounts are ignored.
  • Compression Password: Encrypt tar backups using openssl (disabled by default).
  • Exclude Rules: Skip specific files/directories during backup.
  • Alert (✨ Pro Edition): Send notifications (SMS/email) if a task fails.
  • Ignore Errors: Continue backing up other items when one fails (e.g., backing up all databases).
  • Timeout: Maximum allowed execution time.
  • Retry: Number of retries after failure.

1 Task Types

1.1 Shell Script

Configuration

  • Run in Container: Select a container and user to run the script inside.
  • Interpreter: Predefined (bash, python, sh) or custom.
  • Script: Direct input, script library, or server script file.

img.png

1.2 App Backup | Website Backup | Database Backup

Configuration

These are similar: select the target to back up (supports “All”).

1.3 Directory Backup

Configuration

Back up files or directories. Supports multiple files or a single directory.

1.4 Log Backup

Backs up: - 1Panel system logs - Server SSH login logs - All website logs

1.5 URL Visit

URL: The address to visit periodically.

1.6 Website Log Rotation

Rotates logs for the specified website and archives old logs.

1.7 Cache Cleanup

Runs the Toolbox → Cache Cleanup task on schedule.

1.8 System Snapshot

Runs Panel Settings → Snapshots → Create Snapshot on schedule.

1.9 Server Time Sync

Syncs time from the NTP server configured in Toolbox → Quick Settings.

Execution Reports

Download & View

For backup tasks, you can view backup count and download files directly from the list.

Shows full report history with filtering by time and status.

Import & Export

Tasks can be imported/exported via JSON. - Tasks with broken associations are marked Pending Edit. - Duplicate task names are skipped during import.


Take 1Panel Further

Running 1Panel OSS? Pro Edition adds WAF protection, unlimited AI agents, multi-node management, and priority support — starting at $80/year.

Compare OSS vs Pro → Start 30-day free trial →