Skip to main content
Before you can install resources with pragma-os, you need:
  1. A Pragmatiks account
  2. A GCP project with the necessary APIs enabled
  3. Credentials configured for GCP access

​
Create a Pragmatiks Account

Sign up at pragmatiks.io. You can use Google, GitHub, or email to create your account. After signing up, verify your account is active: 
pragma auth login
pragma auth whoami
You should see your email address and account details.

​
GCP Project Requirements

pragma-os provisions resources in your GCP project. You need:
  • A GCP project with billing enabled
  • Owner or Editor role on the project (or specific IAM roles for the resources you want to use)

​
Required APIs

Enable the following APIs in your GCP project:
APIPurpose
Cloud Resource ManagerProject metadata
Cloud StorageStorage bucket resources
BigQueryDataset and table resources
IAMService account resources
Enable them via the console or gcloud: 
gcloud services enable cloudresourcemanager.googleapis.com \
  storage.googleapis.com \
  bigquery.googleapis.com \
  iam.googleapis.com \
  --project=YOUR_PROJECT_ID

​
Configure GCP Credentials

pragma-os needs credentials to manage resources in your GCP project. You have two options: Use your personal Google account credentials. This is the simplest approach for local development. 
gcloud auth application-default login
This opens a browser window. Sign in with a Google account that has access to your GCP project. Verify it worked: 
gcloud auth application-default print-access-token

​
Option 2: Service Account

For production or CI/CD environments, use a service account key.
  1. Create a service account in your GCP project
  2. Grant it the necessary roles (e.g., Storage Admin, BigQuery Admin)
  3. Download a JSON key file
  4. Set the environment variable:
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json
Keep service account keys secure. Never commit them to version control.

​
Verify Your Setup

Run these commands to confirm everything is configured: 
# Check Pragmatiks authentication
pragma auth whoami

# Check GCP project access
gcloud config get-value project

# Check GCP credentials
gcloud auth application-default print-access-token
All three commands should complete without errors.

​
Next Steps

Install the CLI

Install the Pragma CLI.

Quickstart

Install your first resource.