To configure activepieces, you will need to set some environment variables, There is file called .env at the root directory for our main repo.

When you execute the deploy.sh script in the Docker installation tutorial, it will produce these values.

Environment Variables

VariableDescriptionDefault ValueExample
AP_CONFIG_PATHOptional parameter for specifying the path to store SQLite3 and local settings.~/.activepieces
AP_CLOUD_AUTH_ENABLEDTurn off the utilization of Activepieces oauth2 applicationsfalse
AP_DB_TYPEThe type of database to use. (POSTGRES / SQLITE3)SQLITE3
AP_EXECUTION_MODEYou can choose between ‘SANDBOXED’ or ‘UNSANDBOXED’ as possible values. If you decide to change this, make sure to carefully read the next below.UNSANDBOXED
AP_FLOW_WORKER_CONCURRENCYThe number of different flows can be processed in same time10
AP_ENCRYPTION_KEY❗️ Encryption key used for connectionsNone
AP_FRONTEND_URL❗️ Url that will be used to specify redirect url and webhook url.Nonehttps://demo.activepieces.com/api
AP_JWT_SECRET❗️ Encryption key used for generating JWT tokensNonehttps://demo.activepieces.com
AP_QUEUE_MODEThe queue mode to use. (MEMORY / REDIS)MEMORY
AP_QUEUE_UI_ENABLEDEnable the queue UI (only works with redis)true
AP_QUEUE_UI_USERNAMEThe username for the queue UINone
AP_QUEUE_UI_PASSWORDThe password for the queue UINone
AP_TRIGGER_DEFAULT_POLL_INTERVALThe default polling internal for app triggers in minutes5
AP_PIECES_SOURCEAP_PIECES_SOURCE: FILE for local development, DB for database, CLOUD_AND_DB for both.CLOUD_AND_DB
AP_POSTGRES_DATABASE❗️ The name of the PostgreSQL databaseNone
AP_POSTGRES_HOST❗️ The hostname or IP address of the PostgreSQL serverNone
AP_POSTGRES_PASSWORD❗️ The password for the PostgreSQL userNone
AP_POSTGRES_PORT❗️ The port number for the PostgreSQL serverNone
AP_POSTGRES_USERNAME❗️ The username for the PostgreSQL userNone
AP_POSTGRES_USE_SSLUse SSL to connect the postgres databasefalse
AP_POSTGRES_SSL_CAUse SSL Certificate to connect to the postgres databaseNone
AP_REDIS_URLIf a Redis connection URL is specified, all other Redis properties will be ignored.None
AP_REDIS_USER❗️ Username to use when connect to redisNone
AP_REDIS_PASSWORD❗️ Password to use when connect to redisNone
AP_REDIS_HOST❗️ The hostname or IP address of the Redis serverNone
AP_REDIS_PORT❗️ The port number for the Redis serverNone
AP_RESIS_DBThe Redis database index to use0
AP_REDIS_USE_SSLConnect to Redis with SSLfalse
AP_NOTIFICATION_URLThe notification URL is triggered whenever a run fails.falsehttps://cloud.activepieces.com/flows/WEBHOOK_TRIGGER_FLOW_ID
AP_OPENAI_API_KEYThis is required only if you want to enable code copilotNone
AP_SANDBOX_RUN_TIME_SECONDSMaximium allowed runtime for the flow in seconds60020
AP_SIGN_UP_ENABLEDEnable the Sign up, It requires sandboxing to be onfalse
AP_TELEMETRY_ENABLEDCollect telemetry informationtrue
AP_TEMPLATES_SOURCE_URLThis is the endpoint we query for templates, remove it and templates will be removed from UIhttps://cloud.activepieces.com/api/v1/flow-templates
AP_WEBHOOK_TIMEOUT_SECONDSThe default timeout for webhooks. This option is not available on cloud because of cloudflare30

The frontend URL is essential for webhooks and app triggers to work. It must be accessible to third parties to send data.

Seperate Workers from api

To separate workers from API servers, you can achieve this by setting AP_FLOW_WORKER_CONCURRENCY to zero on API servers, while keeping it on worker servers.

Enabling Sign-Up:

To enable the sign-up feature, you need to ensure the code runs safely on the machine, especially if you don’t trust the users. Follow these two steps:

  1. Make the Docker container privileged: Edit the docker-compose.yml file and add privileged: true. This allows the container to have additional permissions to sandbox.
  2. Change the execution mode to sandboxing: Modify the AP_EXECUTION_MODE setting to SANDBOXED. This ensures the code runs within a secure environment, isolated from the rest of the system.
  3. Modify the AP_SIGN_UP_ENABLED to true , the environment variable.

Enable Code Generator

To enable the code generator button, please provide a value for the AP_OPENAI_API_KEY environment variable.

Setting Webhook (Frontend URL):

The default URL is set to the machine’s IP address. To ensure proper operation, ensure that this address is accessible or specify an AP_FRONTEND_URL environment variable.

One possible solution for this is using a service like ngrok (https://ngrok.com/), which can be used to expose the frontend port (4200) to the internet.