Files
coder[bot] d91aa1bebd docs: replace may with can or might per the Vale spike review (#31878)
Replaces `may` with `can` (ability or permission) or `might`
(possibility), following
`word-choice.md#choose-words-that-have-one-meaning`. The Vale findings
spike review marked every `may` row valid.

- 247 lines in 110 files: 75 became `can` and 162 became `might`. The
rest are small rewordings, such as "may wish" becoming "might want".
- Applied the reviewer notes:
- `.style/content-guidelines.md`: "docs may be written ahead" is now
"you can write docs ahead", which also drops the passive voice.
- `admin/external-auth.md`: now "You can grant access to a subset of
repositories.", so the sentence doesn't end on a preposition.
- Also fixed a typo in `gcp-to-aws.md`: "may needed" is now "might
need".

## Left as-is

- **`admin/setup/configuration-reference.md` (7 lines):** this page is
generated from `codersdk` deployment options (`<!-- DO NOT EDIT |
GENERATED CONTENT -->`), so the fix belongs in the Go option
descriptions, followed by `make gen`.
- **Text that quotes the product:**
- `admin/monitoring/health-check.md:196` matches the derphealth message.
- The heading at `templates/troubleshooting.md:45`, the first "may" on
line 47, and the link on line 67 match the web terminal's "your
workspace may be incomplete" warning and its anchor.
- `admin/integrations/oauth2-provider/troubleshooting.md:269` quotes a
server error.

The changed files have no new findings from other rules.

---
AI-generated by Superblink on behalf of @nickvigilante.

---------

Co-authored-by: coder[bot] <137810501+coder[bot]@users.noreply.github.com>
2026-11-06 17:17:35 -05:00

2.9 KiB

title
title
Administration

Admin settings general page

These guides contain information on managing the Coder control plane and authoring templates.

First time viewers looking to set up control plane access can start with the configuration guide. If you're a team lead looking to design environments for your developers, refer to our templates guides. If you are a developer using Coder, we recommend the user guides.

For automation and scripting workflows, see our CLI and API docs.

For any information not strictly contained in these sections, refer to our frequently asked questions (FAQs).

What is an image, template, dev container, or workspace

Image

  • A base image contains OS-level packages and utilities that the Coder workspace is built on. It can be an example image, custom image in your registry, or one from Docker Hub. It is defined in each template.
  • Managed by: Externally to Coder.

Template

  • Templates include infrastructure-level dependencies for the workspace. For example, a template can include Kubernetes PersistentVolumeClaims, Docker containers, or Amazon Elastic Compute Cloud (EC2) VMs.
  • Managed by: Template administrators from within the Coder deployment.

Startup scripts

  • Agent startup scripts apply to all users of a template. This is an intentionally flexible area that template authors have at their disposal to manage the "last mile" of workspace creation.
  • Managed by: Coder template administrators.

Workspace

  • A workspace is the environment that a developer works in. Developers on a team each work from their own workspace and can use multiple IDEs.
  • Managed by: Developers

Development containers (dev containers)

  • A Development Container is an open-source specification for defining development environments (called dev containers). It is generally stored in a version control system (VCS) alongside associated source code. It can reference an existing base image, or a custom Dockerfile that will be built on-demand.
  • Managed by: Dev Teams

Dotfiles / personalization

  • Users might have their own specific preferences relating to shell prompt, custom keybindings, color schemes, and more. Users can leverage Coder's dotfiles support or create their own script to personalize their workspace. Be aware that users with root permissions in their workspace can override almost all of the previous configuration.
  • Managed by: Individual Users