Connect to Cloud
Once you’ve created a deployment, you’ll need to install TLS certificates on your local machine to connect. You can obtain these on the Deployments page.
Click on a deployment to see the individual deployment view.
If you are connecting through Tailscale VPN, go to the Integrations card, then the Tailscale tab. Click Enable, then enter the Tailscale auth key in the Tailscale Authentication dialog and click Save. The deployment will automatically restart.
Tailscale integration must enabled separately for each deployment.
For help generating an auth key, please see the Tailscale documentation. Make sure you create a one-off key.
In the Connect card, go to the psql tab and click Download certificates.
Unzip the certificate package.
The certificate package is named
<deployment-name>.zipand contains the TLS certificates and keys you need to connect.
To connect to the deployment, you can use any Materialize-compatible CLI, like
mzcli. If you have
psqlinstalled on your machine, proceed to the next step.
Otherwise, follow the installation instructions.
Open a terminal window on your machine, copy the
psqlcommand from the connection dialog and run it from the directory that contains the certificates.
If you’re connecting through Tailscale, replace the hostname in the copied command with the address of your Materialize connection in Tailscale.
On connection success, you should see an open prompt waiting for your next commands:
psql (13.2, server 9.5.0) SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off) Type "help" for help. materialize=>