Services

Services are configurable capabilities inside a build recipe. Features enable a capability; service configuration controls how that capability behaves.

SSH


{
  "name": "ssh",
  "config": {
    "port": 2222,
    "allow_root": false,
    "disable_password_auth": true,
    "client_alive_interval": 30,
    "max_auth_tries": 3
  }
}

Option	Type	Default	Description
`port`	number	22	SSH listening port
`allow_root`	boolean	false	Permit root login
`disable_password_auth`	boolean	false	Require key-based auth
`client_alive_interval`	number	60	Keepalive interval
`max_auth_tries`	number	6	Max authentication attempts
`permit_empty_passwords`	boolean	false	Allow empty passwords

Network Services

Network-focused images can include services such as DNS forwarding, DHCP, VPN, firewall rules, and routing packages when supported by the selected base image.


{
  "name": "vpn",
  "config": {
    "type": "wireguard",
    "listen_port": 51820
  }
}

Web Services


{
  "name": "nginx",
  "config": {
    "sites": [
      {
        "server_name": "example.internal",
        "root": "/var/www/html",
        "ssl": true
      }
    ]
  }
}

Natural Language Examples


Configure SSH on port 2222 with key-only authentication.


Add WireGuard VPN, DNS forwarding, and firewall rules for a small office appliance.


Install nginx and serve the app from /opt/app/public.

Service Dependencies

Some services require packages, kernel modules, firewall rules, users, or startup scripts. OpenFactory validates the recipe before build and reports missing dependencies when it can detect them.