The background jobs framework for Next.js

Discord | Website | Issues | Docs

About Trigger.dev

Create long-running jobs directly in your codebase with features like API integrations, webhooks, scheduling and delays.

Long running Jobs on serverless

Reliably run jobs and don’t worry about function timeouts, we handle those for you.

• Auto-resume after a function timeout
• Auto-resume after a server outage
• Add delays of up to a year

In your codebase

Create Jobs where they belong: in your codebase. Version control, localhost, test, review, and deploy like you're already used to.

Secure by design

We only receive Triggers and the data you choose to send to us. You can even completely self-host the entire platform.

Don't worry about deployment

Just use our SDK to write Jobs in your Next.js codebase. There's nothing extra to deploy and no CI to configure, your Jobs just connect to our cloud. Or you can always self-host.

Full visibility of every job run

View every Task in every Run so you can tell exactly what happened.

Built-in integrations

Easily integrate with hundreds of third-party APIs – including your own. Use API keys (which never leave your server) or let us handle OAuth for you. Install our integration packages and easily subscribe to webhooks and perform common tasks, or you can easily use your existing favorite Node.JS SDKs and get resumability and idempotency through our runTask function.

Trigger.dev Connect (coming soon)

Easily add integrations for your users.

Getting started

Visit our docs here.

Self-host

We provide an official trigger.dev docker image you can use to easily self-host the platform. We're working on more extensive guides but we currently provide a Fly.io example repository with instructions in the README for deploying and using a self-hosted instance of Trigger.dev on Fly.io.

Development

Prerequisites

• Node.js version >=18.x
• pnpm package manager version 7
• Docker

Setup

1. Clone the repo into a public GitHub repository or fork the repo. If you plan to distribute the code, keep the source code public to comply with the Apache Licence 2.0.

   git clone https://github.com/triggerdotdev/trigger.dev.git
   

   If you are on windows, run the following command on gitbash with admin privileges: git clone -c core.symlinks=true https://triggerdotdev/trigger.dev.git

2. Navigate to the project folder

   cd trigger.dev
   

3. Install the required packages using pnpm.

   pnpm i
   

4. Create your .env files

   cp .env.example .env && cp packages/database/.env.example packages/database/.env
   

   Open the root .env file and fill in the required values.

5. Start Docker. This starts the required services like Postgres.

   pnpm run docker
   

6. Migrate the database

   pnpm run db:migrate
   

7. Run the seed script

   pnpm run db:seed
   

8. Run the project. It should run on port:3030

   pnpm run dev --filter webapp