Job Template Catalog

Community-contributed job templates. Import directly into your OneOff instance with a single API call.

Contribute a Template

Share your useful job configurations with the community.

How to Submit a Template

  1. Fork the repository: github.com/meysam81/oneoff
  2. Create your template file: Add a JSON file to landing-page/src/content/catalog/
  3. Follow the schema:
    template-schema.json
    {
      "id": "unique-template-id",
      "name": "Human Readable Name",
      "description": "What this template does",
      "category": "backup|monitoring|cicd|database|api|devops|reporting|misc",
      "author": {
        "name": "Your Name",
        "github": "your-github-username"
      },
      "job": {
        "type": "http|shell|docker",
        "config": { ... }
      },
      "tags": ["tag1", "tag2"],
      "created_at": "2025-01-15"
    }
  4. Submit a Pull Request: Include a description of what your template does and any prerequisites.

Template Guidelines

  • Never include secrets, API keys, or credentials in templates
  • Clearly document any required environment variables
  • Verify your template works before submitting
  • Use lowercase kebab-case for IDs (e.g., backup-postgres-s3)
  • One job per template — don't combine unrelated tasks