# Installation

Install `httpgd` from CRAN:

    install.packages("httpgd")

Or get the latest development version from GitHub:

    remotes::install_github("nx10/httpgd")

See system requirements for troubleshooting.

## System requirements

Depends on `R` version ≥ 4.0 on windows, and R ≥ 3.2 on linux and macOS (a C++ compiler with basic C++17 support is required).

Note that there is a rare bug in R versions < 4.1, that leads to some plots disappearing when ggplot2 plots are resized and deleted in a specific way.

`libpng` and X11 are required on unix like systems (e.g. Linux, macOS). `Cairo` is required on unix like systems to enable PNG, PDF, EPS and PS renderers.

### macOS

If `libpng` is missing install it via:

    brew install libpng

If `X11` is missing the error message will include the text:

    unable to load shared object [...] systemfonts/libs/systemfonts.so [...]

Install `XQuartz`. (see: https://github.com/r-lib/systemfonts/issues/17)

### Linux

For source installation on Linux, the fontconfig freetype2 library is required to install the `{systemfonts}` package, which is a dependency of `httpgd`.

#### Debian, Ubuntu, etc.

    apt install libfontconfig1-dev

#### Fedora, CentOS, RHEL, etc.

    dnf install fontconfig-devel