mirror of
https://github.com/coder/coder.git
synced 2026-09-24 15:04:27 +08:00
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>
80 lines
1.7 KiB
Markdown
80 lines
1.7 KiB
Markdown
# 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](./upgrade-best-practices.md).
|
|
|
|
## Reinstall Coder to upgrade
|
|
|
|
To upgrade your Coder server, reinstall Coder using your original method
|
|
of [install](../install/index.md).
|
|
|
|
### Coder install script
|
|
|
|
1. If you installed Coder using the `install.sh` script, re-run the below command
|
|
on the host:
|
|
|
|
```shell
|
|
curl -L https://coder.com/install.sh | sh
|
|
```
|
|
|
|
1. If you're running Coder as a system service, you can restart it with `systemctl`:
|
|
|
|
```shell
|
|
systemctl daemon-reload
|
|
systemctl restart coder
|
|
```
|
|
|
|
### Other upgrade methods
|
|
|
|
<div class="tabs">
|
|
|
|
### docker-compose
|
|
|
|
If you installed using `docker-compose`, run the below command to upgrade the
|
|
Coder container:
|
|
|
|
```shell
|
|
docker-compose pull coder && docker-compose up -d coder
|
|
```
|
|
|
|
### Kubernetes
|
|
|
|
See
|
|
[Upgrading Coder via Helm](../install/kubernetes.md#upgrading-coder-via-helm).
|
|
|
|
### Coder AMI on AWS
|
|
|
|
1. Run the Coder installation script on the host:
|
|
|
|
```shell
|
|
curl -L https://coder.com/install.sh | sh
|
|
```
|
|
|
|
The script will unpack the new `coder` binary version over the one currently
|
|
installed.
|
|
|
|
1. Restart the Coder system process with `systemctl`:
|
|
|
|
```shell
|
|
systemctl daemon-reload
|
|
systemctl restart coder
|
|
```
|
|
|
|
### Windows
|
|
|
|
Download the latest Windows installer or binary from
|
|
[GitHub releases](https://github.com/coder/coder/releases/latest), or upgrade
|
|
from Winget.
|
|
|
|
```pwsh
|
|
winget install Coder.Coder
|
|
```
|
|
|
|
</div>
|