Skip to content

Quickstart

Run a command with your Envlet variables in a few minutes.

You need Node.js 22 or later, npm, and a Git repository.

  1. Install the CLI

    Install the envlet command globally:

    Terminal window
    npm install -g @envlet/cli

    Check that the command is available:

    Terminal window
    envlet --help
  2. Sign in to Envlet

    Start the browser login flow:

    Terminal window
    envlet login

    The CLI shows a URL and a code. Open the URL, enter the code, and approve the login.

  3. Create your environment

    Open the Envlet dashboard.

    Create a project, then create an environment in that project. Add the variables that your command needs.

    To follow the example below, add APP_GREETING with the shared value hello from Envlet.

  4. Connect your repository

    Open a terminal inside your Git repository, then run:

    Terminal window
    envlet init

    Select the project and environment when the CLI asks. Envlet writes the selection to .envlet at the repository root.

  5. Run your command

    Run a command with the variables for the selected environment:

    Terminal window
    envlet run -- node -e 'console.log(process.env.APP_GREETING)'

    The command prints hello from Envlet. Put envlet run -- before the command that you normally use in the repository.

Use Envlet in production to start servers with Envlet values.

Use the Node SDK when your application needs programmatic access.