Server

Start a local web server to browse and view your recipe collection.

recipes recipe shopping list pantry

Usage

cook server [OPTIONS] [BASE_PATH]

Arguments

ArgumentDescription
[BASE_PATH]Root directory containing recipe files (default: current directory)

Options

OptionDescription
--host [<ADDRESS>]Allow connections from external hosts (default: localhost only). Optionally bind to a specific address.
-p, --port <PORT>Port number (default: 9080)
--openAutomatically open the web interface in your default browser

Examples

# Start on localhost:9080
cook server

# Serve recipes from a specific directory
cook server ~/my-recipes

# Custom port with auto-open
cook server --port 8080 --open

# Allow access from other devices on the network
cook server --host

Notes

  • By default, only accepts connections from localhost
  • Use --host on trusted networks only — recipes become accessible to anyone on the network
  • The web interface supports recipe browsing, scaling, search, and shopping list management
  • The UI language is negotiated per request from the browser's Accept-Language header — each visitor sees the interface in their own language (supported: en-US, de-DE, nl-NL, fr-FR, es-ES, eu-ES, sv-SE). For static sites, see the --lang flag of cook build web.
  • Mobile-friendly responsive layout