Skip to content

Configuration

Hayhooks can be configured through environment variables, command-line arguments, or .env files.

Configuration Methods

Environment Variables

Set environment variables before starting Hayhooks:

export HAYHOOKS_HOST=0.0.0.0
export HAYHOOKS_PORT=1416
hayhooks run

.env File

Create a .env file in your project root:

# .env
HAYHOOKS_HOST=0.0.0.0
HAYHOOKS_PORT=1416
HAYHOOKS_PIPELINES_DIR=./pipelines
LOG=INFO

Command Line Arguments

Pass options directly to hayhooks run:

hayhooks run --host 0.0.0.0 --port 1416 --pipelines-dir ./pipelines

Common Configuration Options

The most frequently used options:

  • HAYHOOKS_HOST - Host to bind to (default: 127.0.0.1)
  • HAYHOOKS_PORT - Port to listen on (default: 1416)
  • HAYHOOKS_PIPELINES_DIR - Pipeline directory for auto-deployment (default: ./pipelines)
  • LOG - Log level: DEBUG, INFO, WARNING, ERROR (default: INFO)

For the complete list of all environment variables and detailed descriptions, see the Environment Variables Reference.

Example Configurations

Development

# .env.development
HAYHOOKS_HOST=127.0.0.1
HAYHOOKS_PORT=1416
LOG=DEBUG
HAYHOOKS_SHOW_TRACEBACKS=true

Production

# .env.production
HAYHOOKS_HOST=0.0.0.0
HAYHOOKS_PORT=1416
LOG=INFO
HAYHOOKS_SHOW_TRACEBACKS=false

Next Steps