Selfhost

Info

Follow these quick steps to install and update up the Cursion Platform with a SELFHOST plan.

Install

Prompt Based

Use this script to have the system walk you through configuring your self hosted version.

1. Spin up a linux server running the latest version of Ubuntu (>= 2Gi RAM)
2. Using your custom domain, point two sub-domains to your new server:
   • Create an A record for app.yourdomain.com
   • Create an A record for api.yourdomain.com
3. SSH into your Ubuntu server as the root user
4. Copy and run the installation script below:

curl -sSL https://cursion.dev/selfhost/install | bash

5. Retrieve your Cursion License key (cursion-license-1234abce...) from https://app.cursion.dev/account
6. Retrieve your OpenAI API key from https://platform.openai.com/api-keys
7. Follow the script prompts to spin up the services
8. Verify your installation by visiting app.yourdomain.com & api.yourdomain.com

NOTE: It may take several minutes to fully spin up the Cursion platform

Programmatic

Use this script to pass all required arguments to the install script and skip any prompts or inputs. Ideal for programmatic deployments.

1. Spin up a linux server running the latest version of Ubuntu (>= 2Gi RAM)
2. Retrieve your Cursion License key (cursion-license-1234abce...) from https://app.cursion.dev/account
3. Retrieve your OpenAI API key from https://platform.openai.com/api-keys
4. Using your custom domain, point two sub-domains to your new server:
   • Create an A record for app.yourdomain.com
   • Create an A record for api.yourdomain.com
5. SSH into your Ubuntu server as the root user
6. Copy and run the installation script below:

curl -sSL https://cursion.dev/selfhost/install | bash -s -- \
   <system_password> \
   <license_key> \
   <admin_email> \
   <admin_password> \
   <server_domain> \
   <client_domain> \
   <openai_api_key>
   

7. Verify your installation by visiting app.yourdomain.com & api.yourdomain.com

Update

Use this script to update your self hosted version of Cursion.

1. SSH into your Ubuntu server as the root user
2. Copy and run the installation script below:

curl -sSL https://cursion.dev/selfhost/update | bash -s -- <system_password>

NAT Gateway

Use this script to create a NAT Gateway for your Cursion instance.

1. SSH into a new Ubuntu server as the root user
2. Copy and run the installation script below:

curl -sSL https://cursion.dev/selfhost/nat | bash -s -- <vpc_cidr> <listen_port>

Args definitions:

Name	Description	Required
system_password	The password used by the server user during deployment	YES
license_key	Your license key found in your Cursion account	YES
admin_email	The email associated with your admin account on your private instance	YES
admin_password	The password associated with your admin account on your private instance	YES
server_domain	Your domain for your private server instance e.g. api.yourdomain.com	YES
client_domain	Your domain for your private client instance e.g. app.yourdomain.com	YES
openai_api_key	Your personal OpenAI API token	YES
vpc_cidr	The IP range where your instance is running (VPC)	YES
listen_port	The port for the NAT server to listen on, likely 8888	YES