Skip to content

fm webserver

Reference for the fm webserver command group (auto-generated from fm webserver --help).

fm webserver

text
Cross-engine Webserver management commands.

Use the engine-specific subcommands (listed below) for instance lifecycle:
  fm webserver <engine> instance create --name ... --version ... --flavor ... --vpc ... --subnet ...

This command group provides cross-engine views only:
  fm webserver instance list     List all instances (all engines)
  fm webserver instance get      Get instance details
  fm webserver version list      List all versions (all engines)
  fm webserver flavor list       List all flavors (all engines)

Usage:
  fm webserver [command]

Available Commands:
  apache      Manage Apache webservers
  flavor      Manage Webserver flavors
  instance    View Webserver instances (all engines)
  nginx       Manage Nginx webservers
  version     Manage Webserver versions

Flags:
  -h, --help   help for webserver

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver [command] --help" for more information about a command.

fm webserver apache

text
Manage Apache webservers instances and more.

Usage:
  fm webserver apache [command]

Available Commands:
  config      Manage Apache configuration
  deploy      Deploy site content to a Apache instance
  deploys     Inspect Apache content deploys
  domain      Manage Apache domains
  expose      Expose a Apache instance publicly
  flavor      Manage Apache flavors
  instance    Manage Apache instances
  unexpose    Remove public exposure from a Apache instance
  version     Manage Apache versions

Flags:
  -h, --help   help for apache

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver apache [command] --help" for more information about a command.

fm webserver apache config

text
Get and set Apache instance configuration parameters.

Usage:
  fm webserver apache config [command]

Available Commands:
  apply       Replace Apache engine configuration (declarative)
  get         Get Apache engine configuration
  set         Set Apache engine configuration values (merge)

Flags:
  -h, --help   help for config

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver apache config [command] --help" for more information about a command.
fm webserver apache config apply
text
Replace the entire curated engine configuration of a Apache instance with
exactly the given key=value pairs; keys not listed are removed. Called with no
pairs it resets the engine to its boot defaults.

Allowed keys: indexFiles, spaFallback, clientMaxBodySize, gzip, securityHeaders, error404Page, error500Page

Examples:
  fm webserver apache config apply ws-123 gzip=true spaFallback=true
  fm webserver apache config apply ws-123            # reset to engine defaults

Usage:
  fm webserver apache config apply <instance-id> [key=value...] [flags]

Flags:
  -h, --help   help for apply

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver apache config get
text
Get the stored curated engine configuration and its apply state for a Apache instance.

Usage:
  fm webserver apache config get <instance-id> [flags]

Flags:
  -h, --help   help for get

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver apache config set
text
Set one or more curated engine-config values on a Apache instance, merged into
the existing configuration (keys not named are left unchanged).

Allowed keys: indexFiles, spaFallback, clientMaxBodySize, gzip, securityHeaders, error404Page, error500Page

Examples:
  fm webserver apache config set ws-123 gzip=true securityHeaders=true
  fm webserver apache config set ws-123 clientMaxBodySize=25m

Usage:
  fm webserver apache config set <instance-id> <key=value> [key=value...] [flags]

Flags:
  -h, --help   help for set

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver apache deploy

text
Deploy a .tar.gz site archive to a Apache webserver instance (ADR-0091).

The archive is uploaded to a presigned URL; the in-guest agent then verifies its
SHA-256, extracts it, and atomically swaps the document root to the new release.

Examples:
  fm webserver apache deploy ws-123 ./site.tar.gz
  fm webserver apache deploy ws-123 ./site.tar.gz --no-wait

Usage:
  fm webserver apache deploy <instance-id> <archive.tar.gz> [flags]

Flags:
  -h, --help      help for deploy
      --no-wait   return after starting the deploy instead of waiting for it to finish

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver apache deploys

text
List and inspect content deploys for a Apache webserver instance.

Usage:
  fm webserver apache deploys [command]

Aliases:
  deploys, deploy-list

Available Commands:
  get         Get a Apache content deploy
  list        List Apache content deploys

Flags:
  -h, --help   help for deploys

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver apache deploys [command] --help" for more information about a command.
fm webserver apache deploys get
text
Get details of a single content deploy for a Apache webserver instance.

Usage:
  fm webserver apache deploys get <instance-id> <deploy-id> [flags]

