Skip to main content

Projects

Projects are isolated Onehouse environments within your account.

Create a project​

You must be an account admin to create a project.

  1. Open your Onehouse account console.
  2. Click 'New Project'.
  3. Name your project and select a cloud provider and region.
  4. After creating the project follow the Getting Started docs to link your cloud account.

Resource isolation in Onehouse​

Projects allow you to set up complete resource isolation in Onehouse. When you set up your project, you can choose to link each project to a separate virtual private cloud (VPC).

Within a project, you can use clusters for compute isolation and lakes for storage isolation.

Project settings​

Project settings can be configured by Project Admins. Within your project in the Onehouse console, go to Settings > Project Settings. The page has three tabs: General, Data Plane and Integrations. The configurations below are on the General tab.

Default Catalog​

Specify the default catalog for the project. Learn more here.

Custom Instance Types​

Select custom instance types to make available to Clusters in the project. Learn more here.

Default Table Type​

Specify the default table type (Merge on Read or Copy on Write) for new tables created by Flows. You can also set the table type in your configurations when creating a Flow.

Merge on Read is recommended unless you have specific requirements for Copy on Write. Learn more about the table types in this guide.

Public Access to Main Load Balancer​

By default, users can only access the project's main load balancer from within your VPC (by following these steps). When this configuration is enabled, Onehouse-authenticated users in the project can access the main load balancer from outside the VPC, enabling easier access from a user's local browser.

The following capabilities are exposed on the project's main load balancer:

  • Viewing the Apache Spark UI for SQL Clusters and Jobs
  • Accessing Advanced Monitoring Grafana dashboards for the project. The Grafana URL appears under Data Plane > Monitoring once this is enabled. Prometheus stays reachable only from within your VPC.
  • Connecting to Notebook Clusters

Host Pattern Allowlist​

Specify a regex pattern to control which external domains can be used when creating a Source or Catalog. This protects against Server Side Request Forgery (SSRF) attacks.

Domains required by Onehouse are whitelisted by default and cannot be removed.

Delete a project​

Follow the these docs to delete a project.