Skip to content

Quick Start

Get up and running with envsecrets in a few minutes.

Prerequisites

  • Google Cloud Storage bucket
  • Service account with Storage Object Admin permissions
  • Service account JSON key file

1. Install envsecrets

go install github.com/charliek/envsecrets/cmd/envsecrets@latest

2. Initialize Configuration

Run the interactive setup:

envsecrets init

This creates ~/.envsecrets/config.yaml with your settings.

3. Set Up Your Project

Create a .envsecrets file in your project root listing files to track:

.env
.env.local
config/secrets.yaml

Add these files to your .gitignore:

.env
.env.local
config/secrets.yaml

4. Push Environment Files

envsecrets push -m "Initial environment setup"

5. Pull on Another Machine

After setting up envsecrets on another machine:

cd your-project
envsecrets pull

Next Steps