- Install/Upgrade with Docker
Install/Upgrade with Docker
To get up and running quickly with Activepieces, we will use the Activepieces Docker image. Follow these steps:
You need to have Git and Docker installed on your machine in order to set up Activepieces via Docker Compose.
1. Clone Activepieces repository.
Use the command line to clone Activepieces repository:
git clone https://github.com/activepieces/activepieces.git
2. Go to the repository folder.
3.Generate Environment variable
Run the following command from the command prompt / terminal
If none of the above methods work, you can rename the .env.example file in the root directory to .env and fill in the necessary information within the file.
4. Run Activepieces.
docker compose -p activepieces up
4. Configure Webhook URL (Important for Triggers, Optional If you have public IP)
By default, activepieces will try to use your public IP. If you are self-hosting on a personal machine, you must configure the frontend URL so that the webhook is accessible from the internet.
The easiest way to expose your webhook URL on localhost is by using a service like ngrok. To set this up, follow these steps:
- Install ngrok
- Run the following command:
ngrok http 4200
AP_FRONTEND_URLenvironment variable in
.envwith the ngrok url.
When deploying for production, ensure that you update the database credentials and properly set the environment variables.
Review the configurations guide to make any necessary adjustments.
To upgrade to new versions, which are installed using docker compose, perform the following steps. First, open a terminal in the activepieces repository directory and run the following commands.
1. Run the update script
To upgrade to new versions manually, which are installed using docker compose, perform the following steps. First, open a terminal in the activepieces repository directory and run the following commands.
1. Pull the new docker compose file
2. Pull the new images
docker compose pull
- Review changelog for breaking changes
- Run the updated docker images
docker compose up -d --remove-orphans
Congratulations! You have now successfully updated the version.
The following command is capable of deleting all Docker containers and associated data, and therefore should be used with caution:
Executing this command will result in the removal of all Docker containers and the data stored within them. It is important to be aware of the potentially hazardous nature of this command before proceeding.