Create an account

Overview

An Oblax account is your identity on the platform, carrying your roles, projects, and access tokens. Account creation assigns you the PLATFORM_USER role and creates a default organization where you’re the ORG_OWNER.

There are two ways to create an account: via the CLI for developers working locally, or via the web interface for browser-based registration.

Installation

Account creation doesn’t require installation, but you need the CLI installed and authenticated.

CLI Authentication

After creating your account, log in with:

obx login

This opens your default browser to the Oblax authentication page. After successful login:

Your JWT is stored in the CLI session
All subsequent obx commands use the token automatically
You’re ready to create your first project

Configuration

Account Creation Methods

Via CLI (Recommended for developers)

obx account create --email 'your-name@example.com'

What happens:

The CLI sends a registration request to the Oblax platform
A PLATFORM_USER role is automatically assigned to your new account
A default organization is created under your account
You’re automatically assigned the ORG_OWNER role for that organization
You’re logged in and ready to proceed

Success output:

| SUCCESS: Account created
| Welcome to Oblax, {your-name}!
| Your account has been created and you've been assigned the PLATFORM_USER role.
| A default organization has been created and you're its ORG_OWNER.
|
| Next: run `obx project create my-first-project` to get started.

Via Web Interface

Visit https://oblax.io/signup
Enter your email address and choose a password
Verify your email address via the confirmation link
Your account is created and you’re automatically assigned the PLATFORM_USER role

What Follows Account Creation

Item	Description	Your Role
Platform Role	`PLATFORM_USER`	Default role for all new users. Grants access to platform features.
Organization	A default org named after your account email prefix	`ORG_OWNER` — full control over your organization
Project Access	You can now create projects within your organization	Proceed to “Create a Project”

Authentication Tokens (JWTs)

Once logged in, you’ll work with JSON Web Tokens. Oblax uses two types:

Application JWTs

Used in the realm of your user-created applications.

{
  "iss": "your-app.api.oblax.io",
  "sub": "u:ct2d85u3lg52hbcdkg30",
  "aud": "your-app.api.oblax.io",
  "exp": 2524608000,
  "iat": 1596240000,
  "nbf": 0,
  "full_name": "Your Name",
  "email": "you@example.com",
  "pid": "cnoqeve3lg56dnbek55g",
  "realm": "app:webapp",
  "role": "admin"
}

Platform JWTs

Used in the realm of the Oblax platform itself.

{
  "iss": "platform.oblax.io",
  "sub": "u:ct2d85u3lg52hbcdkg30",
  "aud": "platform.oblax.io",
  "exp": 2524608000,
  "iat": 1596240000,
  "nbf": 0,
  "full_name": "Your Name",
  "pid": "cnoqeve3lg56dnbek55g",
  "realm": "platform",
  "role": "admin"
}

Key claims explained:

Claim	Meaning
`iss`	Issuer — the domain that issued the token
`sub`	Subject — who the token is for (`u:<hash>` = user, `s:<hash>` = service)
`aud`	Audience — where the token should be accepted
`exp`	Expiration time (Unix timestamp)
`iat`	Issued-at time
`nbf`	Not-before time
`full_name`	User’s full name (empty for service tokens)
`email`	User’s email (empty for service tokens)
`pid`	Project ID
`realm`	The access realm — `platform` or `app:<subrealm>`
`role`	User’s role within the realm

Usage

Logging In After Account Creation

obx login

This opens your default browser to the Oblax authentication page. After successful authentication:

Your JWT is stored locally (via the platform SDK or CLI session)
All subsequent obx commands use the token automatically
You’re ready to create your first project

Next Steps

Your account is ready. Now:

Create your first project — initialize your workspace
Build your first app — scaffold your application
Make your first API call — authenticate and interact