Skip to content
Tag-based environment configuration for structs
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


Tag-based environment configuration for structs.

Godoc Build Status Go Report Card


$ go get -u


package main

import (


type config struct {
	Secret            []byte        `env:"SECRET" required:"true"`
	Region            string        `env:"REGION"`
	Port              int           `env:"PORT" required:"true"`
	Peers             []string      `env:"PEERS"`
	ConnectionTimeout time.Duration `env:"TIMEOUT" default:"10s"`

func main() {
	c := config{}
	if err := env.Set(&c); err != nil {

$ ID=1 SECRET=shh PORT=1234 PEERS=localhost:1235,localhost:1236 TIMEOUT=5s go run main.go

Supported field types

  • bool and []bool
  • string and []string
  • []byte
  • int, int8, int16, int32, int64, []int, []int8, []int16, []int32, and []int64
  • uint, uint8, uint16, uint32, uint64, []uint, []uint8, []uint16, []uint32, and []uint64
  • float32, float64, []float32, and []float64
  • time.Duration and []time.Duration
You can’t perform that action at this time.