5.8 KiB
To use Coder you will need to install the Coder server on your infrastructure. There are a number of different ways to install Coder, depending on your needs.
This page is rendered on https://coder.com/docs/v2/latest/install. Refer to the other documents in the `install/` directory for per-platform instructions.Install Coder
Linux
Install Script
The easiest way to install Coder on Linux is to use our install script.
curl -fsSL https://coder.com/install.sh | sh
You can preview what occurs during the install process:
curl -fsSL https://coder.com/install.sh | sh -s -- --dry-run
You can modify the installation process by including flags. Run the help command for reference:
curl -fsSL https://coder.com/install.sh | sh -s -- --help
Homebrew
To install Coder on Linux, you can use the Homebrew package manager that uses our official Homebrew tap.
brew install coder/coder/coder
System Packages
Coder officially maintains packages for the following Linux distributions:
- .deb (Debian, Ubuntu)
- .rpm (Fedora, CentOS, RHEL, SUSE)
- .apk (Alpine)
Debian, Ubuntu
For Debian and Ubuntu, get the latest .deb
package from our
GitHub releases and install it
manually or use the following commands to download and install the latest .deb
package.
# Install the package
sudo apt install ./coder.deb
RPM Linux
For Fedora, CentOS, RHEL, SUSE, get the latest .rpm
package from our
GitHub releases and install it
manually or use the following commands to download and install the latest .rpm
package.
# Install the package
sudo yum install ./coder.rpm
Alpine
Get the latest .apk
package from our
GitHub releases and install it
manually or use the following commands to download and install the latest .apk
package.
# Install the package
sudo apk add ./coder.apk
Manual
Get the latest .tar.gz
package from our
GitHub releases and install it
manually.
-
Download the release archive appropriate for your operating system
-
Unzip the folder you just downloaded, and move the
coder
executable to a location that's on yourPATH
mv coder /usr/local/bin
macOS
Homebrew
To install Coder on macOS, you can use the Homebrew package manager that uses our official Homebrew tap.
brew install coder/coder/coder
Install Script
The easiest way to install Coder on macOS is to use our install script.
curl -fsSL https://coder.com/install.sh | sh
You can preview what occurs during the install process:
curl -fsSL https://coder.com/install.sh | sh -s -- --dry-run
You can modify the installation process by including flags. Run the help command for reference:
curl -fsSL https://coder.com/install.sh | sh -s -- --help
Windows
Winget
To install Coder on Windows, you can use the
winget
package manager.
winget install Coder.Coder
Installer
Download the Windows installer from our GitHub releases and install it.
Manual
Get the latest .zip
package from our GitHub releases page and extract it to a
location that's on your PATH
or add the extracted binary to your PATH
.
Windows users: see this guide for adding folders to
PATH
.
Verify installation
Verify that the installation was successful by opening a new terminal and running:
coder --version
Coder v2.6.0+b3e3521 Thu Dec 21 22:33:13 UTC 2023
https://github.com/coder/coder/commit/b3e352127478bfd044a1efa77baace096096d1e6
Full build of Coder, supports the server subcommand.
...
Start Coder
-
After installing, start the Coder server manually via
coder server
or as a system package.Terminal
# Automatically sets up an external access URL on *.try.coder.app coder server # Requires a PostgreSQL instance (version 13 or higher) and external access URL coder server --postgres-url <url> --access-url <url>
System Package (Linux)
Run Coder as a system service.
# (Optional) Set up an access URL sudo vim /etc/coder.d/coder.env # To systemd to start Coder now and on reboot sudo systemctl enable --now coder # View the logs to see Coder URL and ensure a successful start journalctl -u coder.service -b
Set
CODER_ACCESS_URL
to the external URL that users and workspaces will use to connect to Coder. This is not required if you are using the tunnel. Learn more about Coder's configuration options.By default, the Coder server runs on
http://127.0.0.1:3000
and uses a public tunnel for workspace connections. -
Visit the Coder URL in the logs to set up your first account, or use the CLI to create your first user.
coder login <access url>