Cronmaster: Modern UI for Cronjob Management with Live Logging

Introduction

Cronmaster is a powerful and intuitive web-based user interface for managing cron jobs. It simplifies the creation, scheduling, and monitoring of automated tasks on your system. With a modern, responsive design, Cronmaster provides features like live logging, historical log tracking, script management, and comprehensive system information display. Built with TypeScript, it offers robust authentication, a full REST API, and seamless Docker support, making it an essential tool for developers and system administrators.

Installation

The easiest and recommended way to get Cronmaster up and running is by using Docker. This method ensures quick deployment and consistent operation.

Create a docker-compose.yml file with the following minimal configuration:

# For all configuration options, refer to the official documentation
services:
  cronmaster:
    image: ghcr.io/fccview/cronmaster:latest
    container_name: cronmaster
    user: "root"
    ports:
      - "40123:3000"
    environment:
      - NODE_ENV=production
      - NEXT_PUBLIC_CLOCK_UPDATE_INTERVAL=30000
      - AUTH_PASSWORD=very_strong_password
      - HOST_CRONTAB_USER=root
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./scripts:/app/scripts
      - ./data:/app/data
      - ./snippets:/app/snippets
    pid: "host"
    privileged: true
    restart: always
    init: true

Note: Remember to replace very_strong_password with a secure password for AUTH_PASSWORD.

Build and run the container using Docker Compose:

docker compose up --build

Open your web browser and navigate to http://localhost:40123 to access Cronmaster.

For more detailed configuration options, including SSO and API setup, please refer to the official Cronmaster GitHub repository.

Examples

Cronmaster provides a user-friendly interface to manage your scheduled tasks effectively.

Managing Cron Jobs

You can easily view existing cron jobs, create new ones with quick presets, add comments for clarity, and delete or clone jobs. A standout feature is the optional execution logging, which captures stdout, stderr, exit codes, and timestamps, offering real-time updates for long-running tasks. This allows for precise monitoring and debugging of your automated processes.

Managing Scripts

Beyond cron jobs, Cronmaster also allows you to manage bash scripts directly within the UI. You can create, view, and delete scripts, utilizing quick snippets to streamline your workflow. These scripts can then be seamlessly integrated into your cron job commands, providing a centralized location for all your automation assets.

Why Use Cronmaster

Cronmaster stands out as a comprehensive solution for cron job management due to several compelling reasons. Its modern and responsive UI, complete with dark/light modes, offers a superior user experience compared to traditional command-line tools. The inclusion of live logging and historical logs provides invaluable insights into job execution, helping in debugging and monitoring. Features like script management, system information display, robust authentication (password and OIDC SSO), and a full REST API make it incredibly versatile for various environments. Furthermore, its Docker support ensures easy deployment and consistent operation across different systems, making it an ideal choice for developers and system administrators alike.

Cronmaster: Modern UI for Cronjob Management with Live Logging

Summary

Repository Info

Tags