Skip to content
MassiCloud Docs

Projects & Databases

Projects

A project is the top-level organizational unit in MassiCloud. Think of it as one application. A project owns:

  • Databases (Postgres) and Redis instances
  • Storage buckets
  • API keys (anon and service)
  • End-user accounts

You typically create one project per application. If you need staging and production environments, create two projects — or use two databases within one project.

API Keys

When you create a project, two keys are generated:

KeyPrefixPurpose
Anon keymc_anon_Browser / mobile apps. Subject to RLS.
Service keymc_service_Server-side only. Bypasses RLS.

The service key is shown once at creation. Store it in your secrets manager immediately.

Databases

Each database within a project is a Postgres instance, created when you create it. You can have multiple databases per project.

The auth schema

The auth schema and everything below it (RLS, auth.uid(), etc.) applies to your Postgres databases.

When you enable the auth schema on a database, MassiCloud creates:

  • auth.users — your app’s end-users
  • auth.sessions — active sessions
  • Helper functions: auth.uid(), auth.role(), auth.email()

These are used by RLS policies to scope data access per user.

The public schema

Your application tables live here by default. Tables created through the portal or migrations land in public.*.

Redis

Redis databases are available for caching, pub/sub, and rate-limiting. They are not exposed via the REST API — connect via standard Redis client libraries using the connection string from the portal.