Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

runtimehost

package

Go to main page

Versions in this module

v1

v1.2.12

Sep 1, 2026

Changes in this version

type Config

+ Enabled bool

type FileRuntimeConfig

+ Enabled *bool

+ type Host struct

+ func New(config Config, logger *log.Logger) (*Host, error)

+ func (host *Host) Address() string

+ func (host *Host) Service() *scheduler.Service

+ func (host *Host) Shutdown(ctx context.Context) error

+ func (host *Host) Start(ctx context.Context) error

+ func (host *Host) Wait() error

v1.2.11

Aug 28, 2026

v1.2.10-alpha

Aug 28, 2026

v1.2.9

Aug 27, 2026

v1.2.8

Aug 24, 2026

Changes in this version

+ const ConfigFileVersion

+ func NewHTTPHandler(api http.Handler, webDirectory, desktopToken string, ...) (http.Handler, error)

+ func Run(ctx context.Context, config Config, logger *log.Logger) error

+ func WriteRuntimeUnits(destination io.Writer) error

+ type Config struct

+ Address string

+ AutomationPeriod time.Duration

+ DataDirectory string

+ DefaultScope string

+ DesktopToken string

+ DisableAutomations bool

+ DisableEmbeddedWorker bool

+ Mode Mode

+ Version string

+ WebDirectory string

+ func (config Config) Validate() error

+ type FileConfig struct

+ Desktop FileDesktopConfig

+ Extensions map[string]interface{}

+ Redis FileRedisConfig

+ Runtime FileRuntimeConfig

+ Storage FileStorageConfig

+ Version int

+ func LoadConfigFile(path string) (FileConfig, error)

+ func (config FileConfig) Validate() error

+ func (fileConfig FileConfig) Apply(config Config) (Config, error)

+ type FileDatabaseConfig struct

+ DSN string

+ DSNEnv string

+ Driver string

+ type FileDesktopConfig struct

+ Language string

+ LaunchAtLogin *bool

+ PreventSleep *bool

+ type FileRedisConfig struct

+ Address string

+ Database int

+ Mode string

+ PasswordEnv string

+ TLS bool

+ Username string

+ type FileRuntimeConfig struct

+ AutomationPeriod string

+ Automations *bool

+ DataDirectory string

+ EmbeddedWorker *bool

+ ListenHost string

+ Port *int

+ type FileStorageConfig struct

+ Database FileDatabaseConfig

+ type Mode string

+ const ModeDesktop

+ const ModeHeadless

+ const ModeServer

v1.0.1-beta

Aug 21, 2026