Cloud Deploy
Getting Started
Prerequisites for Cloud Deploy and how to open it in Orkestia.
This guide walks you through the prerequisites for Cloud Deploy and how to open it in Orkestia.
Prerequisites
Before you use Cloud Deploy, your organization must have:
- An AWS Connection - Orkestia needs an AWS connection to create and manage S3 and CloudFront in your account, and to run builds on a managed build runner. If you don't have one yet, see AWS Connections.
- A GitHub Connection - Orkestia needs access to your GitHub repositories to clone code and (optionally) receive webhooks for auto-deploy. Connect GitHub from the Connections hub.
- Orkestia Account - You must be logged into Orkestia and have an organization selected.
A DNS connection is only required if you want to add custom domains to a site. You can create your first site and deploy without DNS; add a DNS connection later when you're ready for custom domains.
Step 1: Ensure Connections Are Ready
Check your connections
From the Orkestia dashboard, click Connections in the sidebar.
Verify connection status
Confirm you have at least one Active AWS connection and one Active GitHub connection.
Add missing connections
If either is missing, add and validate the connection before opening Cloud Deploy.
Step 2: Open Cloud Deploy
- In the sidebar, under Apps, click Cloud Deploy (or the rocket icon labeled Cloud Deploy).
- Alternatively, navigate directly to
/apps/spadin your browser. - You'll land on the Cloud Deploy list page, which shows all sites in your organization.
First-Time Experience
- If you have no sites yet: The page shows an empty state with a New Site (or Create site) button. Click it to start the New Site wizard.
- If connections are missing: Cloud Deploy may show a message that you need an AWS and a GitHub connection. Return to Connections to add them, then open Cloud Deploy again.