PowerDown CLI

The PowerDown CLI provides an alternate command line interface for interacting with the PowerDown service.

The PowerDown CLI is in beta release and supports the following functionality:

CLI Snapshot


Prebuilt binaries for Linux, macOS and Windows are provided as part of each release. The packages are simple ZIP archives containing a single "fat" binary for CLI. To download, please see the release on GitHub and then download the appropriate package.


power [switches] CMD ACTIONS ARGS ...


-h, --help
-n, --no-header
-p, --prefix PREFIX
-t, --token
-T, --token-arg TOKEN
-V, --version



Resources are server instances, databases, Auto Scale groups and PowerDown logical resource groups.


To use the PowerDown CLI, you must first initialize the CLI with a valid, current PowerDown API token.

Create Token

Tokens are generated users via the PowerDown app. Tokens can have an expiry and multiple tokens can be active at any one time for a user.

Tokens are 35 character random values. For example:


To initialize the CLI, run the init command and power will prompt for the token. To erase the token, run:

power deinit

You can override the stored token by using the --token-arg or --token command line options. It is not recommended to use --token-arg as command lines are often logged by web servers and proxies.

Resource Names

Commands use resource names and match resources based on the supplied name. The name is used to match either:

The match will be successful only if the search pattern matches exactly one resource.


List Resources

To list the set of resources for your teams:

power list

This will display a table of current resources with the resource short name, tag, state and desired state. For example:

Name                                   Tag                       State   Desired
stage                                  stage                     off     off
test                                   test                      off     off
example/autoscale/prod-rocket-app      prod-rocket-app           on      -
example/server/i-0f8c46fc83164a542     trial-server              off     -
example/autoscale/EC2ContainerServi    ECS Instance - EC2Contai  off     -
example/service/fargate-nginx          fargate-nginx             off     -

Using the -v will display additional columns including the resource ID, machine type, cloud provider charge rate, and the cloud region.

Powering Up Resources

The up action will power up a resource for a period of time.

power up 4hr Name       ;# power up for 4 hours
power up 10m Name       ;# power up for 10 minutes
power up 2d Name        ;# power up for 2 days

There is an alternate form that specifies an end time instead of a duration:

power up Name till 7:00pm

The following end time formats are supported:


Powering Down Resources

You can power down a resource if no other user is currently requiring the resource to be powered up.

power down Name

Show Resource Status

To display the status of a resource:

power status test

Example output:

Name:     test
Type:     group
Id:       12953
State:    off
Desired:  off
End:      forever
Tag:      test
Rate:     $0.0402 per hour
Service:  powerdown
Region:   global

Building the CLI

See Also

© SenseDeep® LLC. All rights reserved. Privacy Policy and Terms of Use.


This web site uses cookies to provide you with a better viewing experience. Without cookies, you will not be able to view videos, contact chat or use other site features. By continuing, you are giving your consent to cookies being used.