Organization Setup

An Organization is the top-level scope in SemiLayer. Everything — projects, members, billing, and encryption keys — lives under an org. This guide walks through creating and configuring your org for the first time.

Create an Account

Sign up at console.semilayer.com. An organization is created automatically on first sign-in. You can rename it at any time.

Create an Organization

If you need a second org (e.g. for a separate product or company):

Console: Click your org name in the top-left → Create organization.

CLI:

semilayer orgs create
# prompts for name and slug

The org slug is used in API paths (/v1/orgs/:orgSlug/...) and in .semilayerrc. Slugs are lowercase, alphanumeric, and hyphen-separated. Choose something short and stable — you can rename the display name later but not the slug.

Create a Project

A Project is a logical application within an org. Each project gets its own set of environments, lenses, and API keys. You might have one project per product or per service.

Console: Sidebar → Projects → New project.

CLI:

semilayer projects create
# prompts for name and slug

When you create a project, a default development environment is created automatically.

Create an Environment

Environments are deployment stages within a project. The default is development. Production setups typically have development, staging, and production.

Console: Project page → Environments → New environment.

CLI:

semilayer envs create

Run semilayer init

Once your org, project, and environment exist, run semilayer init in your project directory to connect the CLI to them:

semilayer init

This interactive wizard:

1. Lets you select org → project → environment
2. Optionally creates a new API key
3. Saves context to .semilayerrc
4. Scaffolds a starter sl.config.ts if none exists

After init, all CLI commands target the saved context automatically.

Invite Team Members

Console: Settings → Team → Invite member.

CLI:

semilayer members invite --email alice@example.com --role developer

Available roles:

Invites expire after 7 days. The invite link is sent by email and also accessible from Settings → Team in the Console.

Manage API Keys

Each environment has its own API keys. Keys are created automatically with new environments, but you can create additional keys at any time.

Console: Settings → API Keys → Create key.

CLI:

semilayer keys create --type service --label my-backend

Copy the full key immediately — after the dialog closes, only the last 4 characters are visible.

Next Steps

With your org and project set up:

1. Connect a Source — add your first data source
2. Schema (Config) — define lenses in sl.config.ts
3. Push & Ingest — push your config and start indexing