Flags:
  -h, --help   help for get

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver apache deploys list
text
List content deploys for a Apache webserver instance, most recent first.

Usage:
  fm webserver apache deploys list <instance-id> [flags]

Flags:
  -h, --help   help for list

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver apache domain

text
Manage domains for Apache webserver instances.

Usage:
  fm webserver apache domain [command]

Aliases:
  domain, domains

Available Commands:
  add         Add a domain to a Apache instance
  list        List Apache domains
  remove      Remove a domain from a Apache instance

Flags:
  -h, --help   help for domain

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver apache domain [command] --help" for more information about a command.
fm webserver apache domain add
text
Add a domain to a Apache webserver instance.

Examples:
  fm apache domain add ws-123 --name example.com
  fm apache domain add ws-123 --name example.com --tls

Usage:
  fm webserver apache domain add <instance-id> [flags]

Flags:
  -h, --help          help for add
      --name string   domain name (required)
      --tls           enable TLS for the domain

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver apache domain list
text
List all domains for a Apache webserver instance.

Usage:
  fm webserver apache domain list <instance-id> [flags]

Flags:
  -h, --help   help for list

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver apache domain remove
text
Remove a domain from a Apache webserver instance.

Usage:
  fm webserver apache domain remove <instance-id> <domain-id> [flags]

Flags:
  -h, --help   help for remove

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver apache expose

text
Allocate and associate a Public IP so the Apache instance's site is reachable
on the public internet (ADR-0097). Asynchronous: by default this waits for the
exposure to complete and prints the public IP.

Examples:
  fm webserver apache expose ws-123
  fm webserver apache expose ws-123 --no-wait

Usage:
  fm webserver apache expose <instance-id> [flags]

Flags:
  -h, --help      help for expose
      --no-wait   return immediately instead of waiting for exposure to complete

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver apache flavor

text
List available Apache instance sizes.

Usage:
  fm webserver apache flavor [command]

Aliases:
  flavor, flavors

Available Commands:
  list        List Apache flavors

Flags:
  -h, --help   help for flavor

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver apache flavor [command] --help" for more information about a command.
fm webserver apache flavor list
text
List all available Apache instance sizes.

Usage:
  fm webserver apache flavor list [flags]

Flags:
  -h, --help   help for list

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver apache instance

text
Manage Apache webserver instances.

Usage:
  fm webserver apache instance [command]

Aliases:
  instance, instances

Available Commands:
  create      Create a Apache instance
  delete      Delete a Apache instance
  get         Get Apache instance details
  list        List Apache instances
  resize      Resize a Apache instance
  restart     Restart a Apache instance
  start       Start a Apache instance
  stop        Stop a Apache instance

Flags:
  -h, --help   help for instance

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver apache instance [command] --help" for more information about a command.
fm webserver apache instance create
text
Create a new managed Apache webserver instance.

Examples:
  fm webserver apache instance create --name my-web --version 2.4 --flavor web.gp1.medium --storage 50 --vpc vpc-123 --subnet subnet-456

Usage:
  fm webserver apache instance create [flags]

Flags:
      --engine-config stringArray   engine-config entry key=value, repeatable (allowed keys: indexFiles, spaFallback, clientMaxBodySize, gzip, securityHeaders, error404Page, error500Page)
      --flavor string               flavor ID (required, e.g. db.gp1.micro — see 'flavors list')
  -h, --help                        help for create
      --name string                 instance name (required)
      --no-wait                     return immediately instead of waiting for provisioning to complete
      --php-enabled                 enable PHP-FPM
      --php-version string          PHP version (e.g. 8.1, 8.2, 8.3; server default when omitted)
      --public                      expose the instance publicly at create time (allocates a Public IP)
      --storage int                 storage size in GB (required)
      --subnet string               subnet ID (required)
      --version string              Apache version (required)
      --vpc string                  VPC ID (required)

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver apache instance delete
text
Delete a managed Apache instance.

Usage:
  fm webserver apache instance delete <instance-id> [flags]

Flags:
  -h, --help   help for delete

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver apache instance get
text
Get detailed information about a specific Apache instance.

Usage:
  fm webserver apache instance get <instance-id> [flags]

Flags:
  -h, --help   help for get

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver apache instance list
text
List all Apache instances.

Usage:
  fm webserver apache instance list [flags]

Flags:
  -h, --help   help for list

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver apache instance resize
text
Grow the storage of a Apache instance. Storage can only be increased (volumes cannot shrink); flavor resize is not yet supported.

Examples:
  fm apache instance resize <instance-id> --storage 20

Usage:
  fm webserver apache instance resize <instance-id> [flags]

Flags:
  -h, --help          help for resize
      --storage int   new storage size in GB

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver apache instance restart
text
Restart a Apache instance.

Usage:
  fm webserver apache instance restart <instance-id> [flags]

Flags:
  -h, --help   help for restart

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver apache instance start
text
Start a stopped Apache instance.

Usage:
  fm webserver apache instance start <instance-id> [flags]

Flags:
  -h, --help   help for start

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver apache instance stop
text
Stop a running Apache instance.

Usage:
  fm webserver apache instance stop <instance-id> [flags]

Flags:
  -h, --help   help for stop

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver apache unexpose

text
Disassociate and release the Apache instance's Public IP, returning it to
private-only (ADR-0097). Asynchronous.

Examples:
  fm webserver apache unexpose ws-123

Usage:
  fm webserver apache unexpose <instance-id> [flags]

Flags:
  -h, --help      help for unexpose
      --no-wait   return immediately instead of waiting for the change to complete

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver apache version

text
List available Apache versions.

Usage:
  fm webserver apache version [command]

Aliases:
  version, versions

Available Commands:
  list        List available Apache versions

Flags:
  -h, --help   help for version

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver apache version [command] --help" for more information about a command.
fm webserver apache version list
text
List all available Apache engine versions.

Usage:
  fm webserver apache version list [flags]

Flags:
  -h, --help   help for list

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver flavor

text
List available Webserver instance sizes.

Usage:
  fm webserver flavor [command]

Aliases:
  flavor, flavors

Available Commands:
  list        List Webserver flavors

Flags:
  -h, --help   help for flavor

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver flavor [command] --help" for more information about a command.

fm webserver flavor list

text
List all available Webserver instance sizes.

Usage:
  fm webserver flavor list [flags]

Flags:
  -h, --help   help for list

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver instance

text
View managed Webserver instances across all engines.

Usage:
  fm webserver instance [command]

Aliases:
  instance, instances

Available Commands:
  get         Get Webserver instance details
  list        List Webserver instances

Flags:
  -h, --help   help for instance

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver instance [command] --help" for more information about a command.

fm webserver instance get

text
Get detailed information about a specific Webserver instance.

Usage:
  fm webserver instance get <instance-id> [flags]

Flags:
  -h, --help   help for get

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver instance list

text
List all Webserver instances.

Usage:
  fm webserver instance list [flags]

Flags:
  -h, --help   help for list

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver nginx

text
Manage Nginx webservers instances and more.

Usage:
  fm webserver nginx [command]

Available Commands:
  config      Manage Nginx configuration
  deploy      Deploy site content to a Nginx instance
  deploys     Inspect Nginx content deploys
  domain      Manage Nginx domains
  expose      Expose a Nginx instance publicly
  flavor      Manage Nginx flavors
  instance    Manage Nginx instances
  unexpose    Remove public exposure from a Nginx instance
  version     Manage Nginx versions

Flags:
  -h, --help   help for nginx

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver nginx [command] --help" for more information about a command.

fm webserver nginx config

text
Get and set Nginx instance configuration parameters.

Usage:
  fm webserver nginx config [command]

Available Commands:
  apply       Replace Nginx engine configuration (declarative)
  get         Get Nginx engine configuration
  set         Set Nginx engine configuration values (merge)

Flags:
  -h, --help   help for config

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver nginx config [command] --help" for more information about a command.
fm webserver nginx config apply
text
Replace the entire curated engine configuration of a Nginx instance with
exactly the given key=value pairs; keys not listed are removed. Called with no
pairs it resets the engine to its boot defaults.

Allowed keys: indexFiles, spaFallback, clientMaxBodySize, gzip, securityHeaders, error404Page, error500Page

Examples:
  fm webserver nginx config apply ws-123 gzip=true spaFallback=true
  fm webserver nginx config apply ws-123            # reset to engine defaults

Usage:
  fm webserver nginx config apply <instance-id> [key=value...] [flags]

