@@ -23,15 +23,15 @@ CRAN or GitHub:
23
23
24
24
❯ installr -h
25
25
Usage: ./installr [ -c | -d ] [ -e ] [ -a pkgs ] [ -t pkgs ] [ -r ] [ -p ] REMOTES ...
26
-
26
+
27
27
Options:
28
28
-c install C and C++ compilers and keep them
29
29
-d install C and C++ compilers, temporarily
30
30
-a install Alpine packages and keep them
31
31
-t install Alpine packages, temporarily
32
32
-p do not remove pak after the installation (ignored if -r is given).
33
33
-e use renv to restore the renv.lock file if present.
34
-
34
+
35
35
REMOTES may be:
36
36
* package names from CRAN/Bioconductor, e.g. ggplot2
37
37
* slugs of GitHub repos, e.g. tidyverse/ggplot2
@@ -50,18 +50,18 @@ To keep the images minimal, they do not include a number of parts and
50
50
features that most users would prefer to have for interactive R
51
51
development:
52
52
53
- - Recommended R packages are not installed.
54
- - Documentation is not included.
55
- - No X11 support.
56
- - No OpenMP support. (But you can configure it for a package, see
57
- [ examples/data.table] ( examples/data.table ) .)
58
- - No JPEG, PNG or TIFF support.
59
- - No Cairo support.
60
- - No Tcl/Tk support.
61
- - No translations, only English.
62
- - The image does not have C, C++ or Fortran compilers.
63
- - Limited time zone data: ` GMT ` , ` UTC ` and ` America/New_York ` , see
64
- below if you need better time zone data.
53
+ - Recommended R packages are not installed.
54
+ - Documentation is not included.
55
+ - No X11 support.
56
+ - No OpenMP support. (But you can configure it for a package, see
57
+ [ examples/data.table] ( examples/data.table ) .)
58
+ - No JPEG, PNG or TIFF support.
59
+ - No Cairo support.
60
+ - No Tcl/Tk support.
61
+ - No translations, only English.
62
+ - The image does not have C, C++ or Fortran compilers.
63
+ - Limited time zone data: ` GMT ` , ` UTC ` and ` America/New_York ` , see below
64
+ if you need better time zone data.
65
65
66
66
## Usage
67
67
@@ -85,7 +85,7 @@ Currently we support the last patch version of the last five minor R
85
85
versions. The ` latest ` tag always uses the last R release.
86
86
87
87
| image | R version | tags | note |
88
- | --------- | ------------- | ----------------------------------------------------------------- | ----------- |
88
+ | ----------- | --------------- | ------------------------------------------------------------------- | ------------- |
89
89
| R devel | 4.5.0-devel | ` devel ` , ` 4.5.0 ` , ` 4.5 ` , ` 4.5.0-devel ` , ` 4.5-devel ` , ` 2024-11-02 ` | Built daily |
90
90
| R next | 4.4.2-Patched | ` next ` , ` patched ` , ` 4.4.2-patched ` , ` 4.4-patched ` | Built daily |
91
91
| R release | 4.4.2 | ` 4.4.2 ` , ` 4.4 ` , ` release ` , ` latest ` | |
@@ -140,8 +140,8 @@ CMD [ "R", "-q", "-e", "pingr::is_online() || stop('offline')" ]
140
140
```
141
141
142
142
Similarly to compilers, system packages are removed after the R packages
143
- have been installed. If you want to keep (some of) them, use `installr
144
- -a` instead of ` installr -t`. (You can also mix the two.)
143
+ have been installed. If you want to keep (some of) them, use
144
+ ` installr -a` instead of ` installr -t ` . (You can also mix the two.)
145
145
146
146
Using with renv:
147
147
@@ -167,8 +167,8 @@ shiny and rmarkdown in a container.
167
167
168
168
Hints on installing some popular R packages:
169
169
170
- | package | installr command | \ ~ image size (uncompressed) |
171
- | ---------- | ------------------------------------------------------------------ | -------------------------------- |
170
+ | package | installr command | ~ image size (uncompressed) |
171
+ | ------------ | -------------------------------------------------------------------- | ---------------------------------- |
172
172
| data.table | See [ examples/data.table] ( examples/data.table ) for OpenMP support | 26.2 MB (50.0 MB) |
173
173
| dplyr | ` installr -d dplyr ` | 31.9 MB (59.7 MB) |
174
174
| ggplot2 | ` installr -d -t gfortran ggplot2 ` | 56.1 MB (93.5 MB) |
@@ -206,29 +206,41 @@ See also the discussion at
206
206
207
207
## Known failures and workarounds
208
208
209
- - The ps package needs the ` linux-headers ` Alpine package at compile
210
- time. Many tidyverse packages depend on ps, so they’ll need it as
211
- well:
212
-
213
- installr -d -t linux-headers ps
214
-
215
- - The arrow package needs a ` Makevars ` file to add a link flag. See
216
- the example ` Dockerfile ` in the [ examples/arrow] ( examples/arrow )
217
- directory.
218
-
219
- - The V8 packagees do not compile on aarch64 machines by default. On
220
- x86\_ 64 it installs fine:
221
-
222
- installr -d -t curl-dev V8
223
-
224
- This means that other packages that need V8 (e.g. rstan and prophet)
225
- do not work on aarch64, either.
226
-
227
- - To install the magick package, you need both the ` imagemagick ` and
228
- ` imagemagick-dev ` Alpine packages, both at install time and run
229
- time:
230
-
231
- installr -d -a "imagemagick imagemagick-dev" -t "curl-dev" magick
209
+ - The ps package needs the ` linux-headers ` Alpine package at compile
210
+ time. Many tidyverse packages depend on ps, so they’ll need it as
211
+ well:
212
+
213
+ installr -d -t linux-headers ps
214
+
215
+ - The arrow package needs a ` Makevars ` file to add a link flag. See the
216
+ example ` Dockerfile ` in the [ examples/arrow] ( examples/arrow )
217
+ directory.
218
+
219
+ - The V8 packagees do not compile on aarch64 machines by default. On
220
+ x86_64 it installs fine:
221
+
222
+ installr -d -t curl-dev V8
223
+
224
+ This means that other packages that need V8 (e.g. rstan and prophet)
225
+ do not work on aarch64, either.
226
+
227
+ - To install the magick package, you need both the ` imagemagick ` and
228
+ ` imagemagick-dev ` Alpine packages, both at install time and run time:
229
+
230
+ installr -d -a "imagemagick imagemagick-dev" -t "curl-dev" magick
231
+
232
+ - pingr 2.0.4 does not build on Alpine, use the dev version:
233
+
234
+ installr -d -t linux-headers r-lib/pingr
235
+
236
+ - Rcpp 1.0.13 [ does not compile with R
237
+ 4.4.2] ( https://github.com/RcppCore/Rcpp/issues/1341 ) . Use the dev
238
+ version of Rcpp until a new version is released on CRAN. This affects
239
+ all packages that depend on Rcpp, naturally. E.g. shiny, V8, rstan,
240
+ odbc, golem, prophet, pagedown, plumber, sf, etc. See the updated
241
+ \[ examples\] .
242
+
243
+ installr -d Rcppcore/Rcpp
232
244
233
245
## License
234
246
0 commit comments