grapity init

Configure the CLI for local or remote registry mode.

Usage

grapity init --local|--remote [options]

Description

grapity init writes ~/.grapity/config.yaml, which tells all other CLI commands where to find the Registry. You only need to run this once per machine.

Options

Option	Description
--local	Use local mode (SQLite database on this machine)
--remote	Use remote mode (connect to a hosted Grapity server)
--url <url>	Registry URL (required for remote mode)
--api-key <key>	API key (for remote mode authentication)
--port <port>	Port for local server (default: 3750)
--db <path>	Path to SQLite database file (for local mode; default: ~/.grapity/registry.db)

Examples

Local mode (SQLite)

grapity init --local

Generated ~/.grapity/config.yaml:

mode: local
local:
  port: 3750
  sqlitePath: /Users/you/.grapity/registry.db

Self-hosted with custom port

grapity init --local --port 8080 --db /data/grapity.db

Remote mode (SaaS)

grapity init --remote --url https://api.grapity.dev --api-key YOUR_KEY

Generated ~/.grapity/config.yaml:

mode: remote
remote:
  url: https://api.grapity.dev
  apiKey: YOUR_KEY

Config file schema

mode: local | remote
local:
  port: number
  sqlitePath: string
remote:
  url: string
  apiKey: string

TIP

The CLI reads this config automatically. You never need to pass --url or --port to other commands after initialization.

See also

• grapity serve — Start the local Registry server
• grapity registry — Push and manage specs