CLI for Divshot
- account - display basic account details
- account:redeem - redeem a voucher and credit it to your account
- apps - list your apps
- auth:token - print out your access token
- cert - upload an SSL certificate
- config - list, set, or remove keys and values from your app
- config:add - add a value to the config file
- config:remove - remove a value from the config file
- create - create a new app
- destroy - delete an app
- domains - list your domains
- domains:add - add a custom domain to your app
- domains:remove - remove a custom domain from your app
- emails - list emails associated with your app
- emails:add - add an email to your app
- emails:remove - remove an email from your app
- emails:resend - resend the confirmation email
- env - list environment variables for your app
- env:add - add an environment variable to your app
- env:config - configure your app's environment
- env:pull - copy environment data to your local environment
- files - list the current files associated with the given environment
- help - get help with common commands
- init - step by step guide to initiate an app in the current directory
- login - login to Divshot
- logout - logout from Divshot
- open - open the current app in your default browser
- production - show if current app has production status
- production:on - give the current app production status
- production:off - remove production status from the current app
- promote - promote one environment to another
- protect - add http basic auth to any environment
- pull - download the current files for a given environment into a directory
- push - deploy your app to the specified environment
- rename - change the name of an app
- rollback - rollback an environment to a previous release
- server - start server for local dev
- status - show release info for each environment
- unprotect - remove basic auth from an environment on your app
-h, --help
- show the help menu-v, --version
- show current version of Divshot CLI-t, --token [token]
- manually pass access token-a, --app [app name]
- manually supply an app name-c, --config [config]
- use a different config file--timeout [timeout]
- set the command timeout in milliseconds
development
- this is the default environment during app deploymentstaging
production
Each environment is immediately available and deployed at the following URL scheme: http://[environment].[app name].divshot.io. You may reference Divshot Builds and Environments for a more detailed explanation.
npm install divshot-cli -g
divshot account
Display your basic account details.
divshot account:redeem [voucher code]
Redeem a voucher and credit it to your account.
divshot apps
List your Divshot apps.
divshot auth:token
Print out your access token. This token is used to authenticate you with the Divshot API.
divshot config
List the keys and values from your Divshot app config file. See Divshot configuration reference for more details on these values.
divshot cert [path/to/certificate.crt] [path/to/key.key]
Upload your application's SSL certificate.
divshot config:add [key] [value]
Add a value to your Divshot app config file. See Divshot configuration reference for more details on these values.
divshot config:remove [key]
Remove a value from your Divshot app config file. See Divshot configuration reference for more details on these values.
divshot create [app name]
Create a new Divshot app. If no app name is provided, it attempts to read from your Divshot configuration file. It that does not exist, it will prompt you for an app name. You can easily create a new Divshot app locally and remotely by using divshot init
.
divshot destroy [app name]
Delete a Divshot app. This is permanent and immediate. It removes not only your files, but it disables the subdomain associated with the application.
divshot domains
See a list of all custom domains associated with your app. For more in-depth usage, see Divshot Custom Domains.
divshot domains:add [domain]
Add a custom domain to your app. You may see a list of your domains with divshot domains
. For more in-depth usage, see Divshot Custom Domains.
divshot domains:remove [domain]
Remove a custom domain from your app. You may see a list of your domains with divshot domains
. For more in-depth usage, see Divshot Custom Domains.
divshot emails
Show any emails associated with this app. Also shows which emails have been approved and which emails are pending authorization by the email owner.
divshot emails:add [email]
Add an email to the current app. Once added, the email will receive an email that the email owner must use to authorize the email address.
divshot emails:remove [email]
Remove an email from the current app.
divshot emails:resend [email]
Resend the the authorization email for the given email address.
divshot env [environment]
List the key/value pairs of environment variables associated with the given environment on the current app. See Environment Variables for more details.
divshot env:add [environment] KEY=value KEY2=value ...
Add environment variables to the current app. See Environment Variables for more details.
divshot env:config [environment] setting=value ...
Configure values in your application's environment. Possible and helpful values include:
force_ssl
- Force ssl on all requests to your app. Takes valuestrue
orfalse
.force_domain
- Force all requests to your app's production ready domains to redirect to the given domain. Takes the domain as the value
divshot env:pull [environment]
Copy environment data to your local environment. Creates a .env.json
file that is available to your app with __env.js
or __env.json
. See Environment Variables for more details.
divshot files [environment]
List the files currently associated with the given environment. These are the files that were deployed to Divshot using divshot push
divshot help
Get help with common Divshot commands. Lists all the available commands.
If you need help with a specific command, you may specify that command after the word help.
divshot help [command]
divshot init
Step by step guide to initiate an app in the current directory. The steps you are taken through are as follows:
name
- app nameroot
- the root directory of the app relative to the current directoryerror page
- the relative path or absolute url of an error/not found page to display in your appcreate app
- do you want to create a new app on Divshot upon completing these steps? (As opposed to only creating the app locally)
Once you initiated your app, the root directory will now contain a divshot.json
file with your settings. You may reference Divshot configuration reference for a more detailed description of this file.
divshot login
Login to your Divshot account.
divshot logout
Logout of your account.
divshot open [optional environment]
Open app in your default browser.
Example:
divshot open
- Opens the production, CDN environment of your appdivshot open development
- Opens up the development environment of your app
divshot production
Show if current app has production status. For more details on apps and production status see Production Mode Documenation
divshot production:on
Give the current app production status. For more details on apps and production status see Production Mode Documenation
divshot production:off
Remove production status from the current app. For more details on apps and production status see Production Mode Documenation
divshot promote [from env] [to env]
Promote one environment to another. A typical use case for this command would be to deploy your staging app to production without having to redeploy all the files. See environments for a list of available environments.
Example promotions
divshot promote development staging
- development -> stagingdivshot promote staging production
- staging -> production
divshot protect [environment] [username:password]
Protect your development and staging environments with http authentication.
divshot pull [environment] [optional directory]
Download all the files currently associated with the given environment. If no directory is provided, it defaults to the current directory. These files are the files deployed to Divshot using divshot push
divshot push [environment]
Deploy your app to the specified environment. If no environment is given, we assume that you mean production. The entire push process takes as long as the number of files in your project. Once deployed, your app is immediately available. See environments for a list of available environments.
divshot rename [new app name]
Rename your app. This changes the subdomain on Divshot and updates your configuration file. It is permanent once complete.
divshot rollback [environment]
Rollback the given environment to a previous release. This is useful when buggy code has been deployed. Divshot automatically detects and rolls back to your previous release. See environments for a list of available environments.
divshot server
Start a server for local development. This local server mimics the capabilities of static sites running on Divshot. Refer to the Divshot documentation for configuration instructions.
Server command options:
-p, --port [port]
- specify the port for the server to run. Defaults to 3474-h, --host [hostname]
- specify a custom hostname for your app to run at. Defaults to localhost
divshot status [environment]
Show release info for each environment. If no environment is specified, the latest release info will be listed for each environment. If an environment is specified, it will list the last few releases for that environment. See environments for a list of available environments.
divshot unprotect [environment]
Unprotect your development and staging environments and remove the authentication.