Flags:
  -h, --help   help for apply

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver nginx config get
text
Get the stored curated engine configuration and its apply state for a Nginx instance.

Usage:
  fm webserver nginx config get <instance-id> [flags]

Flags:
  -h, --help   help for get

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver nginx config set
text
Set one or more curated engine-config values on a Nginx instance, merged into
the existing configuration (keys not named are left unchanged).

Allowed keys: indexFiles, spaFallback, clientMaxBodySize, gzip, securityHeaders, error404Page, error500Page

Examples:
  fm webserver nginx config set ws-123 gzip=true securityHeaders=true
  fm webserver nginx config set ws-123 clientMaxBodySize=25m

Usage:
  fm webserver nginx config set <instance-id> <key=value> [key=value...] [flags]

Flags:
  -h, --help   help for set

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver nginx deploy

text
Deploy a .tar.gz site archive to a Nginx webserver instance (ADR-0091).

The archive is uploaded to a presigned URL; the in-guest agent then verifies its
SHA-256, extracts it, and atomically swaps the document root to the new release.

Examples:
  fm webserver nginx deploy ws-123 ./site.tar.gz
  fm webserver nginx deploy ws-123 ./site.tar.gz --no-wait

Usage:
  fm webserver nginx deploy <instance-id> <archive.tar.gz> [flags]

Flags:
  -h, --help      help for deploy
      --no-wait   return after starting the deploy instead of waiting for it to finish

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver nginx deploys

text
List and inspect content deploys for a Nginx webserver instance.

Usage:
  fm webserver nginx deploys [command]

Aliases:
  deploys, deploy-list

Available Commands:
  get         Get a Nginx content deploy
  list        List Nginx content deploys

Flags:
  -h, --help   help for deploys

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver nginx deploys [command] --help" for more information about a command.
fm webserver nginx deploys get
text
Get details of a single content deploy for a Nginx webserver instance.

Usage:
  fm webserver nginx deploys get <instance-id> <deploy-id> [flags]

Flags:
  -h, --help   help for get

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver nginx deploys list
text
List content deploys for a Nginx webserver instance, most recent first.

Usage:
  fm webserver nginx deploys list <instance-id> [flags]

Flags:
  -h, --help   help for list

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver nginx domain

text
Manage domains for Nginx webserver instances.

Usage:
  fm webserver nginx domain [command]

Aliases:
  domain, domains

Available Commands:
  add         Add a domain to a Nginx instance
  list        List Nginx domains
  remove      Remove a domain from a Nginx instance

Flags:
  -h, --help   help for domain

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver nginx domain [command] --help" for more information about a command.
fm webserver nginx domain add
text
Add a domain to a Nginx webserver instance.

Examples:
  fm nginx domain add ws-123 --name example.com
  fm nginx domain add ws-123 --name example.com --tls

Usage:
  fm webserver nginx domain add <instance-id> [flags]

Flags:
  -h, --help          help for add
      --name string   domain name (required)
      --tls           enable TLS for the domain

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver nginx domain list
text
List all domains for a Nginx webserver instance.

Usage:
  fm webserver nginx domain list <instance-id> [flags]

Flags:
  -h, --help   help for list

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver nginx domain remove
text
Remove a domain from a Nginx webserver instance.

Usage:
  fm webserver nginx domain remove <instance-id> <domain-id> [flags]

Flags:
  -h, --help   help for remove

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver nginx expose

text
Allocate and associate a Public IP so the Nginx instance's site is reachable
on the public internet (ADR-0097). Asynchronous: by default this waits for the
exposure to complete and prints the public IP.

Examples:
  fm webserver nginx expose ws-123
  fm webserver nginx expose ws-123 --no-wait

Usage:
  fm webserver nginx expose <instance-id> [flags]

Flags:
  -h, --help      help for expose
      --no-wait   return immediately instead of waiting for exposure to complete

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver nginx flavor

text
List available Nginx instance sizes.

Usage:
  fm webserver nginx flavor [command]

Aliases:
  flavor, flavors

Available Commands:
  list        List Nginx flavors

Flags:
  -h, --help   help for flavor

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver nginx flavor [command] --help" for more information about a command.
fm webserver nginx flavor list
text
List all available Nginx instance sizes.

Usage:
  fm webserver nginx flavor list [flags]

