mirror of
https://github.com/coder/coder.git
synced 2026-09-24 15:04:27 +08:00
docs: move api and cli docs routes to reference/ (#14241)
This commit is contained in:
Muhammad Atif Ali
Generated
+168
@@ -0,0 +1,168 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# coder
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder [global-flags] <subcommand>
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
Coder — A tool for provisioning self-hosted development environments with Terraform.
|
||||
- Start a Coder server:
|
||||
|
||||
$ coder server
|
||||
|
||||
- Get started by creating a template from an example:
|
||||
|
||||
$ coder templates init
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
|
||||
| [<code>dotfiles</code>](./dotfiles.md) | Personalize your workspace by applying a canonical dotfiles repository |
|
||||
| [<code>external-auth</code>](./external-auth.md) | Manage external authentication |
|
||||
| [<code>login</code>](./login.md) | Authenticate with Coder deployment |
|
||||
| [<code>logout</code>](./logout.md) | Unauthenticate your local session |
|
||||
| [<code>netcheck</code>](./netcheck.md) | Print network debug information for DERP and STUN |
|
||||
| [<code>notifications</code>](./notifications.md) | Manage Coder notifications |
|
||||
| [<code>port-forward</code>](./port-forward.md) | Forward ports from a workspace to the local machine. For reverse port forwarding, use "coder ssh -R". |
|
||||
| [<code>publickey</code>](./publickey.md) | Output your Coder public key used for Git operations |
|
||||
| [<code>reset-password</code>](./reset-password.md) | Directly connect to the database to reset a user's password |
|
||||
| [<code>state</code>](./state.md) | Manually manage Terraform state to fix broken workspaces |
|
||||
| [<code>templates</code>](./templates.md) | Manage templates |
|
||||
| [<code>tokens</code>](./tokens.md) | Manage personal access tokens |
|
||||
| [<code>users</code>](./users.md) | Manage users |
|
||||
| [<code>version</code>](./version.md) | Show coder version |
|
||||
| [<code>autoupdate</code>](./autoupdate.md) | Toggle auto-update policy for a workspace |
|
||||
| [<code>config-ssh</code>](./config-ssh.md) | Add an SSH Host entry for your workspaces "ssh coder.workspace" |
|
||||
| [<code>create</code>](./create.md) | Create a workspace |
|
||||
| [<code>delete</code>](./delete.md) | Delete a workspace |
|
||||
| [<code>favorite</code>](./favorite.md) | Add a workspace to your favorites |
|
||||
| [<code>list</code>](./list.md) | List workspaces |
|
||||
| [<code>open</code>](./open.md) | Open a workspace |
|
||||
| [<code>ping</code>](./ping.md) | Ping a workspace |
|
||||
| [<code>rename</code>](./rename.md) | Rename a workspace |
|
||||
| [<code>restart</code>](./restart.md) | Restart a workspace |
|
||||
| [<code>schedule</code>](./schedule.md) | Schedule automated start and stop times for workspaces |
|
||||
| [<code>show</code>](./show.md) | Display details of a workspace's resources and agents |
|
||||
| [<code>speedtest</code>](./speedtest.md) | Run upload and download tests from your machine to a workspace |
|
||||
| [<code>ssh</code>](./ssh.md) | Start a shell into a workspace |
|
||||
| [<code>start</code>](./start.md) | Start a workspace |
|
||||
| [<code>stat</code>](./stat.md) | Show resource usage for the current workspace. |
|
||||
| [<code>stop</code>](./stop.md) | Stop a workspace |
|
||||
| [<code>unfavorite</code>](./unfavorite.md) | Remove a workspace from your favorites |
|
||||
| [<code>update</code>](./update.md) | Will update and start a given workspace if it is out of date |
|
||||
| [<code>whoami</code>](./whoami.md) | Fetch authenticated user info for Coder deployment |
|
||||
| [<code>support</code>](./support.md) | Commands for troubleshooting issues with a Coder deployment. |
|
||||
| [<code>server</code>](./server.md) | Start a Coder server |
|
||||
| [<code>features</code>](./features.md) | List Enterprise features |
|
||||
| [<code>licenses</code>](./licenses.md) | Add, delete, and list licenses |
|
||||
| [<code>groups</code>](./groups.md) | Manage groups |
|
||||
| [<code>provisionerd</code>](./provisionerd.md) | Manage provisioner daemons |
|
||||
|
||||
## Options
|
||||
|
||||
### --url
|
||||
|
||||
| | |
|
||||
| ----------- | ----------------------- |
|
||||
| Type | <code>url</code> |
|
||||
| Environment | <code>$CODER_URL</code> |
|
||||
|
||||
URL to a deployment.
|
||||
|
||||
### --debug-options
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Print all options, how they're set, then exit.
|
||||
|
||||
### --token
|
||||
|
||||
| | |
|
||||
| ----------- | --------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_SESSION_TOKEN</code> |
|
||||
|
||||
Specify an authentication token. For security reasons setting CODER_SESSION_TOKEN is preferred.
|
||||
|
||||
### --no-version-warning
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_NO_VERSION_WARNING</code> |
|
||||
|
||||
Suppress warning when client and server versions do not match.
|
||||
|
||||
### --no-feature-warning
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_NO_FEATURE_WARNING</code> |
|
||||
|
||||
Suppress warnings about unlicensed features.
|
||||
|
||||
### --header
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_HEADER</code> |
|
||||
|
||||
Additional HTTP headers added to all requests. Provide as key=value. Can be specified multiple times.
|
||||
|
||||
### --header-command
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_HEADER_COMMAND</code> |
|
||||
|
||||
An external command that outputs additional HTTP headers added to all requests. The command must output each header as `key=value` on its own line.
|
||||
|
||||
### -v, --verbose
|
||||
|
||||
| | |
|
||||
| ----------- | --------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_VERBOSE</code> |
|
||||
|
||||
Enable verbose output.
|
||||
|
||||
### --disable-direct-connections
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_DISABLE_DIRECT_CONNECTIONS</code> |
|
||||
|
||||
Disable direct (P2P) connections to workspaces.
|
||||
|
||||
### --disable-network-telemetry
|
||||
|
||||
| | |
|
||||
| ----------- | --------------------------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_DISABLE_NETWORK_TELEMETRY</code> |
|
||||
|
||||
Disable network telemetry. Network telemetry is collected when connecting to workspaces using the CLI, and is forwarded to the server. If telemetry is also enabled on the server, it may be sent to Coder. Network telemetry is used to measure network quality and detect regressions.
|
||||
|
||||
### --global-config
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------ |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_CONFIG_DIR</code> |
|
||||
| Default | <code>~/.config/coderv2</code> |
|
||||
|
||||
Path to the global `coder` config directory.
|
||||
Generated
+21
@@ -0,0 +1,21 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# autoupdate
|
||||
|
||||
Toggle auto-update policy for a workspace
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder autoupdate [flags] <workspace> <always|never>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
Generated
+109
@@ -0,0 +1,109 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# config-ssh
|
||||
|
||||
Add an SSH Host entry for your workspaces "ssh coder.workspace"
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder config-ssh [flags]
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
- You can use -o (or --ssh-option) so set SSH options to be used for all your
|
||||
workspaces:
|
||||
|
||||
$ coder config-ssh -o ForwardAgent=yes
|
||||
|
||||
- You can use --dry-run (or -n) to see the changes that would be made:
|
||||
|
||||
$ coder config-ssh --dry-run
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --ssh-config-file
|
||||
|
||||
| | |
|
||||
| ----------- | ----------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_SSH_CONFIG_FILE</code> |
|
||||
| Default | <code>~/.ssh/config</code> |
|
||||
|
||||
Specifies the path to an SSH config.
|
||||
|
||||
### --coder-binary-path
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------------ |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_SSH_CONFIG_BINARY_PATH</code> |
|
||||
|
||||
Optionally specify the absolute path to the coder binary used in ProxyCommand. By default, the binary invoking this command ('config ssh') is used.
|
||||
|
||||
### -o, --ssh-option
|
||||
|
||||
| | |
|
||||
| ----------- | ----------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_SSH_CONFIG_OPTS</code> |
|
||||
|
||||
Specifies additional SSH options to embed in each host stanza.
|
||||
|
||||
### -n, --dry-run
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_SSH_DRY_RUN</code> |
|
||||
|
||||
Perform a trial run with no changes made, showing a diff at the end.
|
||||
|
||||
### --use-previous-options
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_SSH_USE_PREVIOUS_OPTIONS</code> |
|
||||
|
||||
Specifies whether or not to keep options from previous run of config-ssh.
|
||||
|
||||
### --ssh-host-prefix
|
||||
|
||||
| | |
|
||||
| ----------- | --------------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_CONFIGSSH_SSH_HOST_PREFIX</code> |
|
||||
|
||||
Override the default host prefix.
|
||||
|
||||
### --wait
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------- |
|
||||
| Type | <code>enum[yes\|no\|auto]</code> |
|
||||
| Environment | <code>$CODER_CONFIGSSH_WAIT</code> |
|
||||
| Default | <code>auto</code> |
|
||||
|
||||
Specifies whether or not to wait for the startup script to finish executing. Auto means that the agent startup script behavior configured in the workspace template is used.
|
||||
|
||||
### --disable-autostart
|
||||
|
||||
| | |
|
||||
| ----------- | ----------------------------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_CONFIGSSH_DISABLE_AUTOSTART</code> |
|
||||
| Default | <code>false</code> |
|
||||
|
||||
Disable starting the workspace automatically when connecting via SSH.
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
Generated
+111
@@ -0,0 +1,111 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# create
|
||||
|
||||
Create a workspace
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder create [flags] [name]
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
- Create a workspace for another user (if you have permission):
|
||||
|
||||
$ coder create <username>/<workspace_name>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -t, --template
|
||||
|
||||
| | |
|
||||
| ----------- | --------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_TEMPLATE_NAME</code> |
|
||||
|
||||
Specify a template name.
|
||||
|
||||
### --start-at
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_WORKSPACE_START_AT</code> |
|
||||
|
||||
Specify the workspace autostart schedule. Check coder schedule start --help for the syntax.
|
||||
|
||||
### --stop-after
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
| Environment | <code>$CODER_WORKSPACE_STOP_AFTER</code> |
|
||||
|
||||
Specify a duration after which the workspace should shut down (e.g. 8h).
|
||||
|
||||
### --automatic-updates
|
||||
|
||||
| | |
|
||||
| ----------- | ----------------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_WORKSPACE_AUTOMATIC_UPDATES</code> |
|
||||
| Default | <code>never</code> |
|
||||
|
||||
Specify automatic updates setting for the workspace (accepts 'always' or 'never').
|
||||
|
||||
### --copy-parameters-from
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_WORKSPACE_COPY_PARAMETERS_FROM</code> |
|
||||
|
||||
Specify the source workspace name to copy parameters from.
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
|
||||
### --parameter
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_RICH_PARAMETER</code> |
|
||||
|
||||
Rich parameter value in the format "name=value".
|
||||
|
||||
### --rich-parameter-file
|
||||
|
||||
| | |
|
||||
| ----------- | --------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_RICH_PARAMETER_FILE</code> |
|
||||
|
||||
Specify a file path with values for rich parameters defined in the template.
|
||||
|
||||
### --parameter-default
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------------ |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_RICH_PARAMETER_DEFAULT</code> |
|
||||
|
||||
Rich parameter default values in the format "name=value".
|
||||
|
||||
### -O, --org
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_ORGANIZATION</code> |
|
||||
|
||||
Select which organization (uuid or name) to use.
|
||||
Generated
+33
@@ -0,0 +1,33 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# delete
|
||||
|
||||
Delete a workspace
|
||||
|
||||
Aliases:
|
||||
|
||||
- rm
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder delete [flags] <workspace>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --orphan
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Delete a workspace without deleting its resources. This can delete a workspace in a broken state, but may also lead to unaccounted cloud resources.
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
Generated
+56
@@ -0,0 +1,56 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# dotfiles
|
||||
|
||||
Personalize your workspace by applying a canonical dotfiles repository
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder dotfiles [flags] <git_repo_url>
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
- Check out and install a dotfiles repository without prompts:
|
||||
|
||||
$ coder dotfiles --yes git@github.com:example/dotfiles.git
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --symlink-dir
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_SYMLINK_DIR</code> |
|
||||
|
||||
Specifies the directory for the dotfiles symlink destinations. If empty, will use $HOME.
|
||||
|
||||
### -b, --branch
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Specifies which branch to clone. If empty, will default to cloning the default branch or using the existing branch in the cloned repo on disk.
|
||||
|
||||
### --repo-dir
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_DOTFILES_REPO_DIR</code> |
|
||||
| Default | <code>dotfiles</code> |
|
||||
|
||||
Specifies the directory for the dotfiles repository, relative to global config directory.
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
Generated
+23
@@ -0,0 +1,23 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# external-auth
|
||||
|
||||
Manage external authentication
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder external-auth
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
Authenticate with external services inside of a workspace.
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| ------------------------------------------------------------ | ----------------------------------- |
|
||||
| [<code>access-token</code>](./external-auth_access-token.md) | Print auth for an external provider |
|
||||
+43
@@ -0,0 +1,43 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# external-auth access-token
|
||||
|
||||
Print auth for an external provider
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder external-auth access-token [flags] <provider>
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
Print an access-token for an external auth provider. The access-token will be validated and sent to stdout with exit code 0. If a valid access-token cannot be obtained, the URL to authenticate will be sent to stdout with exit code 1
|
||||
- Ensure that the user is authenticated with GitHub before cloning.:
|
||||
|
||||
$ #!/usr/bin/env sh
|
||||
|
||||
OUTPUT=$(coder external-auth access-token github)
|
||||
if [ $? -eq 0 ]; then
|
||||
echo "Authenticated with GitHub"
|
||||
else
|
||||
echo "Please authenticate with GitHub:"
|
||||
echo $OUTPUT
|
||||
fi
|
||||
|
||||
|
||||
- Obtain an extra property of an access token for additional metadata.:
|
||||
|
||||
$ coder external-auth access-token slack --extra "authed_user.id"
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --extra
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Extract a field from the "extra" properties of the OAuth token.
|
||||
Generated
+16
@@ -0,0 +1,16 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# favorite
|
||||
|
||||
Add a workspace to your favorites
|
||||
|
||||
Aliases:
|
||||
|
||||
- fav
|
||||
- favourite
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder favorite <workspace>
|
||||
```
|
||||
Generated
+21
@@ -0,0 +1,21 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# features
|
||||
|
||||
List Enterprise features
|
||||
|
||||
Aliases:
|
||||
|
||||
- feature
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder features
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| --------------------------------------- | ------- |
|
||||
| [<code>list</code>](./features_list.md) | |
|
||||
Generated
+33
@@ -0,0 +1,33 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# features list
|
||||
|
||||
Aliases:
|
||||
|
||||
- ls
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder features list [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -c, --column
|
||||
|
||||
| | |
|
||||
| ------- | -------------------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Default | <code>Name,Entitlement,Enabled,Limit,Actual</code> |
|
||||
|
||||
Specify a column to filter in the table. Available columns are: Name, Entitlement, Enabled, Limit, Actual.
|
||||
|
||||
### -o, --output
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>table</code> |
|
||||
|
||||
Output format. Available formats are: table, json.
|
||||
Generated
+24
@@ -0,0 +1,24 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# groups
|
||||
|
||||
Manage groups
|
||||
|
||||
Aliases:
|
||||
|
||||
- group
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder groups
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| ----------------------------------------- | ------------------- |
|
||||
| [<code>create</code>](./groups_create.md) | Create a user group |
|
||||
| [<code>list</code>](./groups_list.md) | List user groups |
|
||||
| [<code>edit</code>](./groups_edit.md) | Edit a user group |
|
||||
| [<code>delete</code>](./groups_delete.md) | Delete a user group |
|
||||
Generated
+40
@@ -0,0 +1,40 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# groups create
|
||||
|
||||
Create a user group
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder groups create [flags] <name>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -u, --avatar-url
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------ |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_AVATAR_URL</code> |
|
||||
|
||||
Set an avatar for a group.
|
||||
|
||||
### --display-name
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_DISPLAY_NAME</code> |
|
||||
|
||||
Optional human friendly name for the group.
|
||||
|
||||
### -O, --org
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_ORGANIZATION</code> |
|
||||
|
||||
Select which organization (uuid or name) to use.
|
||||
Generated
+26
@@ -0,0 +1,26 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# groups delete
|
||||
|
||||
Delete a user group
|
||||
|
||||
Aliases:
|
||||
|
||||
- rm
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder groups delete [flags] <name>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -O, --org
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_ORGANIZATION</code> |
|
||||
|
||||
Select which organization (uuid or name) to use.
|
||||
Generated
+63
@@ -0,0 +1,63 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# groups edit
|
||||
|
||||
Edit a user group
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder groups edit [flags] <name>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -n, --name
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Update the group name.
|
||||
|
||||
### -u, --avatar-url
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Update the group avatar.
|
||||
|
||||
### --display-name
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_DISPLAY_NAME</code> |
|
||||
|
||||
Optional human friendly name for the group.
|
||||
|
||||
### -a, --add-users
|
||||
|
||||
| | |
|
||||
| ---- | ------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
|
||||
Add users to the group. Accepts emails or IDs.
|
||||
|
||||
### -r, --rm-users
|
||||
|
||||
| | |
|
||||
| ---- | ------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
|
||||
Remove users to the group. Accepts emails or IDs.
|
||||
|
||||
### -O, --org
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_ORGANIZATION</code> |
|
||||
|
||||
Select which organization (uuid or name) to use.
|
||||
Generated
+40
@@ -0,0 +1,40 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# groups list
|
||||
|
||||
List user groups
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder groups list [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -c, --column
|
||||
|
||||
| | |
|
||||
| ------- | ----------------------------------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Default | <code>name,display name,organization id,members,avatar url</code> |
|
||||
|
||||
Columns to display in table output. Available columns: name, display name, organization id, members, avatar url.
|
||||
|
||||
### -o, --output
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>table</code> |
|
||||
|
||||
Output format. Available formats: table, json.
|
||||
|
||||
### -O, --org
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_ORGANIZATION</code> |
|
||||
|
||||
Select which organization (uuid or name) to use.
|
||||
Generated
+23
@@ -0,0 +1,23 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# licenses
|
||||
|
||||
Add, delete, and list licenses
|
||||
|
||||
Aliases:
|
||||
|
||||
- license
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder licenses
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| ------------------------------------------- | --------------------------------- |
|
||||
| [<code>add</code>](./licenses_add.md) | Add license to Coder deployment |
|
||||
| [<code>list</code>](./licenses_list.md) | List licenses (including expired) |
|
||||
| [<code>delete</code>](./licenses_delete.md) | Delete license by ID |
|
||||
Generated
+37
@@ -0,0 +1,37 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# licenses add
|
||||
|
||||
Add license to Coder deployment
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder licenses add [flags] [-f file | -l license]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -f, --file
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Load license from file.
|
||||
|
||||
### -l, --license
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
License string.
|
||||
|
||||
### --debug
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Output license claims for debugging.
|
||||
Generated
+16
@@ -0,0 +1,16 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# licenses delete
|
||||
|
||||
Delete license by ID
|
||||
|
||||
Aliases:
|
||||
|
||||
- del
|
||||
- rm
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder licenses delete <id>
|
||||
```
|
||||
Generated
+35
@@ -0,0 +1,35 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# licenses list
|
||||
|
||||
List licenses (including expired)
|
||||
|
||||
Aliases:
|
||||
|
||||
- ls
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder licenses list [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -c, --column
|
||||
|
||||
| | |
|
||||
| ------- | ---------------------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Default | <code>ID,UUID,Expires At,Uploaded At,Features</code> |
|
||||
|
||||
Columns to display in table output. Available columns: id, uuid, uploaded at, features, expires at, trial.
|
||||
|
||||
### -o, --output
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>table</code> |
|
||||
|
||||
Output format. Available formats: table, json.
|
||||
Generated
+52
@@ -0,0 +1,52 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# list
|
||||
|
||||
List workspaces
|
||||
|
||||
Aliases:
|
||||
|
||||
- ls
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder list [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -a, --all
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Specifies whether all workspaces will be listed or not.
|
||||
|
||||
### --search
|
||||
|
||||
| | |
|
||||
| ------- | --------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>owner:me</code> |
|
||||
|
||||
Search for a workspace with a query.
|
||||
|
||||
### -c, --column
|
||||
|
||||
| | |
|
||||
| ------- | -------------------------------------------------------------------------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Default | <code>workspace,template,status,healthy,last built,current version,outdated,starts at,stops after</code> |
|
||||
|
||||
Columns to display in table output. Available columns: favorite, workspace, organization id, organization name, template, status, healthy, last built, current version, outdated, starts at, starts next, stops after, stops next, daily cost.
|
||||
|
||||
### -o, --output
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>table</code> |
|
||||
|
||||
Output format. Available formats: table, json.
|
||||
Generated
+66
@@ -0,0 +1,66 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# login
|
||||
|
||||
Authenticate with Coder deployment
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder login [flags] [<url>]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --first-user-email
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------ |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_FIRST_USER_EMAIL</code> |
|
||||
|
||||
Specifies an email address to use if creating the first user for the deployment.
|
||||
|
||||
### --first-user-username
|
||||
|
||||
| | |
|
||||
| ----------- | --------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_FIRST_USER_USERNAME</code> |
|
||||
|
||||
Specifies a username to use if creating the first user for the deployment.
|
||||
|
||||
### --first-user-full-name
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_FIRST_USER_FULL_NAME</code> |
|
||||
|
||||
Specifies a human-readable name for the first user of the deployment.
|
||||
|
||||
### --first-user-password
|
||||
|
||||
| | |
|
||||
| ----------- | --------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_FIRST_USER_PASSWORD</code> |
|
||||
|
||||
Specifies a password to use if creating the first user for the deployment.
|
||||
|
||||
### --first-user-trial
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------ |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_FIRST_USER_TRIAL</code> |
|
||||
|
||||
Specifies whether a trial license should be provisioned for the Coder deployment or not.
|
||||
|
||||
### --use-token-as-session
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
By default, the CLI will generate a new session token when logging in. This flag will instead use the provided token as the session token.
|
||||
Generated
+21
@@ -0,0 +1,21 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# logout
|
||||
|
||||
Unauthenticate your local session
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder logout [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
Generated
+11
@@ -0,0 +1,11 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# netcheck
|
||||
|
||||
Print network debug information for DERP and STUN
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder netcheck
|
||||
```
|
||||
Generated
+37
@@ -0,0 +1,37 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# notifications
|
||||
|
||||
Manage Coder notifications
|
||||
|
||||
Aliases:
|
||||
|
||||
- notification
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder notifications
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
Administrators can use these commands to change notification settings.
|
||||
- Pause Coder notifications. Administrators can temporarily stop notifiers from
|
||||
dispatching messages in case of the target outage (for example: unavailable SMTP
|
||||
server or Webhook not responding).:
|
||||
|
||||
$ coder notifications pause
|
||||
|
||||
- Resume Coder notifications:
|
||||
|
||||
$ coder notifications resume
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| ------------------------------------------------ | -------------------- |
|
||||
| [<code>pause</code>](./notifications_pause.md) | Pause notifications |
|
||||
| [<code>resume</code>](./notifications_resume.md) | Resume notifications |
|
||||
+11
@@ -0,0 +1,11 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# notifications pause
|
||||
|
||||
Pause notifications
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder notifications pause
|
||||
```
|
||||
+11
@@ -0,0 +1,11 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# notifications resume
|
||||
|
||||
Resume notifications
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder notifications resume
|
||||
```
|
||||
Generated
+17
@@ -0,0 +1,17 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# open
|
||||
|
||||
Open a workspace
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder open
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| --------------------------------------- | ----------------------------------- |
|
||||
| [<code>vscode</code>](./open_vscode.md) | Open a workspace in VS Code Desktop |
|
||||
Generated
+22
@@ -0,0 +1,22 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# open vscode
|
||||
|
||||
Open a workspace in VS Code Desktop
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder open vscode [flags] <workspace> [<directory in workspace>]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --generate-token
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_OPEN_VSCODE_GENERATE_TOKEN</code> |
|
||||
|
||||
Generate an auth token and include it in the vscode:// URI. This is for automagical configuration of VS Code Desktop and not needed if already configured. This flag does not need to be specified when running this command on a local machine unless automatic open fails.
|
||||
Generated
+40
@@ -0,0 +1,40 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# ping
|
||||
|
||||
Ping a workspace
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder ping [flags] <workspace>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --wait
|
||||
|
||||
| | |
|
||||
| ------- | --------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
| Default | <code>1s</code> |
|
||||
|
||||
Specifies how long to wait between pings.
|
||||
|
||||
### -t, --timeout
|
||||
|
||||
| | |
|
||||
| ------- | --------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
| Default | <code>5s</code> |
|
||||
|
||||
Specifies how long to wait for a ping to complete.
|
||||
|
||||
### -n, --num
|
||||
|
||||
| | |
|
||||
| ------- | ---------------- |
|
||||
| Type | <code>int</code> |
|
||||
| Default | <code>10</code> |
|
||||
|
||||
Specifies the number of pings to perform.
|
||||
Generated
+71
@@ -0,0 +1,71 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# port-forward
|
||||
|
||||
Forward ports from a workspace to the local machine. For reverse port forwarding, use "coder ssh -R".
|
||||
|
||||
Aliases:
|
||||
|
||||
- tunnel
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder port-forward [flags] <workspace>
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
- Port forward a single TCP port from 1234 in the workspace to port 5678 on your
|
||||
local machine:
|
||||
|
||||
$ coder port-forward <workspace> --tcp 5678:1234
|
||||
|
||||
- Port forward a single UDP port from port 9000 to port 9000 on your local
|
||||
machine:
|
||||
|
||||
$ coder port-forward <workspace> --udp 9000
|
||||
|
||||
- Port forward multiple TCP ports and a UDP port:
|
||||
|
||||
$ coder port-forward <workspace> --tcp 8080:8080 --tcp 9000:3000 --udp 5353:53
|
||||
|
||||
- Port forward multiple ports (TCP or UDP) in condensed syntax:
|
||||
|
||||
$ coder port-forward <workspace> --tcp 8080,9000:3000,9090-9092,10000-10002:10010-10012
|
||||
|
||||
- Port forward specifying the local address to bind to:
|
||||
|
||||
$ coder port-forward <workspace> --tcp 1.2.3.4:8080:8080
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -p, --tcp
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------ |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_PORT_FORWARD_TCP</code> |
|
||||
|
||||
Forward TCP port(s) from the workspace to the local machine.
|
||||
|
||||
### --udp
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------ |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_PORT_FORWARD_UDP</code> |
|
||||
|
||||
Forward UDP port(s) from the workspace to the local machine. The UDP connection has TCP-like semantics to support stateful UDP protocols.
|
||||
|
||||
### --disable-autostart
|
||||
|
||||
| | |
|
||||
| ----------- | ----------------------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_SSH_DISABLE_AUTOSTART</code> |
|
||||
| Default | <code>false</code> |
|
||||
|
||||
Disable starting the workspace automatically when connecting via SSH.
|
||||
Generated
+21
@@ -0,0 +1,21 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# provisionerd
|
||||
|
||||
Manage provisioner daemons
|
||||
|
||||
Aliases:
|
||||
|
||||
- provisioner
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder provisionerd
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| --------------------------------------------- | ------------------------ |
|
||||
| [<code>start</code>](./provisionerd_start.md) | Run a provisioner daemon |
|
||||
Generated
+146
@@ -0,0 +1,146 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# provisionerd start
|
||||
|
||||
Run a provisioner daemon
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder provisionerd start [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -c, --cache-dir
|
||||
|
||||
| | |
|
||||
| ----------- | ----------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_CACHE_DIRECTORY</code> |
|
||||
| Default | <code>~/.cache/coder</code> |
|
||||
|
||||
Directory to store cached data.
|
||||
|
||||
### -t, --tag
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_PROVISIONERD_TAGS</code> |
|
||||
|
||||
Tags to filter provisioner jobs by.
|
||||
|
||||
### --poll-interval
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
| Environment | <code>$CODER_PROVISIONERD_POLL_INTERVAL</code> |
|
||||
| Default | <code>1s</code> |
|
||||
|
||||
Deprecated and ignored.
|
||||
|
||||
### --poll-jitter
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
| Environment | <code>$CODER_PROVISIONERD_POLL_JITTER</code> |
|
||||
| Default | <code>100ms</code> |
|
||||
|
||||
Deprecated and ignored.
|
||||
|
||||
### --psk
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------------ |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_PROVISIONER_DAEMON_PSK</code> |
|
||||
|
||||
Pre-shared key to authenticate with Coder server.
|
||||
|
||||
### --name
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_PROVISIONER_DAEMON_NAME</code> |
|
||||
|
||||
Name of this provisioner daemon. Defaults to the current hostname without FQDN.
|
||||
|
||||
### --verbose
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_PROVISIONER_DAEMON_VERBOSE</code> |
|
||||
| Default | <code>false</code> |
|
||||
|
||||
Output debug-level logs.
|
||||
|
||||
### --log-human
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_PROVISIONER_DAEMON_LOGGING_HUMAN</code> |
|
||||
| Default | <code>/dev/stderr</code> |
|
||||
|
||||
Output human-readable logs to a given file.
|
||||
|
||||
### --log-json
|
||||
|
||||
| | |
|
||||
| ----------- | --------------------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_PROVISIONER_DAEMON_LOGGING_JSON</code> |
|
||||
|
||||
Output JSON logs to a given file.
|
||||
|
||||
### --log-stackdriver
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_PROVISIONER_DAEMON_LOGGING_STACKDRIVER</code> |
|
||||
|
||||
Output Stackdriver compatible logs to a given file.
|
||||
|
||||
### --log-filter
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_PROVISIONER_DAEMON_LOG_FILTER</code> |
|
||||
|
||||
Filter debug logs by matching against a given regex. Use .\* to match all debug logs.
|
||||
|
||||
### --prometheus-enable
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_PROMETHEUS_ENABLE</code> |
|
||||
| Default | <code>false</code> |
|
||||
|
||||
Serve prometheus metrics on the address defined by prometheus address.
|
||||
|
||||
### --prometheus-address
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_PROMETHEUS_ADDRESS</code> |
|
||||
| Default | <code>127.0.0.1:2112</code> |
|
||||
|
||||
The bind address to serve prometheus metrics.
|
||||
|
||||
### -O, --org
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_ORGANIZATION</code> |
|
||||
|
||||
Select which organization (uuid or name) to use.
|
||||
Generated
+33
@@ -0,0 +1,33 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# publickey
|
||||
|
||||
Output your Coder public key used for Git operations
|
||||
|
||||
Aliases:
|
||||
|
||||
- pubkey
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder publickey [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --reset
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Regenerate your public key. This will require updating the key on any services it's registered with.
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
Generated
+21
@@ -0,0 +1,21 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# rename
|
||||
|
||||
Rename a workspace
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder rename [flags] <workspace> <new name>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
Generated
+22
@@ -0,0 +1,22 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# reset-password
|
||||
|
||||
Directly connect to the database to reset a user's password
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder reset-password [flags] <username>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --postgres-url
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_PG_CONNECTION_URL</code> |
|
||||
|
||||
URL of a PostgreSQL database to connect to.
|
||||
Generated
+73
@@ -0,0 +1,73 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# restart
|
||||
|
||||
Restart a workspace
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder restart [flags] <workspace>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
|
||||
### --build-option
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_BUILD_OPTION</code> |
|
||||
|
||||
Build option value in the format "name=value".
|
||||
|
||||
### --build-options
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Prompt for one-time build options defined with ephemeral parameters.
|
||||
|
||||
### --parameter
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_RICH_PARAMETER</code> |
|
||||
|
||||
Rich parameter value in the format "name=value".
|
||||
|
||||
### --rich-parameter-file
|
||||
|
||||
| | |
|
||||
| ----------- | --------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_RICH_PARAMETER_FILE</code> |
|
||||
|
||||
Specify a file path with values for rich parameters defined in the template.
|
||||
|
||||
### --parameter-default
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------------ |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_RICH_PARAMETER_DEFAULT</code> |
|
||||
|
||||
Rich parameter default values in the format "name=value".
|
||||
|
||||
### --always-prompt
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Always prompt all parameters. Does not pull parameter values from existing workspace.
|
||||
Generated
+20
@@ -0,0 +1,20 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# schedule
|
||||
|
||||
Schedule automated start and stop times for workspaces
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder schedule { show | start | stop | override } <workspace>
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| --------------------------------------------------------- | ----------------------------------------------------------------- |
|
||||
| [<code>show</code>](./schedule_show.md) | Show workspace schedules |
|
||||
| [<code>start</code>](./schedule_start.md) | Edit workspace start schedule |
|
||||
| [<code>stop</code>](./schedule_stop.md) | Edit workspace stop schedule |
|
||||
| [<code>override-stop</code>](./schedule_override-stop.md) | Override the stop time of a currently running workspace instance. |
|
||||
+22
@@ -0,0 +1,22 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# schedule override-stop
|
||||
|
||||
Override the stop time of a currently running workspace instance.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder schedule override-stop <workspace-name> <duration from now>
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
|
||||
* The new stop time is calculated from *now*.
|
||||
* The new stop time must be at least 30 minutes in the future.
|
||||
* The workspace template may restrict the maximum workspace runtime.
|
||||
|
||||
$ coder schedule override-stop my-workspace 90m
|
||||
```
|
||||
Generated
+59
@@ -0,0 +1,59 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# schedule show
|
||||
|
||||
Show workspace schedules
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder schedule show [flags] <workspace | --search <query> | --all>
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
Shows the following information for the given workspace(s):
|
||||
* The automatic start schedule
|
||||
* The next scheduled start time
|
||||
* The duration after which it will stop
|
||||
* The next scheduled stop time
|
||||
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -a, --all
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Specifies whether all workspaces will be listed or not.
|
||||
|
||||
### --search
|
||||
|
||||
| | |
|
||||
| ------- | --------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>owner:me</code> |
|
||||
|
||||
Search for a workspace with a query.
|
||||
|
||||
### -c, --column
|
||||
|
||||
| | |
|
||||
| ------- | ------------------------------------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Default | <code>workspace,starts at,starts next,stops after,stops next</code> |
|
||||
|
||||
Columns to display in table output. Available columns: workspace, starts at, starts next, stops after, stops next.
|
||||
|
||||
### -o, --output
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>table</code> |
|
||||
|
||||
Output format. Available formats: table, json.
|
||||
Generated
+29
@@ -0,0 +1,29 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# schedule start
|
||||
|
||||
Edit workspace start schedule
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder schedule start <workspace-name> { <start-time> [day-of-week] [location] | manual }
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
Schedules a workspace to regularly start at a specific time.
|
||||
Schedule format: <start-time> [day-of-week] [location].
|
||||
* Start-time (required) is accepted either in 12-hour (hh:mm{am|pm}) format, or 24-hour format hh:mm.
|
||||
* Day-of-week (optional) allows specifying in the cron format, e.g. 1,3,5 or Mon-Fri.
|
||||
Aliases such as @daily are not supported.
|
||||
Default: * (every day)
|
||||
* Location (optional) must be a valid location in the IANA timezone database.
|
||||
If omitted, we will fall back to either the TZ environment variable or /etc/localtime.
|
||||
You can check your corresponding location by visiting https://ipinfo.io - it shows in the demo widget on the right.
|
||||
|
||||
- Set the workspace to start at 9:30am (in Dublin) from Monday to Friday:
|
||||
|
||||
$ coder schedule start my-workspace 9:30AM Mon-Fri Europe/Dublin
|
||||
```
|
||||
Generated
+30
@@ -0,0 +1,30 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# schedule stop
|
||||
|
||||
Edit workspace stop schedule
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder schedule stop <workspace-name> { <duration> | manual }
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
Schedules a workspace to stop after a given duration has elapsed.
|
||||
* Workspace runtime is measured from the time that the workspace build completed.
|
||||
* The minimum scheduled stop time is 1 minute.
|
||||
* The workspace template may place restrictions on the maximum shutdown time.
|
||||
* Changes to workspace schedules only take effect upon the next build of the workspace,
|
||||
and do not affect a running instance of a workspace.
|
||||
|
||||
When enabling scheduled stop, enter a duration in one of the following formats:
|
||||
* 3h2m (3 hours and two minutes)
|
||||
* 3h (3 hours)
|
||||
* 2m (2 minutes)
|
||||
* 2 (2 minutes)
|
||||
|
||||
$ coder schedule stop my-workspace 2h30m
|
||||
```
|
||||
Generated
+1392
File diff suppressed because it is too large
Load Diff
+77
@@ -0,0 +1,77 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# server create-admin-user
|
||||
|
||||
Create a new admin user with the given username, email and password and adds it to every organization.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder server create-admin-user [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --postgres-url
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_PG_CONNECTION_URL</code> |
|
||||
|
||||
URL of a PostgreSQL database. If empty, the built-in PostgreSQL deployment will be used (Coder must not be already running in this case).
|
||||
|
||||
### --postgres-connection-auth
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------------- |
|
||||
| Type | <code>enum[password\|awsiamrds]</code> |
|
||||
| Environment | <code>$CODER_PG_CONNECTION_AUTH</code> |
|
||||
| Default | <code>password</code> |
|
||||
|
||||
Type of auth to use when connecting to postgres.
|
||||
|
||||
### --ssh-keygen-algorithm
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_SSH_KEYGEN_ALGORITHM</code> |
|
||||
| Default | <code>ed25519</code> |
|
||||
|
||||
The algorithm to use for generating ssh keys. Accepted values are "ed25519", "ecdsa", or "rsa4096".
|
||||
|
||||
### --username
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_USERNAME</code> |
|
||||
|
||||
The username of the new user. If not specified, you will be prompted via stdin.
|
||||
|
||||
### --email
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_EMAIL</code> |
|
||||
|
||||
The email of the new user. If not specified, you will be prompted via stdin.
|
||||
|
||||
### --password
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_PASSWORD</code> |
|
||||
|
||||
The password of the new user. If not specified, you will be prompted via stdin.
|
||||
|
||||
### --raw-url
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Output the raw connection URL instead of a psql command.
|
||||
Generated
+19
@@ -0,0 +1,19 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# server dbcrypt
|
||||
|
||||
Manage database encryption.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder server dbcrypt
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| --------------------------------------------------- | ----------------------------------------------------------------------------- |
|
||||
| [<code>decrypt</code>](./server_dbcrypt_decrypt.md) | Decrypt a previously encrypted database. |
|
||||
| [<code>delete</code>](./server_dbcrypt_delete.md) | Delete all encrypted data from the database. THIS IS A DESTRUCTIVE OPERATION. |
|
||||
| [<code>rotate</code>](./server_dbcrypt_rotate.md) | Rotate database encryption keys. |
|
||||
+49
@@ -0,0 +1,49 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# server dbcrypt decrypt
|
||||
|
||||
Decrypt a previously encrypted database.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder server dbcrypt decrypt [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --postgres-url
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_PG_CONNECTION_URL</code> |
|
||||
|
||||
The connection URL for the Postgres database.
|
||||
|
||||
### --postgres-connection-auth
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------------- |
|
||||
| Type | <code>enum[password\|awsiamrds]</code> |
|
||||
| Environment | <code>$CODER_PG_CONNECTION_AUTH</code> |
|
||||
| Default | <code>password</code> |
|
||||
|
||||
Type of auth to use when connecting to postgres.
|
||||
|
||||
### --keys
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_EXTERNAL_TOKEN_ENCRYPTION_DECRYPT_KEYS</code> |
|
||||
|
||||
Keys required to decrypt existing data. Must be a comma-separated list of base64-encoded keys.
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
+44
@@ -0,0 +1,44 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# server dbcrypt delete
|
||||
|
||||
Delete all encrypted data from the database. THIS IS A DESTRUCTIVE OPERATION.
|
||||
|
||||
Aliases:
|
||||
|
||||
- rm
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder server dbcrypt delete [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --postgres-url
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_EXTERNAL_TOKEN_ENCRYPTION_POSTGRES_URL</code> |
|
||||
|
||||
The connection URL for the Postgres database.
|
||||
|
||||
### --postgres-connection-auth
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------------- |
|
||||
| Type | <code>enum[password\|awsiamrds]</code> |
|
||||
| Environment | <code>$CODER_PG_CONNECTION_AUTH</code> |
|
||||
| Default | <code>password</code> |
|
||||
|
||||
Type of auth to use when connecting to postgres.
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
+58
@@ -0,0 +1,58 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# server dbcrypt rotate
|
||||
|
||||
Rotate database encryption keys.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder server dbcrypt rotate [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --postgres-url
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_PG_CONNECTION_URL</code> |
|
||||
|
||||
The connection URL for the Postgres database.
|
||||
|
||||
### --postgres-connection-auth
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------------- |
|
||||
| Type | <code>enum[password\|awsiamrds]</code> |
|
||||
| Environment | <code>$CODER_PG_CONNECTION_AUTH</code> |
|
||||
| Default | <code>password</code> |
|
||||
|
||||
Type of auth to use when connecting to postgres.
|
||||
|
||||
### --new-key
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_EXTERNAL_TOKEN_ENCRYPTION_ENCRYPT_NEW_KEY</code> |
|
||||
|
||||
The new external token encryption key. Must be base64-encoded.
|
||||
|
||||
### --old-keys
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_EXTERNAL_TOKEN_ENCRYPTION_ENCRYPT_OLD_KEYS</code> |
|
||||
|
||||
The old external token encryption keys. Must be a comma-separated list of base64-encoded keys.
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
+21
@@ -0,0 +1,21 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# server postgres-builtin-serve
|
||||
|
||||
Run the built-in PostgreSQL deployment.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder server postgres-builtin-serve [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --raw-url
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Output the raw connection URL instead of a psql command.
|
||||
+21
@@ -0,0 +1,21 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# server postgres-builtin-url
|
||||
|
||||
Output the connection URL for the built-in PostgreSQL deployment.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder server postgres-builtin-url [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --raw-url
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Output the raw connection URL instead of a psql command.
|
||||
Generated
+11
@@ -0,0 +1,11 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# show
|
||||
|
||||
Display details of a workspace's resources and agents
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder show <workspace>
|
||||
```
|
||||
Generated
+65
@@ -0,0 +1,65 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# speedtest
|
||||
|
||||
Run upload and download tests from your machine to a workspace
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder speedtest [flags] <workspace>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -d, --direct
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Specifies whether to wait for a direct connection before testing speed.
|
||||
|
||||
### --direction
|
||||
|
||||
| | |
|
||||
| ------- | --------------------------- |
|
||||
| Type | <code>enum[up\|down]</code> |
|
||||
| Default | <code>down</code> |
|
||||
|
||||
Specifies whether to run in reverse mode where the client receives and the server sends.
|
||||
|
||||
### -t, --time
|
||||
|
||||
| | |
|
||||
| ------- | --------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
| Default | <code>5s</code> |
|
||||
|
||||
Specifies the duration to monitor traffic.
|
||||
|
||||
### --pcap-file
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Specifies a file to write a network capture to.
|
||||
|
||||
### -c, --column
|
||||
|
||||
| | |
|
||||
| ------- | -------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Default | <code>Interval,Throughput</code> |
|
||||
|
||||
Columns to display in table output. Available columns: Interval, Throughput.
|
||||
|
||||
### -o, --output
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>table</code> |
|
||||
|
||||
Output format. Available formats: table, json.
|
||||
Generated
+115
@@ -0,0 +1,115 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# ssh
|
||||
|
||||
Start a shell into a workspace
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder ssh [flags] <workspace>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --stdio
|
||||
|
||||
| | |
|
||||
| ----------- | ----------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_SSH_STDIO</code> |
|
||||
|
||||
Specifies whether to emit SSH output over stdin/stdout.
|
||||
|
||||
### -A, --forward-agent
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_SSH_FORWARD_AGENT</code> |
|
||||
|
||||
Specifies whether to forward the SSH agent specified in $SSH_AUTH_SOCK.
|
||||
|
||||
### -G, --forward-gpg
|
||||
|
||||
| | |
|
||||
| ----------- | ----------------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_SSH_FORWARD_GPG</code> |
|
||||
|
||||
Specifies whether to forward the GPG agent. Unsupported on Windows workspaces, but supports all clients. Requires gnupg (gpg, gpgconf) on both the client and workspace. The GPG agent must already be running locally and will not be started for you. If a GPG agent is already running in the workspace, it will be attempted to be killed.
|
||||
|
||||
### --identity-agent
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_SSH_IDENTITY_AGENT</code> |
|
||||
|
||||
Specifies which identity agent to use (overrides $SSH_AUTH_SOCK), forward agent must also be enabled.
|
||||
|
||||
### --workspace-poll-interval
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
| Environment | <code>$CODER_WORKSPACE_POLL_INTERVAL</code> |
|
||||
| Default | <code>1m</code> |
|
||||
|
||||
Specifies how often to poll for workspace automated shutdown.
|
||||
|
||||
### --wait
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>enum[yes\|no\|auto]</code> |
|
||||
| Environment | <code>$CODER_SSH_WAIT</code> |
|
||||
| Default | <code>auto</code> |
|
||||
|
||||
Specifies whether or not to wait for the startup script to finish executing. Auto means that the agent startup script behavior configured in the workspace template is used.
|
||||
|
||||
### --no-wait
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_SSH_NO_WAIT</code> |
|
||||
|
||||
Enter workspace immediately after the agent has connected. This is the default if the template has configured the agent startup script behavior as non-blocking.
|
||||
|
||||
### -l, --log-dir
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_SSH_LOG_DIR</code> |
|
||||
|
||||
Specify the directory containing SSH diagnostic log files.
|
||||
|
||||
### -R, --remote-forward
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_SSH_REMOTE_FORWARD</code> |
|
||||
|
||||
Enable remote port forwarding (remote_port:local_address:local_port).
|
||||
|
||||
### -e, --env
|
||||
|
||||
| | |
|
||||
| ----------- | --------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_SSH_ENV</code> |
|
||||
|
||||
Set environment variable(s) for session (key1=value1,key2=value2,...).
|
||||
|
||||
### --disable-autostart
|
||||
|
||||
| | |
|
||||
| ----------- | ----------------------------------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Environment | <code>$CODER_SSH_DISABLE_AUTOSTART</code> |
|
||||
| Default | <code>false</code> |
|
||||
|
||||
Disable starting the workspace automatically when connecting via SSH.
|
||||
Generated
+73
@@ -0,0 +1,73 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# start
|
||||
|
||||
Start a workspace
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder start [flags] <workspace>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
|
||||
### --build-option
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_BUILD_OPTION</code> |
|
||||
|
||||
Build option value in the format "name=value".
|
||||
|
||||
### --build-options
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Prompt for one-time build options defined with ephemeral parameters.
|
||||
|
||||
### --parameter
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_RICH_PARAMETER</code> |
|
||||
|
||||
Rich parameter value in the format "name=value".
|
||||
|
||||
### --rich-parameter-file
|
||||
|
||||
| | |
|
||||
| ----------- | --------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_RICH_PARAMETER_FILE</code> |
|
||||
|
||||
Specify a file path with values for rich parameters defined in the template.
|
||||
|
||||
### --parameter-default
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------------ |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_RICH_PARAMETER_DEFAULT</code> |
|
||||
|
||||
Rich parameter default values in the format "name=value".
|
||||
|
||||
### --always-prompt
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Always prompt all parameters. Does not pull parameter values from existing workspace.
|
||||
Generated
+39
@@ -0,0 +1,39 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# stat
|
||||
|
||||
Show resource usage for the current workspace.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder stat [flags]
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| ----------------------------------- | -------------------------------- |
|
||||
| [<code>cpu</code>](./stat_cpu.md) | Show CPU usage, in cores. |
|
||||
| [<code>mem</code>](./stat_mem.md) | Show memory usage, in gigabytes. |
|
||||
| [<code>disk</code>](./stat_disk.md) | Show disk usage, in gigabytes. |
|
||||
|
||||
## Options
|
||||
|
||||
### -c, --column
|
||||
|
||||
| | |
|
||||
| ------- | -------------------------------------------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Default | <code>host_cpu,host_memory,home_disk,container_cpu,container_memory</code> |
|
||||
|
||||
Columns to display in table output. Available columns: host cpu, host memory, home disk, container cpu, container memory.
|
||||
|
||||
### -o, --output
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>table</code> |
|
||||
|
||||
Output format. Available formats: table, json.
|
||||
Generated
+30
@@ -0,0 +1,30 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# stat cpu
|
||||
|
||||
Show CPU usage, in cores.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder stat cpu [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --host
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Force host CPU measurement.
|
||||
|
||||
### -o, --output
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>text</code> |
|
||||
|
||||
Output format. Available formats: text, json.
|
||||
Generated
+40
@@ -0,0 +1,40 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# stat disk
|
||||
|
||||
Show disk usage, in gigabytes.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder stat disk [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --path
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>/</code> |
|
||||
|
||||
Path for which to check disk usage.
|
||||
|
||||
### --prefix
|
||||
|
||||
| | |
|
||||
| ------- | --------------------------------- |
|
||||
| Type | <code>enum[Ki\|Mi\|Gi\|Ti]</code> |
|
||||
| Default | <code>Gi</code> |
|
||||
|
||||
SI Prefix for disk measurement.
|
||||
|
||||
### -o, --output
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>text</code> |
|
||||
|
||||
Output format. Available formats: text, json.
|
||||
Generated
+39
@@ -0,0 +1,39 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# stat mem
|
||||
|
||||
Show memory usage, in gigabytes.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder stat mem [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --host
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Force host memory measurement.
|
||||
|
||||
### --prefix
|
||||
|
||||
| | |
|
||||
| ------- | --------------------------------- |
|
||||
| Type | <code>enum[Ki\|Mi\|Gi\|Ti]</code> |
|
||||
| Default | <code>Gi</code> |
|
||||
|
||||
SI Prefix for memory measurement.
|
||||
|
||||
### -o, --output
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>text</code> |
|
||||
|
||||
Output format. Available formats: text, json.
|
||||
Generated
+18
@@ -0,0 +1,18 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# state
|
||||
|
||||
Manually manage Terraform state to fix broken workspaces
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder state
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| ------------------------------------ | --------------------------------------------- |
|
||||
| [<code>pull</code>](./state_pull.md) | Pull a Terraform state file from a workspace. |
|
||||
| [<code>push</code>](./state_push.md) | Push a Terraform state file to a workspace. |
|
||||
Generated
+21
@@ -0,0 +1,21 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# state pull
|
||||
|
||||
Pull a Terraform state file from a workspace.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder state pull [flags] <workspace> [file]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -b, --build
|
||||
|
||||
| | |
|
||||
| ---- | ---------------- |
|
||||
| Type | <code>int</code> |
|
||||
|
||||
Specify a workspace build to target by name. Defaults to latest.
|
||||
Generated
+21
@@ -0,0 +1,21 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# state push
|
||||
|
||||
Push a Terraform state file to a workspace.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder state push [flags] <workspace> <file>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -b, --build
|
||||
|
||||
| | |
|
||||
| ---- | ---------------- |
|
||||
| Type | <code>int</code> |
|
||||
|
||||
Specify a workspace build to target by name. Defaults to latest.
|
||||
Generated
+21
@@ -0,0 +1,21 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# stop
|
||||
|
||||
Stop a workspace
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder stop [flags] <workspace>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
Generated
+17
@@ -0,0 +1,17 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# support
|
||||
|
||||
Commands for troubleshooting issues with a Coder deployment.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder support
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| ------------------------------------------ | --------------------------------------------------------------------------- |
|
||||
| [<code>bundle</code>](./support_bundle.md) | Generate a support bundle to troubleshoot issues connecting to a workspace. |
|
||||
Generated
+45
@@ -0,0 +1,45 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# support bundle
|
||||
|
||||
Generate a support bundle to troubleshoot issues connecting to a workspace.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder support bundle [flags] <workspace> [<agent>]
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
This command generates a file containing detailed troubleshooting information about the Coder deployment and workspace connections. You must specify a single workspace (and optionally an agent name).
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
|
||||
### -O, --output-file
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_SUPPORT_BUNDLE_OUTPUT_FILE</code> |
|
||||
|
||||
File path for writing the generated support bundle. Defaults to coder-support-$(date +%s).zip.
|
||||
|
||||
### --url-override
|
||||
|
||||
| | |
|
||||
| ----------- | ----------------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_SUPPORT_BUNDLE_URL_OVERRIDE</code> |
|
||||
|
||||
Override the URL to your Coder deployment. This may be useful, for example, if you need to troubleshoot a specific Coder replica.
|
||||
Generated
+39
@@ -0,0 +1,39 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# templates
|
||||
|
||||
Manage templates
|
||||
|
||||
Aliases:
|
||||
|
||||
- template
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder templates
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
Templates are written in standard Terraform and describe the infrastructure for workspaces
|
||||
- Create or push an update to the template. Your developers can update their
|
||||
workspaces:
|
||||
|
||||
$ coder templates push my-template
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| ------------------------------------------------ | -------------------------------------------------------------------------------- |
|
||||
| [<code>create</code>](./templates_create.md) | DEPRECATED: Create a template from the current directory or as specified by flag |
|
||||
| [<code>edit</code>](./templates_edit.md) | Edit the metadata of a template by name. |
|
||||
| [<code>init</code>](./templates_init.md) | Get started with a templated template. |
|
||||
| [<code>list</code>](./templates_list.md) | List all the templates available for the organization |
|
||||
| [<code>push</code>](./templates_push.md) | Create or update a template from the current directory or as specified by flag |
|
||||
| [<code>versions</code>](./templates_versions.md) | Manage different versions of the specified template |
|
||||
| [<code>delete</code>](./templates_delete.md) | Delete templates |
|
||||
| [<code>pull</code>](./templates_pull.md) | Download the active, latest, or specified version of a template to a path. |
|
||||
| [<code>archive</code>](./templates_archive.md) | Archive unused or failed template versions from a given template(s) |
|
||||
Generated
+38
@@ -0,0 +1,38 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# templates archive
|
||||
|
||||
Archive unused or failed template versions from a given template(s)
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder templates archive [flags] [template-name...]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
|
||||
### --all
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Include all unused template versions. By default, only failed template versions are archived.
|
||||
|
||||
### -O, --org
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_ORGANIZATION</code> |
|
||||
|
||||
Select which organization (uuid or name) to use.
|
||||
Generated
+141
@@ -0,0 +1,141 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# templates create
|
||||
|
||||
DEPRECATED: Create a template from the current directory or as specified by flag
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder templates create [flags] [name]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --private
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Disable the default behavior of granting template access to the 'everyone' group. The template permissions must be updated to allow non-admin users to use this template.
|
||||
|
||||
### --variables-file
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Specify a file path with values for Terraform-managed variables.
|
||||
|
||||
### --variable
|
||||
|
||||
| | |
|
||||
| ---- | ------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
|
||||
Specify a set of values for Terraform-managed variables.
|
||||
|
||||
### --var
|
||||
|
||||
| | |
|
||||
| ---- | ------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
|
||||
Alias of --variable.
|
||||
|
||||
### --provisioner-tag
|
||||
|
||||
| | |
|
||||
| ---- | ------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
|
||||
Specify a set of tags to target provisioner daemons.
|
||||
|
||||
### --default-ttl
|
||||
|
||||
| | |
|
||||
| ------- | --------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
| Default | <code>24h</code> |
|
||||
|
||||
Specify a default TTL for workspaces created from this template. It is the default time before shutdown - workspaces created from this template default to this value. Maps to "Default autostop" in the UI.
|
||||
|
||||
### --failure-ttl
|
||||
|
||||
| | |
|
||||
| ------- | --------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
| Default | <code>0h</code> |
|
||||
|
||||
Specify a failure TTL for workspaces created from this template. It is the amount of time after a failed "start" build before coder automatically schedules a "stop" build to cleanup.This licensed feature's default is 0h (off). Maps to "Failure cleanup"in the UI.
|
||||
|
||||
### --dormancy-threshold
|
||||
|
||||
| | |
|
||||
| ------- | --------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
| Default | <code>0h</code> |
|
||||
|
||||
Specify a duration workspaces may be inactive prior to being moved to the dormant state. This licensed feature's default is 0h (off). Maps to "Dormancy threshold" in the UI.
|
||||
|
||||
### --dormancy-auto-deletion
|
||||
|
||||
| | |
|
||||
| ------- | --------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
| Default | <code>0h</code> |
|
||||
|
||||
Specify a duration workspaces may be in the dormant state prior to being deleted. This licensed feature's default is 0h (off). Maps to "Dormancy Auto-Deletion" in the UI.
|
||||
|
||||
### --require-active-version
|
||||
|
||||
| | |
|
||||
| ------- | ------------------ |
|
||||
| Type | <code>bool</code> |
|
||||
| Default | <code>false</code> |
|
||||
|
||||
Requires workspace builds to use the active template version. This setting does not apply to template admins. This is an enterprise-only feature.
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
|
||||
### -O, --org
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_ORGANIZATION</code> |
|
||||
|
||||
Select which organization (uuid or name) to use.
|
||||
|
||||
### -d, --directory
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>.</code> |
|
||||
|
||||
Specify the directory to create from, use '-' to read tar from stdin.
|
||||
|
||||
### --ignore-lockfile
|
||||
|
||||
| | |
|
||||
| ------- | ------------------ |
|
||||
| Type | <code>bool</code> |
|
||||
| Default | <code>false</code> |
|
||||
|
||||
Ignore warnings about not having a .terraform.lock.hcl file present in the template.
|
||||
|
||||
### -m, --message
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Specify a message describing the changes in this version of the template. Messages longer than 72 characters will be displayed as truncated.
|
||||
Generated
+34
@@ -0,0 +1,34 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# templates delete
|
||||
|
||||
Delete templates
|
||||
|
||||
Aliases:
|
||||
|
||||
- rm
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder templates delete [flags] [name...]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
|
||||
### -O, --org
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_ORGANIZATION</code> |
|
||||
|
||||
Select which organization (uuid or name) to use.
|
||||
Generated
+182
@@ -0,0 +1,182 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# templates edit
|
||||
|
||||
Edit the metadata of a template by name.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder templates edit [flags] <template>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --name
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Edit the template name.
|
||||
|
||||
### --display-name
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Edit the template display name.
|
||||
|
||||
### --description
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Edit the template description.
|
||||
|
||||
### --deprecated
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Sets the template as deprecated. Must be a message explaining why the template is deprecated.
|
||||
|
||||
### --icon
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Edit the template icon path.
|
||||
|
||||
### --default-ttl
|
||||
|
||||
| | |
|
||||
| ---- | --------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
|
||||
Edit the template default time before shutdown - workspaces created from this template default to this value. Maps to "Default autostop" in the UI.
|
||||
|
||||
### --activity-bump
|
||||
|
||||
| | |
|
||||
| ---- | --------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
|
||||
Edit the template activity bump - workspaces created from this template will have their shutdown time bumped by this value when activity is detected. Maps to "Activity bump" in the UI.
|
||||
|
||||
### --autostart-requirement-weekdays
|
||||
|
||||
| | |
|
||||
| ---- | ------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
|
||||
Edit the template autostart requirement weekdays - workspaces created from this template can only autostart on the given weekdays. To unset this value for the template (and allow autostart on all days), pass 'all'.
|
||||
|
||||
### --autostop-requirement-weekdays
|
||||
|
||||
| | |
|
||||
| ---- | ------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
|
||||
Edit the template autostop requirement weekdays - workspaces created from this template must be restarted on the given weekdays. To unset this value for the template (and disable the autostop requirement for the template), pass 'none'.
|
||||
|
||||
### --autostop-requirement-weeks
|
||||
|
||||
| | |
|
||||
| ---- | ---------------- |
|
||||
| Type | <code>int</code> |
|
||||
|
||||
Edit the template autostop requirement weeks - workspaces created from this template must be restarted on an n-weekly basis.
|
||||
|
||||
### --failure-ttl
|
||||
|
||||
| | |
|
||||
| ------- | --------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
| Default | <code>0h</code> |
|
||||
|
||||
Specify a failure TTL for workspaces created from this template. It is the amount of time after a failed "start" build before coder automatically schedules a "stop" build to cleanup.This licensed feature's default is 0h (off). Maps to "Failure cleanup" in the UI.
|
||||
|
||||
### --dormancy-threshold
|
||||
|
||||
| | |
|
||||
| ------- | --------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
| Default | <code>0h</code> |
|
||||
|
||||
Specify a duration workspaces may be inactive prior to being moved to the dormant state. This licensed feature's default is 0h (off). Maps to "Dormancy threshold" in the UI.
|
||||
|
||||
### --dormancy-auto-deletion
|
||||
|
||||
| | |
|
||||
| ------- | --------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
| Default | <code>0h</code> |
|
||||
|
||||
Specify a duration workspaces may be in the dormant state prior to being deleted. This licensed feature's default is 0h (off). Maps to "Dormancy Auto-Deletion" in the UI.
|
||||
|
||||
### --allow-user-cancel-workspace-jobs
|
||||
|
||||
| | |
|
||||
| ------- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Default | <code>true</code> |
|
||||
|
||||
Allow users to cancel in-progress workspace jobs.
|
||||
|
||||
### --allow-user-autostart
|
||||
|
||||
| | |
|
||||
| ------- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Default | <code>true</code> |
|
||||
|
||||
Allow users to configure autostart for workspaces on this template. This can only be disabled in enterprise.
|
||||
|
||||
### --allow-user-autostop
|
||||
|
||||
| | |
|
||||
| ------- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Default | <code>true</code> |
|
||||
|
||||
Allow users to customize the autostop TTL for workspaces on this template. This can only be disabled in enterprise.
|
||||
|
||||
### --require-active-version
|
||||
|
||||
| | |
|
||||
| ------- | ------------------ |
|
||||
| Type | <code>bool</code> |
|
||||
| Default | <code>false</code> |
|
||||
|
||||
Requires workspace builds to use the active template version. This setting does not apply to template admins. This is an enterprise-only feature.
|
||||
|
||||
### --private
|
||||
|
||||
| | |
|
||||
| ------- | ------------------ |
|
||||
| Type | <code>bool</code> |
|
||||
| Default | <code>false</code> |
|
||||
|
||||
Disable the default behavior of granting template access to the 'everyone' group. The template permissions must be updated to allow non-admin users to use this template.
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
|
||||
### -O, --org
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_ORGANIZATION</code> |
|
||||
|
||||
Select which organization (uuid or name) to use.
|
||||
Generated
+21
@@ -0,0 +1,21 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# templates init
|
||||
|
||||
Get started with a templated template.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder templates init [flags] [directory]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --id
|
||||
|
||||
| | |
|
||||
| ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Type | <code>enum[aws-devcontainer\|aws-linux\|aws-windows\|azure-linux\|do-linux\|docker\|gcp-devcontainer\|gcp-linux\|gcp-vm-container\|gcp-windows\|kubernetes\|nomad-docker\|scratch]</code> |
|
||||
|
||||
Specify a given example template by ID.
|
||||
Generated
+35
@@ -0,0 +1,35 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# templates list
|
||||
|
||||
List all the templates available for the organization
|
||||
|
||||
Aliases:
|
||||
|
||||
- ls
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder templates list [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -c, --column
|
||||
|
||||
| | |
|
||||
| ------- | -------------------------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Default | <code>name,organization name,last updated,used by</code> |
|
||||
|
||||
Columns to display in table output. Available columns: name, created at, last updated, organization id, organization name, provisioner, active version id, used by, default ttl.
|
||||
|
||||
### -o, --output
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>table</code> |
|
||||
|
||||
Output format. Available formats: table, json.
|
||||
Generated
+54
@@ -0,0 +1,54 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# templates pull
|
||||
|
||||
Download the active, latest, or specified version of a template to a path.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder templates pull [flags] <name> [destination]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --tar
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Output the template as a tar archive to stdout.
|
||||
|
||||
### --zip
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Output the template as a zip archive to stdout.
|
||||
|
||||
### --version
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
The name of the template version to pull. Use 'active' to pull the active version, 'latest' to pull the latest version, or the name of the template version to pull.
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
|
||||
### -O, --org
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_ORGANIZATION</code> |
|
||||
|
||||
Select which organization (uuid or name) to use.
|
||||
Generated
+113
@@ -0,0 +1,113 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# templates push
|
||||
|
||||
Create or update a template from the current directory or as specified by flag
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder templates push [flags] [template]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --variables-file
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Specify a file path with values for Terraform-managed variables.
|
||||
|
||||
### --variable
|
||||
|
||||
| | |
|
||||
| ---- | ------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
|
||||
Specify a set of values for Terraform-managed variables.
|
||||
|
||||
### --var
|
||||
|
||||
| | |
|
||||
| ---- | ------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
|
||||
Alias of --variable.
|
||||
|
||||
### --provisioner-tag
|
||||
|
||||
| | |
|
||||
| ---- | ------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
|
||||
Specify a set of tags to target provisioner daemons.
|
||||
|
||||
### --name
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Specify a name for the new template version. It will be automatically generated if not provided.
|
||||
|
||||
### --always-prompt
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Always prompt all parameters. Does not pull parameter values from active template version.
|
||||
|
||||
### --activate
|
||||
|
||||
| | |
|
||||
| ------- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
| Default | <code>true</code> |
|
||||
|
||||
Whether the new template will be marked active.
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
|
||||
### -d, --directory
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>.</code> |
|
||||
|
||||
Specify the directory to create from, use '-' to read tar from stdin.
|
||||
|
||||
### --ignore-lockfile
|
||||
|
||||
| | |
|
||||
| ------- | ------------------ |
|
||||
| Type | <code>bool</code> |
|
||||
| Default | <code>false</code> |
|
||||
|
||||
Ignore warnings about not having a .terraform.lock.hcl file present in the template.
|
||||
|
||||
### -m, --message
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Specify a message describing the changes in this version of the template. Messages longer than 72 characters will be displayed as truncated.
|
||||
|
||||
### -O, --org
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_ORGANIZATION</code> |
|
||||
|
||||
Select which organization (uuid or name) to use.
|
||||
Generated
+31
@@ -0,0 +1,31 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# templates versions
|
||||
|
||||
Manage different versions of the specified template
|
||||
|
||||
Aliases:
|
||||
|
||||
- version
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder templates versions
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
- List versions of a specific template:
|
||||
|
||||
$ coder templates versions list my-template
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| ----------------------------------------------------------- | ----------------------------------------------- |
|
||||
| [<code>list</code>](./templates_versions_list.md) | List all the versions of the specified template |
|
||||
| [<code>archive</code>](./templates_versions_archive.md) | Archive a template version(s). |
|
||||
| [<code>unarchive</code>](./templates_versions_unarchive.md) | Unarchive a template version(s). |
|
||||
+30
@@ -0,0 +1,30 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# templates versions archive
|
||||
|
||||
Archive a template version(s).
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder templates versions archive [flags] <template-name> [template-version-names...]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
|
||||
### -O, --org
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_ORGANIZATION</code> |
|
||||
|
||||
Select which organization (uuid or name) to use.
|
||||
+48
@@ -0,0 +1,48 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# templates versions list
|
||||
|
||||
List all the versions of the specified template
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder templates versions list [flags] <template>
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --include-archived
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Include archived versions in the result list.
|
||||
|
||||
### -O, --org
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_ORGANIZATION</code> |
|
||||
|
||||
Select which organization (uuid or name) to use.
|
||||
|
||||
### -c, --column
|
||||
|
||||
| | |
|
||||
| ------- | ----------------------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Default | <code>Name,Created At,Created By,Status,Active</code> |
|
||||
|
||||
Columns to display in table output. Available columns: name, created at, created by, status, active, archived.
|
||||
|
||||
### -o, --output
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>table</code> |
|
||||
|
||||
Output format. Available formats: table, json.
|
||||
+30
@@ -0,0 +1,30 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# templates versions unarchive
|
||||
|
||||
Unarchive a template version(s).
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder templates versions unarchive [flags] <template-name> [template-version-names...]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -y, --yes
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Bypass prompts.
|
||||
|
||||
### -O, --org
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_ORGANIZATION</code> |
|
||||
|
||||
Select which organization (uuid or name) to use.
|
||||
Generated
+40
@@ -0,0 +1,40 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# tokens
|
||||
|
||||
Manage personal access tokens
|
||||
|
||||
Aliases:
|
||||
|
||||
- token
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder tokens
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
Tokens are used to authenticate automated clients to Coder.
|
||||
- Create a token for automation:
|
||||
|
||||
$ coder tokens create
|
||||
|
||||
- List your tokens:
|
||||
|
||||
$ coder tokens ls
|
||||
|
||||
- Remove a token by ID:
|
||||
|
||||
$ coder tokens rm WuoWs4ZsMX
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| ----------------------------------------- | -------------- |
|
||||
| [<code>create</code>](./tokens_create.md) | Create a token |
|
||||
| [<code>list</code>](./tokens_list.md) | List tokens |
|
||||
| [<code>remove</code>](./tokens_remove.md) | Delete a token |
|
||||
Generated
+32
@@ -0,0 +1,32 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# tokens create
|
||||
|
||||
Create a token
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder tokens create [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --lifetime
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------- |
|
||||
| Type | <code>duration</code> |
|
||||
| Environment | <code>$CODER_TOKEN_LIFETIME</code> |
|
||||
| Default | <code>720h0m0s</code> |
|
||||
|
||||
Specify a duration for the lifetime of the token.
|
||||
|
||||
### -n, --name
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------ |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_TOKEN_NAME</code> |
|
||||
|
||||
Specify a human-readable name.
|
||||
Generated
+43
@@ -0,0 +1,43 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# tokens list
|
||||
|
||||
List tokens
|
||||
|
||||
Aliases:
|
||||
|
||||
- ls
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder tokens list [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -a, --all
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Specifies whether all users' tokens will be listed or not (must have Owner role to see all tokens).
|
||||
|
||||
### -c, --column
|
||||
|
||||
| | |
|
||||
| ------- | ---------------------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Default | <code>id,name,last used,expires at,created at</code> |
|
||||
|
||||
Columns to display in table output. Available columns: id, name, last used, expires at, created at, owner.
|
||||
|
||||
### -o, --output
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>table</code> |
|
||||
|
||||
Output format. Available formats: table, json.
|
||||
Generated
+16
@@ -0,0 +1,16 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# tokens remove
|
||||
|
||||
Delete a token
|
||||
|
||||
Aliases:
|
||||
|
||||
- delete
|
||||
- rm
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder tokens remove <name>
|
||||
```
|
||||
Generated
+16
@@ -0,0 +1,16 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# unfavorite
|
||||
|
||||
Remove a workspace from your favorites
|
||||
|
||||
Aliases:
|
||||
|
||||
- unfav
|
||||
- unfavourite
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder unfavorite <workspace>
|
||||
```
|
||||
Generated
+71
@@ -0,0 +1,71 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# update
|
||||
|
||||
Will update and start a given workspace if it is out of date
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder update [flags] <workspace>
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
Use --always-prompt to change the parameter values of the workspace.
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### --build-option
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_BUILD_OPTION</code> |
|
||||
|
||||
Build option value in the format "name=value".
|
||||
|
||||
### --build-options
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Prompt for one-time build options defined with ephemeral parameters.
|
||||
|
||||
### --parameter
|
||||
|
||||
| | |
|
||||
| ----------- | ---------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_RICH_PARAMETER</code> |
|
||||
|
||||
Rich parameter value in the format "name=value".
|
||||
|
||||
### --rich-parameter-file
|
||||
|
||||
| | |
|
||||
| ----------- | --------------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_RICH_PARAMETER_FILE</code> |
|
||||
|
||||
Specify a file path with values for rich parameters defined in the template.
|
||||
|
||||
### --parameter-default
|
||||
|
||||
| | |
|
||||
| ----------- | ------------------------------------------ |
|
||||
| Type | <code>string-array</code> |
|
||||
| Environment | <code>$CODER_RICH_PARAMETER_DEFAULT</code> |
|
||||
|
||||
Rich parameter default values in the format "name=value".
|
||||
|
||||
### --always-prompt
|
||||
|
||||
| | |
|
||||
| ---- | ----------------- |
|
||||
| Type | <code>bool</code> |
|
||||
|
||||
Always prompt all parameters. Does not pull parameter values from existing workspace.
|
||||
Generated
+26
@@ -0,0 +1,26 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# users
|
||||
|
||||
Manage users
|
||||
|
||||
Aliases:
|
||||
|
||||
- user
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder users [subcommand]
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
| Name | Purpose |
|
||||
| -------------------------------------------- | ------------------------------------------------------------------------------------- |
|
||||
| [<code>create</code>](./users_create.md) | |
|
||||
| [<code>list</code>](./users_list.md) | |
|
||||
| [<code>show</code>](./users_show.md) | Show a single user. Use 'me' to indicate the currently authenticated user. |
|
||||
| [<code>delete</code>](./users_delete.md) | Delete a user by username or user_id. |
|
||||
| [<code>activate</code>](./users_activate.md) | Update a user's status to 'active'. Active users can fully interact with the platform |
|
||||
| [<code>suspend</code>](./users_suspend.md) | Update a user's status to 'suspended'. A suspended user cannot log into the platform |
|
||||
Generated
+32
@@ -0,0 +1,32 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# users activate
|
||||
|
||||
Update a user's status to 'active'. Active users can fully interact with the platform
|
||||
|
||||
Aliases:
|
||||
|
||||
- active
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder users activate [flags] <username|user_id>
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
$ coder users activate example_user
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -c, --column
|
||||
|
||||
| | |
|
||||
| ------- | --------------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Default | <code>username,email,created_at,status</code> |
|
||||
|
||||
Specify a column to filter in the table.
|
||||
Generated
+60
@@ -0,0 +1,60 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# users create
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder users create [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -e, --email
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Specifies an email address for the new user.
|
||||
|
||||
### -u, --username
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Specifies a username for the new user.
|
||||
|
||||
### -n, --full-name
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Specifies an optional human-readable name for the new user.
|
||||
|
||||
### -p, --password
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Specifies a password for the new user.
|
||||
|
||||
### --login-type
|
||||
|
||||
| | |
|
||||
| ---- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
|
||||
Optionally specify the login type for the user. Valid values are: password, none, github, oidc. Using 'none' prevents the user from authenticating and requires an API key/token to be generated by an admin.
|
||||
|
||||
### -O, --org
|
||||
|
||||
| | |
|
||||
| ----------- | -------------------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Environment | <code>$CODER_ORGANIZATION</code> |
|
||||
|
||||
Select which organization (uuid or name) to use.
|
||||
Generated
+15
@@ -0,0 +1,15 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# users delete
|
||||
|
||||
Delete a user by username or user_id.
|
||||
|
||||
Aliases:
|
||||
|
||||
- rm
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder users delete <username|user_id>
|
||||
```
|
||||
Generated
+33
@@ -0,0 +1,33 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# users list
|
||||
|
||||
Aliases:
|
||||
|
||||
- ls
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder users list [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -c, --column
|
||||
|
||||
| | |
|
||||
| ------- | --------------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Default | <code>username,email,created_at,status</code> |
|
||||
|
||||
Columns to display in table output. Available columns: id, username, email, created at, updated at, status.
|
||||
|
||||
### -o, --output
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>table</code> |
|
||||
|
||||
Output format. Available formats: table, json.
|
||||
Generated
+28
@@ -0,0 +1,28 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# users show
|
||||
|
||||
Show a single user. Use 'me' to indicate the currently authenticated user.
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder users show [flags] <username|user_id|'me'>
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
$ coder users show me
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -o, --output
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>table</code> |
|
||||
|
||||
Output format. Available formats: table, json.
|
||||
Generated
+28
@@ -0,0 +1,28 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# users suspend
|
||||
|
||||
Update a user's status to 'suspended'. A suspended user cannot log into the platform
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder users suspend [flags] <username|user_id>
|
||||
```
|
||||
|
||||
## Description
|
||||
|
||||
```console
|
||||
$ coder users suspend example_user
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -c, --column
|
||||
|
||||
| | |
|
||||
| ------- | --------------------------------------------- |
|
||||
| Type | <code>string-array</code> |
|
||||
| Default | <code>username,email,created_at,status</code> |
|
||||
|
||||
Specify a column to filter in the table.
|
||||
Generated
+22
@@ -0,0 +1,22 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# version
|
||||
|
||||
Show coder version
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder version [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
### -o, --output
|
||||
|
||||
| | |
|
||||
| ------- | ------------------- |
|
||||
| Type | <code>string</code> |
|
||||
| Default | <code>text</code> |
|
||||
|
||||
Output format. Available formats: text, json.
|
||||
Generated
+11
@@ -0,0 +1,11 @@
|
||||
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
||||
|
||||
# whoami
|
||||
|
||||
Fetch authenticated user info for Coder deployment
|
||||
|
||||
## Usage
|
||||
|
||||
```console
|
||||
coder whoami
|
||||
```
|
||||
Reference in New Issue
Block a user