Skip to main content
This guide is for the Connect plan, where Platinur builds your governed warehouse on a ClickHouse service your organization owns and pays for. It takes you from zero to connected: create the service, collect three values, and paste them into Platinur. If you chose Managed, Platinur provisions and binds the capacity selected during signup, so you do not need this guide. You need no ClickHouse experience — the whole thing takes about ten minutes, most of which is waiting for the service to provision.
Already have a running ClickHouse Cloud service? Skip to Step 3 — collect your connection details below.

​
Step 1 — Create a ClickHouse Cloud account

  1. Go to clickhouse.com and choose Get started (ClickHouse Cloud offers a free trial with credits — no card needed to begin).
  2. Sign up with your work email (or Google/Microsoft SSO) and verify the address.
  3. When asked, create your organization — your company name is fine.

​
Step 2 — Create a service

A service is your actual ClickHouse database. From the ClickHouse Cloud console:
  1. Choose New service.
  2. Name it something recognizable — e.g. acme-analytics.
  3. Pick a cloud provider and region close to where your source data and team live (this is where your data will physically reside).
  4. Pick the plan tier — the entry tier is plenty to start; you can scale later without reconnecting anything.
  5. Create the service and wait for it to reach Running (a few minutes).
ClickHouse Cloud services idle automatically when unused and wake on the first connection. This is normal and saves you money — Platinur knows about it and waits for the wake-up when testing the connection.

​
Step 3 — Collect your connection details

When the service is created, ClickHouse shows a connection screen (you can always get back to it later via the service’s Connect button). You need exactly three values:
The password is displayed only at creation time. If you didn’t save it, don’t worry — open the service in the ClickHouse console and use Reset password, then use the new one.
You do not need ports, TLS settings, or anything else — Platinur’s defaults match ClickHouse Cloud exactly (TLS on, HTTPS port 8443).

​
Step 4 — Connect it in Platinur

  1. Sign in to your Platinur workspace and open Configuration from the sidebar.
  2. In the Data Warehouse card, select ClickHouse.
  3. Paste the three values: Host, Username, Password.
  4. Press Test connection.
A successful test binds the warehouse to your workspace. From here on, everything Platinur builds — raw source data, cleaned models, your marts — lives in this service, under your ownership.
If the very first test takes ~30 seconds, that’s your idled service waking up — Platinur retries through the wake automatically. If it still fails afterwards, run the test once more.

​
What Platinur creates in your service

Platinur keeps a strict, predictable layout — it only ever writes to its own databases:
  • raw_<source> — one database per connected source (e.g. raw_stripe), where loads land.
  • stg_staging, stg_dw, stg_marts — the staging environment’s built layers.
  • prod_staging, prod_dw, prod_marts — the production layers.
  • A temporary *_validation database during proposal validation, dropped after each run.
Databases you created yourself are treated as read-only external sources — Platinur can model from them but never modifies them. See Data Boundary for the full contract.

​
Good to know

  • The warehouse is chosen once per workspace. After binding, you can update the credentials any time (Configuration → Data Warehouse — type a new password and press Test & save connection), but you cannot unbind or switch it in place. To use a different warehouse, delete the workspace from Settings → Delete account and create a new paid workspace with the intended plan.
  • Credentials are stored encrypted in your workspace’s secret store — never in files, logs, or generated code. The password field always reads “Stored securely”; Platinur never displays it back.
  • IP access lists: ClickHouse Cloud services allow connections from anywhere by default. If your organization restricts the service’s IP access list, add Platinur’s address — contact support for the current one.
  • A dedicated user (optional hardening): the default user is fine to start. For production you can create a dedicated platinur user in the ClickHouse console (Settings → Users) with permission to create and manage databases, and connect with that instead.

​
Next steps

With the warehouse bound, continue with:
  1. Connect GitHub — one click installs the Platinur GitHub App.
  2. Connect a source and load your data.
  3. Build your models — the guided first build interviews you, validates the generated warehouse, and commits it to Staging for review in Promotions.