Docker/Singularity Containers

Installation

rworkflows is now available via ghcr.io as a containerised environment with Rstudio and all necessary dependencies pre-installed.

Method 1: via Docker

First, install Docker if you have not already.

Create an image of the Docker container in command line:

docker pull ghcr.io/neurogenomics/rworkflows

Once the image has been created, you can launch it with:

docker run \
  -d \
  -e ROOT=true \
  -e PASSWORD="<your_password>" \
  -v ~/Desktop:/Desktop \
  -v /Volumes:/Volumes \
  -p 8900:8787 \
  ghcr.io/neurogenomics/rworkflows

NOTES

Make sure to replace <your_password> above with whatever you want your password to be.
Change the paths supplied to the -v flags for your particular use case.
The -d ensures the container will run in “detached” mode, which means it will persist even after you’ve closed your command line session.
The username will be “rstudio” by default.
Optionally, you can also install the Docker Desktop to easily manage your containers.

Method 2: via Singularity

If you are using a system that does not allow Docker (as is the case for many institutional computing clusters), you can instead install Docker images via Singularity.

singularity pull docker://ghcr.io/neurogenomics/rworkflows

For troubleshooting, see the Singularity documentation.

Usage

Finally, launch the containerised Rstudio by entering the following URL in any web browser: http://localhost:8900/

Session Info

utils::sessionInfo()

## R version 4.3.3 (2024-02-29)
## Platform: x86_64-pc-linux-gnu (64-bit)
## Running under: Ubuntu 22.04.4 LTS
## 
## Matrix products: default
## BLAS:   /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3 
## LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.20.so;  LAPACK version 3.10.0
## 
## locale:
##  [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C              
##  [3] LC_TIME=en_US.UTF-8        LC_COLLATE=en_US.UTF-8    
##  [5] LC_MONETARY=en_US.UTF-8    LC_MESSAGES=en_US.UTF-8   
##  [7] LC_PAPER=en_US.UTF-8       LC_NAME=C                 
##  [9] LC_ADDRESS=C               LC_TELEPHONE=C            
## [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C       
## 
## time zone: UTC
## tzcode source: system (glibc)
## 
## attached base packages:
## [1] stats     graphics  grDevices utils     datasets  methods   base     
## 
## other attached packages:
## [1] rworkflows_1.0.7
## 
## loaded via a namespace (and not attached):
##  [1] gtable_0.3.5        jsonlite_1.8.8      renv_1.0.7         
##  [4] BiocManager_1.30.22 dplyr_1.1.4         compiler_4.3.3     
##  [7] tidyselect_1.2.1    jquerylib_0.1.4     rvcheck_0.2.1      
## [10] systemfonts_1.0.6   scales_1.3.0        textshaping_0.3.7  
## [13] yaml_2.3.8          fastmap_1.1.1       here_1.0.1         
## [16] ggplot2_3.5.0       R6_2.5.1            generics_0.1.3     
## [19] knitr_1.46          yulab.utils_0.1.4   htmlwidgets_1.6.4  
## [22] tibble_3.2.1        desc_1.4.3          dlstats_0.1.7      
## [25] rprojroot_2.0.4     munsell_0.5.1       bslib_0.7.0        
## [28] pillar_1.9.0        RColorBrewer_1.1-3  rlang_1.1.3        
## [31] utf8_1.2.4          cachem_1.0.8        badger_0.2.3       
## [34] xfun_0.43           fs_1.6.3            sass_0.4.9         
## [37] memoise_2.0.1       cli_3.6.2           pkgdown_2.0.9      
## [40] magrittr_2.0.3      digest_0.6.35       grid_4.3.3         
## [43] lifecycle_1.0.4     vctrs_0.6.5         data.table_1.15.4  
## [46] evaluate_0.23       glue_1.7.0          ragg_1.3.0         
## [49] fansi_1.0.6         colorspace_2.1-0    rmarkdown_2.26     
## [52] purrr_1.0.2         pkgconfig_2.0.3     tools_4.3.3        
## [55] htmltools_0.5.8.1