doctl apps logs

Go to Navigation


doctl apps logs <app id> <component name (defaults to all components)> [flags]




Retrieves component logs for a deployment of an app.

Three types of logs are supported and can be specified with the –type flag:

  • build
  • deploy
  • run

For more information about logs, see How to View Logs.


The following example retrieves the build logs for the app with the ID f81d4fae-7dec-11d0-a765-00a0c91e6bf6 and the component web:

doctl apps logs f81d4fae-7dec-11d0-a765-00a0c91e6bf6 web --type build


Option Description
--deployment Retrieves logs for a specific deployment ID. Defaults to current deployment.
--follow , -f Returns logs as they are emitted by the app.
Default: false
--help , -h Help for this command
--tail Specifies the number of lines to show from the end of the log.
Default: -1
--type Retrieves logs for a specific log type. Defaults to run logs.
Default: run
Command Description
doctl apps Displays commands for working with apps

Global Flags

Option Description
--access-token, -t API V2 access token
--api-url, -u Override default API endpoint
--config, -c Specify a custom config file
  • macOS: ${HOME}/Library/Application Support/doctl/config.yaml
  • Linux: ${XDG_CONFIG_HOME}/doctl/config.yaml
  • Windows: %APPDATA%\doctl\config.yaml
--context Specify a custom authentication context name
--http-retry-max Set maximum number of retries for requests that fail with a 429 or 500-level error
Default: 5
--http-retry-wait-max Set the minimum number of seconds to wait before retrying a failed request
Default: 30
--http-retry-wait-min Set the maximum number of seconds to wait before retrying a failed request
Default: 1
--interactive Enable interactive behavior. Defaults to true if the terminal supports it (default false)
Default: false
--output, -o Desired output format [text|json]
Default: text
--trace Show a log of network activity while performing a command
Default: false
--verbose, -v Enable verbose output
Default: false