Skip to content

Commit 976d23e

Browse files
authored
docs(templates): fix docs for updated --wait flag (#7918)
1 parent 03034dc commit 976d23e

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

docs/templates/index.md

+8-8
Original file line numberDiff line numberDiff line change
@@ -221,14 +221,14 @@ resource "coder_agent" "coder" {
221221
Whichever behavior is enabled, the user can still choose to override it by specifying the appropriate flags (or environment variables) in the CLI when connecting to the workspace. The behavior can be overridden by one of the following means:
222222

223223
- Set an environment variable (for use with `ssh` or `coder ssh`):
224-
- `export CODER_SSH_WAIT=true` (blocking)
225-
- `export CODER_SSH_NO_WAIT=true` (non-blocking)
224+
- `export CODER_SSH_WAIT=yes` (blocking)
225+
- `export CODER_SSH_WAIT=no` (non-blocking)
226226
- Use a flag with `coder ssh`:
227-
- `coder ssh --wait my-workspace` (blocking)
228-
- `coder ssh --no-wait my-workspace` (non-blocking)
229-
- Use a flag that configures all future `ssh` connections:
230-
- `coder config-ssh --wait` (blocking)
231-
- `coder config-ssh --no-wait` (non-blocking)
227+
- `coder ssh --wait=yes my-workspace` (blocking)
228+
- `coder ssh --wait=no my-workspace` (non-blocking)
229+
- Use a flag to configure all future `ssh` connections:
230+
- `coder config-ssh --wait=yes` (blocking)
231+
- `coder config-ssh --wait=no` (non-blocking)
232232

233233
### Start/stop
234234

@@ -424,7 +424,7 @@ Depending on the contents of the [startup script](https://registry.terraform.io/
424424

425425
#### Unable to access workspace, startup script is still running
426426

427-
If you're trying to access your workspace and are unable to because the [startup script](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#startup_script) is still running, it means the [startup script behavior](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#startup_script_behavior) option is set to blocking or you have enabled the `--wait` option (for e.g. `coder ssh` or `coder config-ssh`). In such an event, you can always access the workspace by using the web terminal, or via SSH using the `--no-wait` option. If the startup script is running longer than it should, or never completing, you can try to [debug the startup script](#debugging-the-startup-script) to resolve the issue. Alternatively, you can try to force the startup script to exit by terminating processes started by it or terminating the startup script itself (on Linux, `ps` and `kill` are useful tools).
427+
If you're trying to access your workspace and are unable to because the [startup script](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#startup_script) is still running, it means the [startup script behavior](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#startup_script_behavior) option is set to blocking or you have enabled the `--wait=yes` option (for e.g. `coder ssh` or `coder config-ssh`). In such an event, you can always access the workspace by using the web terminal, or via SSH using the `--wait=no` option. If the startup script is running longer than it should, or never completing, you can try to [debug the startup script](#debugging-the-startup-script) to resolve the issue. Alternatively, you can try to force the startup script to exit by terminating processes started by it or terminating the startup script itself (on Linux, `ps` and `kill` are useful tools).
428428

429429
For tips on how to write a startup script that doesn't run forever, see the [`startup_script`](#startup_script) section. For more ways to override the startup script behavior, see the [`startup_script_behavior`](#startup_script_behavior) section.
430430

0 commit comments

Comments
 (0)