Add Activepieces integration for workflow automation
- Add Activepieces fork with SmoothSchedule custom piece - Create integrations app with Activepieces service layer - Add embed token endpoint for iframe integration - Create Automations page with embedded workflow builder - Add sidebar visibility fix for embed mode - Add list inactive customers endpoint to Public API - Include SmoothSchedule triggers: event created/updated/cancelled - Include SmoothSchedule actions: create/update/cancel events, list resources/services/customers 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
108
activepieces-fork/docs/install/options/railway.mdx
Normal file
108
activepieces-fork/docs/install/options/railway.mdx
Normal file
@@ -0,0 +1,108 @@
|
||||
---
|
||||
title: "Railway"
|
||||
description: "Deploy Activepieces to the cloud in minutes using Railway's one-click template"
|
||||
---
|
||||
|
||||
Railway simplifies your infrastructure stack from servers to observability with a single, scalable, easy-to-use platform. With Railway's one-click deployment, you can get Activepieces up and running in minutes without managing servers, databases, or infrastructure.
|
||||
|
||||
<a href="https://railway.com/deploy/kGEO1J" target="_blank">
|
||||
<img alt="Deploy on Railway" src="https://railway.app/button.svg" />
|
||||
</a>
|
||||
|
||||
## What Gets Deployed
|
||||
|
||||
The Railway template deploys Activepieces with the following components:
|
||||
|
||||
- **Activepieces Application**: The main Activepieces container running the latest version from [Docker Hub](https://hub.docker.com/r/activepieces/activepieces)
|
||||
- **PostgreSQL Database**: Managed PostgreSQL database for storing flows, executions, and application data
|
||||
- **Redis Cache**: Redis instance for job queuing and caching (optional, can use in-memory cache)
|
||||
- **Automatic SSL**: Railway provides automatic HTTPS with SSL certificates
|
||||
- **Custom Domain Support**: Configure your own domain through Railway's dashboard
|
||||
|
||||
## Prerequisites
|
||||
|
||||
Before deploying, ensure you have:
|
||||
|
||||
- A [Railway account](https://railway.app/) (free tier available)
|
||||
- Basic understanding of environment variables (optional, for advanced configuration)
|
||||
|
||||
## Quick Start
|
||||
|
||||
1. **Click the deploy button** above to open Railway's deployment interface
|
||||
2. **Configure environment variables for advanced usage** (see [Configuration](#configuration) below)
|
||||
3. **Deploy** - Railway will automatically provision resources and start your instance
|
||||
|
||||
Once deployed, Railway will provide you with a public URL where your Activepieces instance is accessible.
|
||||
|
||||
## Configuration
|
||||
|
||||
### Environment Variables
|
||||
|
||||
Railway allows you to configure Activepieces through environment variables. You can set these in the Railway dashboard under your project's **Variables** tab.
|
||||
|
||||
#### Execution Mode
|
||||
|
||||
Configure the execution mode for security and performance:
|
||||
See the [Workers & Sandboxing](/install/architecture/workers) documentation for details on each mode.
|
||||
|
||||
#### Other Important Variables
|
||||
|
||||
- `AP_TELEMETRY_ENABLED`: Enable/disable telemetry (default: `false`)
|
||||
|
||||
For a complete list of all available environment variables, see the [Environment Variables](/install/configuration/environment-variables) documentation.
|
||||
|
||||
## Custom Domain Setup
|
||||
|
||||
Railway supports custom domains with automatic SSL:
|
||||
|
||||
1. Go to your Railway project dashboard
|
||||
2. Navigate to **Settings** → **Networking**
|
||||
3. Add your custom domain
|
||||
4. Update `AP_FRONTEND_URL` environment variable to match your custom domain
|
||||
5. Railway will automatically provision SSL certificates
|
||||
|
||||
For more details on SSL configuration, see the [Setup SSL](/install/guides/setup-ssl) guide.
|
||||
|
||||
## Production Considerations
|
||||
|
||||
Before deploying to production, review these important points:
|
||||
|
||||
- [ ] Review [Security Practices](/admin-guide/security/practices) documentation
|
||||
- [ ] Configure `AP_WORKER_CONCURRENCY` based on your workload and hardware resources
|
||||
- [ ] Ensure PostgreSQL backups are configured in Railway
|
||||
- [ ] Consider database scaling options in Railway
|
||||
|
||||
## Observability
|
||||
|
||||
Railway provides built-in observability features for Activepieces. You can view logs and metrics in the Railway dashboard.
|
||||
|
||||
## Upgrading
|
||||
|
||||
To upgrade to a new version of Activepieces on Railway:
|
||||
|
||||
1. Go to your Railway project dashboard
|
||||
2. Navigate to **Deployments**
|
||||
3. Click **Redeploy** on the latest deployment
|
||||
4. Railway will pull the latest Activepieces image and redeploy
|
||||
|
||||
<Warning>
|
||||
Before upgrading, review the [Breaking Changes](/install/configuration/breaking-changes) documentation to ensure compatibility with your flows and configuration.
|
||||
</Warning>
|
||||
|
||||
## Next Steps
|
||||
|
||||
After deploying Activepieces on Railway:
|
||||
|
||||
1. **Access your instance** using the Railway-provided URL
|
||||
2. **Create your first flow** - see [Building Flows](/flows/building-flows)
|
||||
3. **Configure webhooks** - see [Setup App Webhooks](/install/guides/setup-app-webhooks)
|
||||
4. **Explore pieces** - browse available integrations in the piece library
|
||||
|
||||
## Additional Resources
|
||||
|
||||
- [Troubleshooting](/install/troubleshooting/websocket-issues): Troubleshooting guide
|
||||
- [Configuration Guide](/install/configuration/overview): Comprehensive configuration documentation
|
||||
- [Environment Variables](/install/configuration/environment-variables): Complete list of configuration options
|
||||
- [Architecture Overview](/install/architecture/overview): Understand Activepieces architecture
|
||||
- [Railway Documentation](https://docs.railway.app/): Official Railway platform documentation
|
||||
|
||||
Reference in New Issue
Block a user