OS Manuals

/usr/bin/coder

Self-hosted platform for provisioning and managing remote development environments

From coder-2.33 2.33.11-r24 (enterprise-packages), captured 2026-11-08 by running coder --help (exit 0). permalink

coder v2.33.11+0cfa936

USAGE:
  coder [global-flags] <subcommand>

  Coder v2.33.11+0cfa936 — A tool for provisioning self-hosted development
  environments with Terraform.
    - Start a Coder server:

       $ coder server

    - Get started by creating a template from an example:

       $ coder templates init

SUBCOMMANDS:
    agents            Interactive terminal UI for AI agents.
    autoupdate        Toggle auto-update policy for a workspace
    completion        Install or update shell completion scripts for the
                      detected or chosen shell.
    config-ssh        Add an SSH Host entry for your workspaces "ssh
                      workspace.coder"
    create            Create a workspace
    delete            Delete a workspace
    dotfiles          Personalize your workspace by applying a canonical
                      dotfiles repository
    external-auth     Manage external authentication
    favorite          Add a workspace to your favorites
    list              List workspaces
    login             Authenticate with Coder deployment
    logout            Unauthenticate your local session
    logs              View logs for a workspace
    netcheck          Print network debug information for DERP and STUN
    notifications     Manage Coder notifications
    open              Open a workspace
    organizations     Organization related commands
    ping              Ping a workspace
    port-forward      Forward ports from a workspace to the local machine. For
                      reverse port forwarding, use "coder ssh -R".
    provisioner       View and manage provisioner daemons and jobs
    publickey         Output your Coder public key used for Git operations
    rename            Rename a workspace
    reset-password    Directly connect to the database to reset a user's
                      password
    restart           Restart a workspace
    schedule          Schedule automated start and stop times for workspaces
    secret            Manage secrets
    server            Start a Coder server
    show              Display details of a workspace's resources and agents
    speedtest         Run upload and download tests from your machine to a
                      workspace
    ssh               Start a shell into a workspace or run a command
    start             Start a workspace
    stat              Show resource usage for the current workspace.
    state             Manually manage Terraform state to fix broken workspaces
    stop              Stop a workspace
    support           Commands for troubleshooting issues with a Coder
                      deployment.
    task              Manage tasks
    templates         Manage templates
    tokens            Manage personal access tokens
    unfavorite        Remove a workspace from your favorites
    update            Will update and start a given workspace if it is out of
                      date. If the workspace is already running, it will be
                      stopped first.
    users             Manage users
    version           Show coder version
    whoami            Fetch authenticated user info for Coder deployment

GLOBAL OPTIONS:
Global options are applied to all commands. They can be set using environment
variables or flags.

      --client-tls-ca-file string, $CODER_CLIENT_TLS_CA_FILE
          Path to a CA certificate file to trust for API and DERP connections.

      --client-tls-cert-file string, $CODER_CLIENT_TLS_CERT_FILE
          Path to a client certificate file for mTLS authentication with API and
          DERP. Requires --client-tls-key-file.

      --client-tls-key-file string, $CODER_CLIENT_TLS_KEY_FILE
          Path to a client private key file for mTLS authentication with API and
          DERP. Requires --client-tls-cert-file.

      --debug-options bool
          Print all options, how they're set, then exit.

      --disable-direct-connections bool, $CODER_DISABLE_DIRECT_CONNECTIONS
          Disable direct (P2P) connections to workspaces.

      --disable-network-telemetry bool, $CODER_DISABLE_NETWORK_TELEMETRY
          Disable network telemetry. Network telemetry is collected when
          connecting to workspaces using the CLI, and is forwarded to the
          server. If telemetry is also enabled on the server, it may be sent to
          Coder. Network telemetry is used to measure network quality and detect
          regressions.

      --force-tty bool, $CODER_FORCE_TTY
          Force the use of a TTY.

      --global-config string, $CODER_CONFIG_DIR (default: /tmp/.config/coderv2)
          Path to the global `coder` config directory.

      --header string-array, $CODER_HEADER
          Additional HTTP headers added to all requests. Provide as key=value.
          Can be specified multiple times.

      --header-command string, $CODER_HEADER_COMMAND
          An external command that outputs additional HTTP headers added to all
          requests. The command must output each header as `key=value` on its
          own line.

      --no-feature-warning bool, $CODER_NO_FEATURE_WARNING
          Suppress warnings about unlicensed features.

      --no-version-warning bool, $CODER_NO_VERSION_WARNING
          Suppress warning when client and server versions do not match.

      --token string, $CODER_SESSION_TOKEN
          Specify an authentication token. For security reasons setting
          CODER_SESSION_TOKEN is preferred.

      --url url, $CODER_URL
          URL to a deployment.

      --use-keyring bool, $CODER_USE_KEYRING (default: true)
          Store and retrieve session tokens using the operating system keyring.
          This flag is ignored and file-based storage is used when
          --global-config is set or keyring usage is not supported on the
          current platform. Set to false to force file-based storage on
          supported platforms.

  -v, --verbose bool, $CODER_VERBOSE
          Enable verbose output.

———
Report bugs and request features at https://github.com/coder/coder/issues/new
Options (14)
OptionDescriptionSource
--client-tls-ca-file stringPath to a CA certificate file to trust for API and DERP connections.help
--client-tls-cert-file stringPath to a client certificate file for mTLS authentication with API and DERP.help
--client-tls-key-file stringPath to a client private key file for mTLS authentication with API and DERP.help
--debug-options boolPrint all options, how they're set, then exit.help
--disable-direct-connections boolDisable direct (P2P) connections to workspaces.help
--disable-network-telemetry boolDisable network telemetry.help
--force-tty boolForce the use of a TTY.help
--header string-arrayAdditional HTTP headers added to all requests.help
--header-command stringAn external command that outputs additional HTTP headers added to all requests.help
--no-feature-warning boolSuppress warnings about unlicensed features.help
--no-version-warning boolSuppress warning when client and server versions do not match.help
--token stringSpecify an authentication token.help
--url urlURL to a deployment.help
-v, --verbose boolEnable verbose output.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.