Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.krypthq.com/llms.txt

Use this file to discover all available pages before exploring further.

Krypt manages your environment variables across teams with end-to-end encryption. By the end of this guide you’ll have the CLI installed, a project linked, and your first secrets pushed.
You need a free Krypt account and Node.js 20 or newer to follow along.
1

Install the CLI

npm install -g @kryptorg/cli
Getting a permission error? Run the command with sudo (macOS/Linux) or open your terminal as Administrator (Windows).
sudo npm install -g @kryptorg/cli
Verify the install:
krypt --version
Expected output:
2.1.1
2

Generate an API key

  1. Open the API keys page in your Krypt dashboard
  2. Click Generate Key
  3. Name it after where you’ll use it — e.g. “my-laptop”, “production-ci”, “teammate-bob”
  4. Copy the key — it starts with krypt_live_ and is shown only once
3

Log in from your terminal

krypt login --key krypt_live_<your-key>
You should see:
✓ API key verified
  Config saved to ~/.krypt/config.json
4

Create a project

In your Krypt dashboard:
  1. Click New Project
  2. Name it my-app
  3. Save
5

Link your local folder

Inside your project directory, run:
krypt init my-app
This creates a .krypt config file that links the folder to your Krypt project.
6

Push your first secrets

If you already have a .env file, push it directly:
krypt push
Or create one first:
echo "DATABASE_URL=postgres://localhost:5432/mydb" > .env
echo "API_TOKEN=secret-value" >> .env
krypt push
You should see:
✓ Pushed 2 secret(s) to "my-app" (development)
Your secrets are now encrypted and stored in Krypt.
7

Pull secrets on another machine

If you’re working on multiple machines or setting up CI/CD, run krypt pull to fetch the latest secrets:
krypt pull
Krypt fetches your encrypted secrets and writes them to .env.
8

Run a command with injected secrets

Instead of writing a .env file, inject secrets directly into a process:
krypt run -- node server.js
Krypt loads your secrets as environment variables and starts the command. No .env file needed.

​
What’s next

Got Krypt running? Next, learn about the CLI commands, how to organize secrets across environments, or share projects with your team. These pages are being expanded — contact support@krypthq.com if you need help in the meantime.