Files
coder/docs/install/upgrade.md
T
Nick Vigilante ca337915cc docs: fix broken and naked relative links (#25825)
Several relative links in the docs pointed at pages that no longer exist
or rendered incorrectly on coder.com.

Fixes:

- `start/first-template.md`: IDE links repointed from the removed
`../ides.md` / `../ides/web-ides.md` to their current homes under
`user-guides/workspace-access/`.
- `tutorials/example-guide.md`: contributing link repointed to
`../about/contributing/documentation.md`.
- `about/contributing/backend.md`: the `migrations/testdata/fixtures`
and `full_dumps` references (and the `000024_example.up.sql` example)
used relative paths that escape `docs/` and render as bogus
`/docs/coderd/...` routes on the site. Normalized to the canonical
`github.com/coder/coder/(blob|tree)/main/...` form already used by ~120
other source links in the docs.
- Normalized extensionless directory links (`ai-coder/ai-gateway`,
`user-guides/workspace-access`, `install`) to their `/index.md` targets
for consistency with the rest of the docs.

This class of bug is invisible to the local doc checks (`make
lint/markdown` / `pnpm check-docs` only run markdownlint + table
formatting); only CI's Linkspector job validates link targets. Found via
a relative-link audit while investigating the docs preview on #25816.

Source-link version-awareness (so older docs versions don't all point at
`main`) is tracked separately in DOCS-268 and will be handled in the
coder.com render layer.


Linear: DOCS-278

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-01 08:47:29 -04:00

1.7 KiB

Upgrade

This article describes how to upgrade your Coder server.

Caution

Prior to upgrading a production Coder deployment, take a database snapshot since Coder does not support rollbacks.

For upgrade recommendations and troubleshooting, see Upgrading Best Practices.

Reinstall Coder to upgrade

To upgrade your Coder server, reinstall Coder using your original method of install.

Coder install script

  1. If you installed Coder using the install.sh script, re-run the below command on the host:

    curl -L https://coder.com/install.sh | sh
    
  2. If you're running Coder as a system service, you can restart it with systemctl:

    systemctl daemon-reload
    systemctl restart coder
    

Other upgrade methods

docker-compose

If you installed using docker-compose, run the below command to upgrade the Coder container:

docker-compose pull coder && docker-compose up -d coder

Kubernetes

See Upgrading Coder via Helm.

Coder AMI on AWS

  1. Run the Coder installation script on the host:

    curl -L https://coder.com/install.sh | sh
    

    The script will unpack the new coder binary version over the one currently installed.

  2. Restart the Coder system process with systemctl:

    systemctl daemon-reload
    systemctl restart coder
    

Windows

Download the latest Windows installer or binary from GitHub releases, or upgrade from Winget.

winget install Coder.Coder