Repository files navigation

If you want to run the Trigger.dev platform yourself, instead of usingour cloud product, you can use this repository to get started.

It's highly recommended you read ourself-hosting guide, which contains more detailed instructions and will be more up-to-date.

If you want to self-host the Trigger.dev platform, when you're developing your web app locally you'll need to run the Trigger.dev platform locally as well.

1. Clone this repository and navigate to it:

git clone https://github.com/triggerdotdev/docker.gitcd docker

2. Run the start script and follow the prompts

./start.sh# hint: you can append -d to run in detached mode

3. Populate any missing .env file values. (See the .env.example file for more instructions)

4. The ports in thedocker-compose.yml file are set so they are less likely to clash with your local webapp – the platform runs on 3040 and the database is on 5433. If you need to change these ports, you'll need to update theLOGIN_ORIGIN,APP_ORIGIN andDATABASE_HOST environment variables.

1. Run the stop script

./stop.sh

You should now be able to access the Trigger.dev dashboard athttp://localhost:3040.

To create an account, login using "Magic Link" and the email with the sign-in link will be printing to the console output in the runningtriggerdotdev container.

Our main docs are atdocs.trigger.dev.

Note, you'll need to ensure that you configure the SDK to point at your self-hosted instance via theTRIGGER_API_URL environment variable. With the default settings and running everything locally you'd set it tohttp://localhost:3040.