Guartz — Simple scheduler API Server

Guartz it is an API REST for scheduling periodic tasks, it uses MySQL as Database, it’s developed in GO, it uses the GIN framework and GORM data mapper.

You can use it to schedule commands to be executed on a server periodically, for example if you need to execute scripts on a server, you can find the repo here.


You can install this server with this command:

go get

Browse to the guartz directory and install the dependencies:

godep restore

Build the binary:

go build

This will create a binary called guartz, create the a .env file on the root of the project with this content:


And set the enviroment variable:

export GUARTZ_MODE=dev

Now you can run the server:


This will run the server where you will be able to schedule the command’s execution in the operative system.


You can manage the tasks on the server by

Creating a task

You can create a task on the server with this rest call

POST http://localhost:3000/tasks
"id": "task-id",
"periodicity": "@every 1h",
"command": "docker run demoApp"

With this request I can create a task that will run a docker container every hour. You can use any cron unix valid format or use these shortcuts:

Entry                  | Description                                | Equivalent To
----- | ----------- | -------------
@yearly (or @annually) | Run once a year, midnight, Jan. 1st | 0 0 0 1 1 *
@monthly | Run once a month, midnight, first of month | 0 0 0 1 * *
@weekly | Run once a week, midnight on Sunday | 0 0 0 * * 0
@daily (or @midnight) | Run once a day, midnight | 0 0 0 * * *
@hourly | Run once an hour, beginning of hour | 0 0 * * * *

The server uses this library, there you can get more information.

Stopping a task

You can stop a task by deleting it or updating it:

DELETE http://localhost:3000/tasks/task-id
POST http://localhost:3000/tasks
"id": "task-id",
"periodicity": "stop",
"command": "docker run demoApp"

Listing tasks

You can list all system tasks:

GET http://localhost:3000/tasks

Get a task

You can show the info of a task using:

GET http://localhost:3000/tasks/task-id

Feel free to contribute and report bugs.

Show your support

Clapping shows how much you appreciated M’s story.