Import a Git repository
This guide walks you through setting up Cube Cloud, importing a generic Git repository with an existing Cube project via SSH, and connecting to your database.
Step 1: Create an account
Navigate to cubecloud.dev (opens in a new tab), and create a new Cube Cloud account.
Step 2: Create a new Deployment
Click Create Deployment button. This is the first step in the deployment creation. Give it a name and select the cloud provider and region of your choice.
Microsoft Azure is available in Cube Cloud on Premium (opens in a new tab) tier. Contact us (opens in a new tab) for details.
Step 3: Import Git repository
Next up, the second step in creating a Cube App from scratch in Cube Cloud is to click Import Git repository via SSH button.
Enter the SSH URL of your Git repository, and click Generate SSH key:
Copy the SSH key and add it to your hosted Git repository. Back in Cube Cloud, click Connect. After a connection is successfully established, you should see the next screen:
Copy the Cube Cloud Git Webhook URL and add it your hosted Git repository's webhooks. Ensure that the Git repository can push events which should trigger a build on Cube Cloud. Back in Cube Cloud, click Connect to test the webhook.
Step 4: Connect your Database
Enter your credentials to connect to your database. Check the connecting to databases guide for more details.
Want to use a sample database instead? We also have a sample database where you can try out Cube Cloud:
| Field | Value |
|---|---|
| Host | demo-db.cube.dev |
| Port | 5432 |
| Database | ecom |
| Username | cube |
| Password | 12345 |
In the UI it'll look exactly like the image below.
If you run into issues here, make sure to allow the Cube Cloud IPs to access your database. This means you need to enable these IPs in your firewall. If you are using AWS, this would mean adding a security group with allowed IPs.
Step 5: Generate the Data Model
Step five in this case consists of generating data models. Start by selecting the database tables to generate the data models from, then hit Generate.
Cube Cloud will generate the data models and spin up your Cube deployment. With this, you're done. You've created a Cube deployment, configured a database connection, and generated data models!
You're ready for the last step, running queries in the Playground.
Step 6: Try out Cube Cloud
Now you can navigate to Playground to try out your queries or connect your application to the Cube Cloud API.