If you want to run the Tegon platform yourself, instead of using our cloud product, you can use this repository to get started.
It's highly recommended you read our self-hosting guide, which contains more detailed instructions and will be more up-to-date.
If you want to self-host the Tegon platform, when you're developing your web app locally you'll need to run the Tegon platform locally as well.
- Clone this repository and navigate to it:
git clone https://github.com/tegonhq/docker.git
cd docker
-
Populate any missing .env file values. (See the .env.example file for more instructions)
-
Run the start script and follow the prompts
docker compose up
- Run the stop script
docker compose down
To deploy and run tasks (powered by Trigger.dev), follow these steps:
- Create a Docker Hub account at hub.docker.com and login locally:
docker login
- Clone the main Tegon repository and set up environment variables:
git clone https://github.com/tegonhq/tegon.git
cd tegon
-
Configure your environment variables in
.env
. The following variables are essential for tasks:BASE_HOST
: Your instance URLDATABASE_URL
: Your database connection stringTRIGGER_API_KEY
: Your Trigger.dev API keyTRIGGER_API_URL
: Your Trigger.dev API URL
You can find the complete list of required variables in
trigger.config.ts
. -
After successful deployment, navigate to your Tegon instance's Settings -> Actions to install and configure the necessary actions for your workflows.