# Installation

termscp is available for many platforms. Pick the method that matches your
system below.

## Linux, FreeBSD, and macOS

This shell script installs termscp on your system with a single command:

```sh
curl --proto '=https' --tlsv1.2 -sSLf https://termscp.rs/install.sh | sh
```

On macOS the installation requires [Homebrew](https://brew.sh/); otherwise the
Rust compiler is installed to build termscp from source.

## Windows

Install termscp from PowerShell with a single command:

```ps
irm https://termscp.rs/install.ps1 | iex
```

Alternatively, install it with [Chocolatey](https://chocolatey.org/):

```ps
choco install termscp
```

## NetBSD

Install termscp from the official repositories:

```sh
pkgin install termscp
```

## Arch Linux

Install termscp from the official repositories:

```sh
pacman -S termscp
```

## Official binaries

Official release binaries are published for these targets:

- GNU/Linux:
  - `x86_64-unknown-linux-musl`
  - `aarch64-unknown-linux-musl`
- macOS:
  - `x86_64-apple-darwin`
  - `aarch64-apple-darwin`
- Windows:
  - `x86_64-pc-windows-msvc`
  - `aarch64-pc-windows-msvc`

The Linux binaries, and the `.deb` package built from them, are statically
linked against musl. They have no runtime dependencies: they run on any Linux
distribution and any glibc version, with no system packages to install.

## Requirements

The official binaries do not require these dependencies. They are needed only
to build termscp from source, for example with `cargo install termscp`:

- Linux users:
  - libdbus-1
  - pkg-config
  - libsmbclient
- FreeBSD and NetBSD users:
  - dbus
  - pkgconf
  - libsmbclient

### Optional requirements

These dependencies are not required to run termscp, but they are needed to
enjoy all of its features.

- Linux and FreeBSD users, to open files via `V` (at least one of these):
  - xdg-open
  - gio
  - gnome-open
  - kde-open
- Linux users: a keyring manager. Read more in the
  [Password security](../configuration/password-security.md) page.
- WSL users, to open files via `V`:
  - [wslu](https://github.com/wslutilities/wslu)

## Updating termscp

To update termscp to the latest version, run it from the command line with:

```sh
(sudo) termscp update
```

For all platforms and methods, see <https://termscp.rs/install>.