Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/docs/core/vortex/integrations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Vortex supports 500+ integrations via the ActivePieces connector ecosystem, plus
| **HubSpot** | CRM | Contact management, marketing automation |
| **Stripe** | Payments | Payment processing, subscription management |
| **SendGrid** | Email | Transactional and marketing email delivery |
| **Resend** | Email | Transactional email delivery |
| **Herald** | Email | Transactional email delivery |
| **Twilio** | SMS | Send and receive SMS messages |
| **Anthropic** | AI | Claude models for text generation and analysis |
| **OpenAI** | AI | GPT models, DALL-E, embeddings |
Expand Down
2 changes: 1 addition & 1 deletion content/docs/grid/vortex/configuration.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -163,7 +163,7 @@ The worker executes workflow DSL definitions, manages trigger adapters, and runs
| `CHRONICLE_API_URL` | Chronicle audit logging URL |
| `MANTLE_API_URL` | Mantle notification service URL |
| `MANTLE_SERVICE_KEY` | Mantle service key |
| `RESEND_API_KEY` | Resend API key (for email trigger adapter) |
| `HERALD_API_KEY` | Herald API key (for email trigger adapter) |
| `AUTH_API_URL` | Auth API URL (for email rendering) |
| `EMAIL_RENDER_SECRET` | Email rendering secret |
| `MEILISEARCH_URL` | Meilisearch URL |
Expand Down
2 changes: 1 addition & 1 deletion content/docs/grid/vortex/execution.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -112,7 +112,7 @@ Plugins provide infrastructure capabilities that don't require external connecto
| **Rate Limit** | Token bucket, sliding window, fixed window algorithms |
| **Queue** | Push/pull with memory, Valkey, SQS, or RabbitMQ backends |
| **Database** | Query, insert, update, delete with parameterized SQL |
| **Email** | Send emails via Resend |
| **Email** | Send emails via Herald |
| **File** | Read, write, list, delete files |
| **HTTP** | Make HTTP requests with auth and retry |
| **Hash** | MD5, SHA-256, bcrypt, HMAC |
Expand Down
2 changes: 1 addition & 1 deletion content/docs/grid/vortex/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -209,7 +209,7 @@ Vortex ships with 600+ built-in integrations (Slack, GitHub, Stripe, Google Shee
| **Rate Limit** | Token bucket, sliding window, fixed window algorithms |
| **Queue** | Push/pull with memory, Valkey, SQS, or RabbitMQ backends |
| **Database** | Query, insert, update, delete with parameterized SQL |
| **Email** | Send emails via Resend |
| **Email** | Send emails via Herald |
| **File** | Read, write, list, delete files |
| **HTTP** | Make HTTP requests with auth and retry |
| **Hash** | MD5, SHA-256, bcrypt, HMAC |
Expand Down
2 changes: 1 addition & 1 deletion content/docs/grid/vortex/integrations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Vortex ships with 600+ built-in integrations powered by the [ActivePieces](https
| **Communication** | Slack, Discord, Microsoft Teams, Twilio |
| **CRM** | HubSpot, Salesforce, Pipedrive |
| **Developer** | GitHub, GitLab, Linear, Jira |
| **Email** | Gmail, Resend, SendGrid, Mailchimp |
| **Email** | Gmail, Herald, SendGrid, Mailchimp |
| **Productivity** | Notion, Airtable, Google Sheets, Asana |
| **Cloud** | AWS S3, Azure Blob Storage, Google Cloud Storage |
| **eCommerce** | Shopify, Stripe, WooCommerce |
Expand Down
63 changes: 3 additions & 60 deletions content/docs/grid/vortex/self-hosting.mdx
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
title: Self-Hosting
description: Deploy Vortex on your own infrastructure with Docker Compose or Kubernetes
description: Deploy Vortex on your own infrastructure with Docker Compose
---

Vortex is fully open source (Apache 2.0) and designed to run on your own infrastructure. Two deployment options are supported: Docker Compose for simpler setups and Kubernetes (via Helm) for production-grade orchestration.
Vortex is fully open source (Apache 2.0) and designed to run on your own infrastructure. Docker Compose is the supported path for self-hosting. A Helm chart is not currently published; Kubernetes operators who want to wire their own manifests can use the compose file as the source of truth for service topology, env vars, and health checks.

## Docker Compose

Expand Down Expand Up @@ -81,7 +81,7 @@ Omni platform integrations (optional, omit to run Vortex standalone):
|----------|-------------|
| `MANTLE_API_URL`, `MANTLE_SERVICE_KEY` | Mantle notification service |
| `AUTH_API_URL` | HIDRA identity provider |
| `RESEND_API_KEY`, `EMAIL_RENDER_SECRET` | Email trigger adapter |
| `HERALD_API_KEY`, `EMAIL_RENDER_SECRET` | Email trigger adapter |

### Architecture

Expand All @@ -100,63 +100,6 @@ All services include health checks and proper dependency ordering. The worker de

When billing is not configured, the pricing page shows "All Features" mode, and all entitlements are unlocked. Self-hosted deployments get the full feature set with no artificial limits: unlimited workflows, unlimited executions, all integrations, custom plugins, and SSO.

## Kubernetes (Helm)

For production deployments, Vortex ships a Helm chart with configurable replicas, resource limits, ingress, TLS, and Pod Disruption Budgets.

### Prerequisites

The Helm chart deploys the three Vortex services (API, app, worker) and optionally a PostgreSQL subchart. The following external dependencies must be provisioned separately:

- **Valkey / Redis** for caching and distributed locks. Configure via `externalCache` values, or deploy your own Valkey instance alongside the chart.
- **[Apache Iggy](https://iggy.rs)** for event streaming. The worker and API both require a reachable Iggy server.
- **[Hatchet](https://docs.hatchet.run/self-hosting)** for workflow execution. See the Hatchet self-hosting docs for setup instructions.

### Install

```sh
helm install vortex ./charts/vortex \
--namespace vortex --create-namespace \
-f charts/vortex/values.yaml \
--set secrets.dbPassword=<password> \
--set secrets.authSecret=<secret> \
--set secrets.encryptionKey=<key> \
--set secrets.internalApiSecret=<secret> \
--set secrets.hatchetClientToken=<token> \
--set secrets.iggyUsername=<username> \
--set secrets.iggyPassword=<password> \
--set secrets.cachePassword=<password>
```

| Secret | Description | Generate with |
|--------|-------------|---------------|
| `secrets.dbPassword` | PostgreSQL password | `openssl rand -hex 16` |
| `secrets.authSecret` | Session signing secret | `openssl rand -hex 16` |
| `secrets.encryptionKey` | Data encryption key | `openssl rand -base64 32` |
| `secrets.internalApiSecret` | Service-to-service auth | `openssl rand -hex 16` |
| `secrets.hatchetClientToken` | Hatchet API token | From Hatchet dashboard |
| `secrets.iggyUsername` | Iggy streaming username | Any value |
| `secrets.iggyPassword` | Iggy streaming password | Any value |
| `secrets.cachePassword` | Valkey/Redis password | `openssl rand -hex 16` |

See `charts/vortex/values.yaml` for the full list of configurable values, and `charts/vortex/values.prod.yaml` for a production reference.

### External database

To use an external PostgreSQL instance instead of the bundled subchart:

```yaml
postgresql:
enabled: false

externalDatabase:
host: your-db-host
port: 5432
database: vortex
username: postgres
password: <password>
```

## Upgrading

Pull the latest changes and rebuild:
Expand Down
Loading
Loading