Docker/Singularity Containers

DockerHub

epiprocess is now available via DockerHub as a containerised environment with Rstudio and all necessary dependencies pre-installed.

Installation

Method 1: via Docker

First, install Docker if you have not already.

Create an image of the Docker container in command line:

docker pull neurogenomicslab/epiprocess

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 8787:8787 \
  neurogenomicslab/epiprocess

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://neurogenomicslab/epiprocess

Usage

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

Session Info

utils::sessionInfo()

## R Under development (unstable) (2022-03-03 r81847)
## Platform: x86_64-pc-linux-gnu (64-bit)
## Running under: Ubuntu 20.04.4 LTS
## 
## Matrix products: default
## BLAS/LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.8.so
## 
## 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       
## 
## attached base packages:
## [1] stats     graphics  grDevices utils     datasets  methods   base     
## 
## other attached packages:
## [1] EpiProcess_0.99.0 BiocStyle_2.23.1 
## 
## loaded via a namespace (and not attached):
##  [1] knitr_1.37          magrittr_2.0.2      R6_2.5.1           
##  [4] ragg_1.2.2          rlang_1.0.2         fastmap_1.1.0      
##  [7] stringr_1.4.0       tools_4.2.0         xfun_0.30          
## [10] cli_3.2.0           jquerylib_0.1.4     systemfonts_1.0.4  
## [13] htmltools_0.5.2     yaml_2.3.5          digest_0.6.29      
## [16] rprojroot_2.0.2     pkgdown_2.0.2.9000  bookdown_0.24      
## [19] textshaping_0.3.6   BiocManager_1.30.16 purrr_0.3.4        
## [22] sass_0.4.0          fs_1.5.2            memoise_2.0.1      
## [25] cachem_1.0.6        evaluate_0.15       rmarkdown_2.12     
## [28] stringi_1.7.6       compiler_4.2.0      bslib_0.3.1        
## [31] desc_1.4.1          jsonlite_1.8.0

Authors: Brian Schilder, Leyla Abbasova