2024-03-08 15:15:59 +00:00
|
|
|
# Installing Coder
|
2022-09-08 19:41:00 +00:00
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
A single CLI (`coder`) is used for both the Coder server and the client.
|
2024-01-10 12:00:19 +00:00
|
|
|
|
2024-04-03 21:43:49 +00:00
|
|
|
We support two release channels: mainline and stable - read the
|
|
|
|
[Releases](./releases.md) page to learn more about which best suits your team.
|
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
There are several ways to install Coder. For production deployments with 50+
|
|
|
|
users, we recommend [installing on Kubernetes](./kubernetes.md). Otherwise, you
|
|
|
|
can install Coder on your local machine or on a VM:
|
2024-01-10 12:00:19 +00:00
|
|
|
|
|
|
|
<div class="tabs">
|
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
## Linux/macOS
|
2024-01-10 12:00:19 +00:00
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
Our install script is the fastest way to install Coder on Linux/macOS:
|
2024-01-10 12:00:19 +00:00
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
```sh
|
|
|
|
curl -L https://coder.com/install.sh | sh
|
2024-01-10 12:00:19 +00:00
|
|
|
```
|
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
Refer to [GitHub releases](https://github.com/coder/coder/releases) for
|
|
|
|
alternate installation methods (e.g. standalone binaries, system packages).
|
2024-01-10 12:00:19 +00:00
|
|
|
|
|
|
|
## Windows
|
|
|
|
|
2024-04-26 09:56:43 +00:00
|
|
|
> **Important:** If you plan to use the built-in PostgreSQL database, you will
|
|
|
|
> need to ensure that the
|
|
|
|
> [Visual C++ Runtime](https://learn.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist#latest-microsoft-visual-c-redistributable-version)
|
|
|
|
> is installed.
|
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
Use [GitHub releases](https://github.com/coder/coder/releases) to download the
|
|
|
|
Windows installer (`.msi`) or standalone binary (`.exe`).
|
2024-01-10 12:00:19 +00:00
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
![Windows setup wizard](../images/install/windows-installer.png)
|
2024-01-10 12:00:19 +00:00
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
Alternatively, you can use the
|
2024-01-10 12:00:19 +00:00
|
|
|
[`winget`](https://learn.microsoft.com/en-us/windows/package-manager/winget/#use-winget)
|
2024-03-08 15:15:59 +00:00
|
|
|
package manager to install Coder:
|
2024-01-10 12:00:19 +00:00
|
|
|
|
|
|
|
```powershell
|
|
|
|
winget install Coder.Coder
|
|
|
|
```
|
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
## Other
|
2024-01-10 12:00:19 +00:00
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
<children></children>
|
2024-01-10 12:00:19 +00:00
|
|
|
|
|
|
|
</div>
|
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
To start the Coder server:
|
2024-01-10 12:00:19 +00:00
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
```sh
|
|
|
|
coder server
|
2024-01-10 12:00:19 +00:00
|
|
|
```
|
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
![Coder install](../images/install/coder-setup.png)
|
2024-01-10 12:00:19 +00:00
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
To log in to an existing Coder deployment:
|
2024-01-10 12:00:19 +00:00
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
```sh
|
|
|
|
coder login https://coder.example.com
|
|
|
|
```
|
2024-01-10 12:00:19 +00:00
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
## Next up
|
2024-01-10 12:00:19 +00:00
|
|
|
|
2024-03-08 15:15:59 +00:00
|
|
|
- [Create your first template](../templates/tutorial.md)
|