hurl/docs/installation.md
2023-06-01 15:59:52 +02:00

171 lines
3.9 KiB
Markdown

# Installation
## Binaries Installation
### Linux
Precompiled binary is available at [hurl-3.0.1-x86_64-linux.tar.gz]:
```shell
$ INSTALL_DIR=/tmp
$ curl -silent --location https://github.com/Orange-OpenSource/hurl/releases/download/3.0.1/hurl-3.0.1-x86_64-linux.tar.gz | tar xvz -C $INSTALL_DIR
$ export PATH=$INSTALL_DIR/hurl-3.0.1:$PATH
```
#### Debian / Ubuntu
For Debian / Ubuntu, Hurl can be installed using a binary .deb file provided in each Hurl release.
```shell
$ curl --location --remote-name https://github.com/Orange-OpenSource/hurl/releases/download/3.0.1/hurl_3.0.1_amd64.deb
$ sudo apt update && apt install ./hurl_3.0.1_amd64.deb
```
#### Arch Linux / Manjaro
[`hurl-bin` package] for Arch Linux and derived distros is available via [AUR].
#### NixOS / Nix
[NixOS / Nix package] is available on stable channel.
### macOS
Precompiled binary is available at [hurl-3.0.1-x86_64-macos.tar.gz] for x86 CPUs and [hurl-3.0.1-arm64-macos.tar.gz] for ARM CPUS.
#### Homebrew
```shell
$ brew install hurl
```
#### MacPorts
```shell
$ sudo port install hurl
```
### FreeBSD
```shell
$ sudo pkg install hurl
```
### Windows
#### Zip File
Hurl can be installed from a standalone zip file [hurl-3.0.1-win64.zip]. You will need to update your `PATH` variable.
#### Installer
An installer [hurl-3.0.1-win64-installer.exe] is also available.
#### Chocolatey
```shell
$ choco install hurl
```
#### Scoop
```shell
$ scoop install hurl
```
#### Windows Package Manager
```shell
$ winget install hurl
```
### Cargo
If you're a Rust programmer, Hurl can be installed with cargo.
```shell
$ cargo install hurl
```
### Docker
```shell
$ docker pull ghcr.io/orange-opensource/hurl:latest
```
### npm
```shell
$ npm install --save-dev @orangeopensource/hurl
```
## Building From Sources
Hurl sources are available in [GitHub].
### Build on Linux
Hurl depends on libssl, libcurl and libxml2 native libraries. You will need their development files in your platform.
#### Debian based distributions
```shell
$ apt install -y build-essential pkg-config libssl-dev libcurl4-openssl-dev libxml2-dev
```
#### Red Hat based distributions
```shell
$ yum install -y pkg-config gcc openssl-devel libxml2-devel
```
#### Arch based distributions
```shell
$ pacman -Sy --noconfirm pkgconf gcc glibc openssl libxml2
```
### Build on macOS
```shell
$ xcode-select --install
$ brew install pkg-config
```
Hurl is written in [Rust]. You should [install] the latest stable release.
```shell
$ curl https://sh.rustup.rs -sSf | sh -s -- -y
$ source $HOME/.cargo/env
$ rustc --version
$ cargo --version
```
Then build hurl:
```shell
$ git clone https://github.com/Orange-OpenSource/hurl
$ cd hurl
$ cargo build --release
$ ./target/release/hurl --version
```
### Build on Windows
Please follow the [contrib on Windows section].
[GitHub]: https://github.com/Orange-OpenSource/hurl
[hurl-3.0.1-win64.zip]: https://github.com/Orange-OpenSource/hurl/releases/download/3.0.1/hurl-3.0.1-win64.zip
[hurl-3.0.1-win64-installer.exe]: https://github.com/Orange-OpenSource/hurl/releases/download/3.0.1/hurl-3.0.1-win64-installer.exe
[hurl-3.0.1-x86_64-macos.tar.gz]: https://github.com/Orange-OpenSource/hurl/releases/download/3.0.1/hurl-3.0.1-x86_64-macos.tar.gz
[hurl-3.0.1-arm64-macos.tar.gz]: https://github.com/Orange-OpenSource/hurl/releases/download/3.0.1/hurl-3.0.1-arm64-macos.tar.gz
[hurl-3.0.1-x86_64-linux.tar.gz]: https://github.com/Orange-OpenSource/hurl/releases/download/3.0.1/hurl-3.0.1-x86_64-linux.tar.gz
[AUR]: https://wiki.archlinux.org/index.php/Arch_User_Repository
[`hurl-bin` package]: https://aur.archlinux.org/packages/hurl-bin/
[install]: https://www.rust-lang.org/tools/install
[Rust]: https://www.rust-lang.org
[contrib on Windows section]: https://github.com/Orange-OpenSource/hurl/blob/master/contrib/windows/README.md
[NixOS / Nix package]: https://search.nixos.org/packages?from=0&size=1&sort=relevance&type=packages&query=hurl