Allows you to create a disposable Droplet with a simple CLI interface. This is useful for trying to run actions which may be network intensive to do on your standard internet connection or too CPU intensive for your system since you can start a Droplet to the size you need and then have it easily disposed of when you’re done.
The following sub-commands are included:
auth: Authenticates the user and creates the configuration if this doesn’t exist. This is the sub-command you will be prompted to run on first launch of this tool.
setregion: Allows you to modify the region. Note that you need to go through the setup with do-disposable auth first (that will also configure this for the first time).
setsize: Allows you to modify the Droplet size. Note that you need to go through the setup with do-disposable auth first (that will also configure this for the first time).
up: Allows you to start up a new disposable Droplet.
Additionally, when deploying the Droplet, the following commands are deployed to the Droplet:
copyfrom <host file/folder path> [droplet save location]: Allows you to copy a file/folder from the host to the Droplet.
copyback <droplet file/folder path> [host save location]: Allows you to copy a file/folder back from the Droplet.
You can find a binary for your operating system in the releases page.
On first boot, you should be logged in to DigitalOcean and then run
do-disposable auth. On the first boot, this will then walk through through the authentication, set region and set size configurations.
From here, you can simply start the droplet with
do-disposable up (see starting the droplet for help with this).
To change your SSH key/token after the first boot, you can run
do-disposable auth. When you run this, you will be prompted for your DigitalOcean token:
You can get this from the API section of the DigitalOcean dashboard:
This will also automatically generate/save the SSH key which do-disposable will use internally.
To set the region outside of the first boot, you can use
do-disposable setregion. This will prompt you to hit the key of the region which you wish to use:
To set the size outside of the first boot, you can use
do-disposable setsize. This will prompt you to hit the key of the size which you wish to use:
Starting The Droplet
To start the Droplet, you can use
do-disposable up. Note that by default,
up will use the default values from your configuration and the latest Debian release for your distro. The following flags can be used:
distro: Allows you to override the distro slug with another one from the DigitalOcean API. This defaults to the latest Debian release (e.g.:
region: Allows you to override the region slug with another one. Will default to the one set above (e.g.:
size: Allows you to override the size slug with another one. Will default to the one set above (e.g.:
To get slugs for different Droplet attributes, you can use this tool.
From here, you can run Linux commands (including
copyback) and then you can exit the Droplet. Exiting will destroy the Droplet: