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

Hayhooks loads .env from the current directory or a parent directory. Files named .env.development or .env.production are not loaded automatically. Copy the selected configuration to .env, or inject its variables before starting the server.

Common Configuration Options

The most frequently used options:

  • HAYHOOKS_HOST - Host to bind to (default: localhost)
  • 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=localhost
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