Flags:
  -h, --help   help for list

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver nginx instance

text
Manage Nginx webserver instances.

Usage:
  fm webserver nginx instance [command]

Aliases:
  instance, instances

Available Commands:
  create      Create a Nginx instance
  delete      Delete a Nginx instance
  get         Get Nginx instance details
  list        List Nginx instances
  resize      Resize a Nginx instance
  restart     Restart a Nginx instance
  start       Start a Nginx instance
  stop        Stop a Nginx instance

Flags:
  -h, --help   help for instance

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver nginx instance [command] --help" for more information about a command.
fm webserver nginx instance create
text
Create a new managed Nginx webserver instance.

Examples:
  fm webserver nginx instance create --name my-web --version 2.4 --flavor web.gp1.medium --storage 50 --vpc vpc-123 --subnet subnet-456

Usage:
  fm webserver nginx instance create [flags]

Flags:
      --engine-config stringArray   engine-config entry key=value, repeatable (allowed keys: indexFiles, spaFallback, clientMaxBodySize, gzip, securityHeaders, error404Page, error500Page)
      --flavor string               flavor ID (required, e.g. db.gp1.micro — see 'flavors list')
  -h, --help                        help for create
      --name string                 instance name (required)
      --no-wait                     return immediately instead of waiting for provisioning to complete
      --php-enabled                 enable PHP-FPM
      --php-version string          PHP version (e.g. 8.1, 8.2, 8.3; server default when omitted)
      --public                      expose the instance publicly at create time (allocates a Public IP)
      --storage int                 storage size in GB (required)
      --subnet string               subnet ID (required)
      --version string              Nginx version (required)
      --vpc string                  VPC ID (required)

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver nginx instance delete
text
Delete a managed Nginx instance.

Usage:
  fm webserver nginx instance delete <instance-id> [flags]

Flags:
  -h, --help   help for delete

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver nginx instance get
text
Get detailed information about a specific Nginx instance.

Usage:
  fm webserver nginx instance get <instance-id> [flags]

Flags:
  -h, --help   help for get

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver nginx instance list
text
List all Nginx instances.

Usage:
  fm webserver nginx instance list [flags]

Flags:
  -h, --help   help for list

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver nginx instance resize
text
Grow the storage of a Nginx instance. Storage can only be increased (volumes cannot shrink); flavor resize is not yet supported.

Examples:
  fm nginx instance resize <instance-id> --storage 20

Usage:
  fm webserver nginx instance resize <instance-id> [flags]

Flags:
  -h, --help          help for resize
      --storage int   new storage size in GB

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver nginx instance restart
text
Restart a Nginx instance.

Usage:
  fm webserver nginx instance restart <instance-id> [flags]

Flags:
  -h, --help   help for restart

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver nginx instance start
text
Start a stopped Nginx instance.

Usage:
  fm webserver nginx instance start <instance-id> [flags]

Flags:
  -h, --help   help for start

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)
fm webserver nginx instance stop
text
Stop a running Nginx instance.

Usage:
  fm webserver nginx instance stop <instance-id> [flags]

Flags:
  -h, --help   help for stop

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver nginx unexpose

text
Disassociate and release the Nginx instance's Public IP, returning it to
private-only (ADR-0097). Asynchronous.

Examples:
  fm webserver nginx unexpose ws-123

Usage:
  fm webserver nginx unexpose <instance-id> [flags]

Flags:
  -h, --help      help for unexpose
      --no-wait   return immediately instead of waiting for the change to complete

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver nginx version

text
List available Nginx versions.

Usage:
  fm webserver nginx version [command]

Aliases:
  version, versions

Available Commands:
  list        List available Nginx versions

Flags:
  -h, --help   help for version

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver nginx version [command] --help" for more information about a command.
fm webserver nginx version list
text
List all available Nginx engine versions.

Usage:
  fm webserver nginx version list [flags]

Flags:
  -h, --help   help for list

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm webserver version

text
List available Webserver versions.

Usage:
  fm webserver version [command]

Aliases:
  version, versions

Available Commands:
  list        List available Webserver versions

Flags:
  -h, --help   help for version

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm webserver version [command] --help" for more information about a command.

fm webserver version list

text
List all available Webserver engine versions.

Usage:
  fm webserver version list [flags]

Flags:
  -h, --help   help for list

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)