https://github.com/omgimanerd/doclt
Digital Ocean Command Line Tool
https://github.com/omgimanerd/doclt
cli cli-app cli-application digital-ocean digitalocean doclt
Last synced: 14 days ago
JSON representation
Digital Ocean Command Line Tool
- Host: GitHub
- URL: https://github.com/omgimanerd/doclt
- Owner: omgimanerd
- License: mit
- Created: 2017-01-05T15:28:01.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-09-13T19:29:57.000Z (over 6 years ago)
- Last Synced: 2025-04-20T07:23:29.119Z (28 days ago)
- Topics: cli, cli-app, cli-application, digital-ocean, digitalocean, doclt
- Language: JavaScript
- Homepage:
- Size: 455 KB
- Stars: 47
- Watchers: 2
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# doclt - Digital Ocean Command Line Tool
[](https://www.npmjs.com/package/doclt)
[](https://spdx.org/licenses/MIT)
[]([](https://www.npmjs.com/package/doclt))
[](https://github.com/omgimanerd/doclt/pulls)
[](https://github.com/omgimanerd/doclt/issues)
[](https://github.com/omgimanerd/doclt/watchers)
[](https://github.com/omgimanerd/doclt/fork)
doclt is a command line tool for interacting with Digital Ocean. It
presents information in Terminal in a neat, tidy, and visually appealing way.
## Installation
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.
## Examples
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 │
└──────────┴─────────────────────────────────┴──────────────┘
```
## Usage
Before using doclt, you must set your
[Digital Ocean auth token](https://cloud.digitalocean.com/settings/api/tokens).
Get one from Digital Ocean and run:
```
doclt token
# Example: doclt token abcdefghijk1234567890
```
Every command is documented by the tool itself. Run `doclt --help`
for details about using any command.
```
Usage:
doclt.js [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 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 --help' for more info.
```
## Contributing
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
```
## Creators
[](http://omgimanerd.tech)
[](https://twitter.com/omgimanerd)
[](https://github.com/omgimanerd)