Connect Your Server - Crontinel Agent

What is the Agent?

The Crontinel agent is a lightweight daemon that runs on your server, connects to app.crontinel.com, and listens for commands. When you schedule a trigger from the cloud, the agent checks it against your configured command allowlist, executes it if permitted, reports the result, and it appears in your dashboard.

By default the agent refuses to run any command. Configure an allowlist of permitted commands first. See the Command Allowlisting docs.

Laravel Agent

# 1. Install the package
composer require crontinel/laravel

# 2. Run the install command
php artisan crontinel:install

# 3. Add to .env
CRONTINEL_API_KEY=YOUR_API_KEY_HERE
CRONTINEL_API_URL=https://app.crontinel.com

# 4. Start the agent
php artisan crontinel:agent

Generate systemd or Supervisor config: php artisan crontinel:agent --systemd

Node.js Agent

# 1. Install
npm install @crontinel/node

# 2. Set env vars
export CRONTINEL_API_KEY=YOUR_API_KEY_HERE
export CRONTINEL_APP_ID=your-app-slug

# 3. Start the agent
npx crontinel agent

Python Agent

# Install from source (PyPI pending)
git clone https://github.com/crontinel/python.git
cd python
pip install -e .

# Set env vars
export CRONTINEL_API_KEY=YOUR_API_KEY_HERE
export CRONTINEL_APP_ID=your-app-slug

# Start the agent
crontinel agent

Test Your Agent

Add the command to your allowlist first, then schedule a trigger to verify the agent is connected:

curl -X POST https://app.crontinel.com/api/v1/triggers \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app_id": 1, "command": "echo hello", "schedule": "now"}'

Check the Trigger history section on your app page to see the result.