doclt is a command line tool for interacting with Digital Ocean. It presents information in Terminal in a neat, tidy, and visually appealing way.
doclt is built with node.js and released on npm. It should work with any version of node.js above 4.3.2. Install it via npm.
npm install -g doclt
Simple as that.
If you want to build from source, you can clone this GitHub repository and create a symlink to doclt.js.
Listing droplets:
$ doclt droplets list --no-color
ββββββββββββββ¬βββββββββββββββ¬βββββββββββββββββ¬βββββββββ
β Droplet ID β Droplet Name β IPv4 β Status β
ββββββββββββββΌβββββββββββββββΌβββββββββββββββββΌβββββββββ€
β 13280097 β omgimanerd β 45.55.193.57 β active β
ββββββββββββββΌβββββββββββββββΌβββββββββββββββββΌβββββββββ€
β 32055059 β eccfinancing β 138.197.28.147 β active β
ββββββββββββββΌβββββββββββββββΌβββββββββββββββββΌβββββββββ€
β 37354192 β test β 198.199.67.203 β off β
ββββββββββββββ΄βββββββββββββββ΄βββββββββββββββββ΄βββββββββ
Listing image types:
$ doclt images list --distribution --no-color
ββββββββββββ¬ββββββββββββββββββββββββββββββββββ¬βββββββββββββββ
β ID β Distribution (PUBLIC) (PRIVATE) β Minimum Size β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 20625985 β CentOS 5.11 x32 β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 20625979 β CentOS 5.11 x64 β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 22236119 β CentOS 6.8 x32 β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 22099398 β CoreOS 1235.6.0 (stable) β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 22100001 β CoreOS 1248.4.0 (beta) β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 21419789 β Debian 7.11 x32 β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 21419458 β Debian 7.11 x64 β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 22235142 β Debian 8.7 x32 β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 22235108 β Debian 8.7 x64 β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 18027532 β Fedora 24 x64 β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 21190386 β Fedora 25 x64 β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 19103923 β FreeBSD 10.3 β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 18818640 β FreeBSD 10.3 zfs β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 20199958 β FreeBSD 11.0 β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 20199928 β FreeBSD 11.0 zfs β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 21399414 β Ubuntu 14.04.5 x32 β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 21399384 β Ubuntu 14.04.5 x64 β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 21669479 β Ubuntu 16.04.1 x32 β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 21669205 β Ubuntu 16.04.1 x64 β 20 GB β
ββββββββββββΌββββββββββββββββββββββββββββββββββΌβββββββββββββββ€
β 21385718 β Ubuntu 16.10 x32 β 20 GB β
ββββββββββββ΄ββββββββββββββββββββββββββββββββββ΄βββββββββββββββ
Before using doclt, you must set your Digital Ocean auth token. Get one from Digital Ocean and run:
doclt token <YOUR TOKEN HERE>
# Example: doclt token abcdefghijk1234567890
Every command is documented by the tool itself. Run doclt <command> --help
for details about using any command.
Usage:
doclt.js <command> [arguments..] [options..]
Commands:
account Display account information
[aliases: acc]
certificates Create, delete, and manage SSL certificates
[aliases: certificate, cert, certs]
domains Create, delete, and manage domains
[aliases: domain]
droplets Create, delete, and manage droplets
[aliases: droplet]
floating-ips Create, delete, and manage floating IPs
[aliases: floating-ip, fip, ip]
images Create, delete, and manage images
[aliases: image]
regions Lists the available regions
[aliases: region]
sizes Lists the available droplet sizes
[aliases: size]
snapshots Create, delete, and manage snapshots
[aliases: snapshot]
ssh Create, delete, and manage SSH public keys
tags Create, delete, and manage tags
[aliases: tag]
token <token> Set the DigitalOcean auth token
[aliases: auth, authenticate]
volumes Create, delete, and manage volumes
[aliases: volume, block, blockStorage]
Options:
--help Show help [boolean]
--dev Run in development mode [boolean]
--json Output results as JSON [boolean]
--no-color Disable colors [boolean]
--color Invoking this does nothing [boolean]
--version Show version number [boolean]
See 'doclt.js <command> --help' for more info.
Open issues to discuss any feature requests or changes that you would like to make. Fork this repository and push changes to your own fork. Then send me a pull request.
git clone [email protected]/your-username/doclt
cd doclt
git checkout -b feature-name
# Make changes
git commit
git push origin feature-name
After the pull request is accepted, you can fetch those changes back to your master branch.
git remote add upstream [email protected]:omgimanerd/doclt
git pull upstream master