{"id":14068663,"url":"https://github.com/reconhub/deployer","last_synced_at":"2026-02-19T07:35:56.060Z","repository":{"id":68939231,"uuid":"92920022","full_name":"reconhub/deployer","owner":"reconhub","description":"Self-contained R environment on a thumb drive","archived":false,"fork":false,"pushed_at":"2020-10-20T10:15:10.000Z","size":20601,"stargazers_count":11,"open_issues_count":4,"forks_count":3,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-07-25T13:55:56.176Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/reconhub.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-05-31T07:54:34.000Z","updated_at":"2025-07-13T23:12:43.000Z","dependencies_parsed_at":"2023-03-11T04:39:23.093Z","dependency_job_id":null,"html_url":"https://github.com/reconhub/deployer","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/reconhub/deployer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reconhub%2Fdeployer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reconhub%2Fdeployer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reconhub%2Fdeployer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reconhub%2Fdeployer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/reconhub","download_url":"https://codeload.github.com/reconhub/deployer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reconhub%2Fdeployer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267809494,"owners_count":24147475,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-30T02:00:09.044Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-13T07:06:20.035Z","updated_at":"2026-02-19T07:35:56.025Z","avatar_url":"https://github.com/reconhub.png","language":"R","funding_links":[],"categories":["R"],"sub_categories":[],"readme":"\n\u003cimg src=\"inst/img/logo_deployer.png\" width=\"600px\"\u003e\n\n\u003cbr\u003e\n\n\nThe *RECON deployer* project focusses on distributing an R environment for outbreak response on a thumb drive. This environment should provide:\n\n* the latest stable version of R for Windows and MacOSX\n\n* the corresponding version of Rtools\n\n* the latest stable version of Rstudio for Windows and MacOSX\n\n* a large selection of relevant R packages hosted on CRAN\n\n* all RECON packages hosted on github (sources)\n\n* some other packages hosted on github, required by the above\n\n* scripts to permit seemless installation of the local CRAN and github packages \n\n\n## Using a *deployer*\n\nYou can find versioned releases of deployers at \nhttps://github.com/reconhub/deployer/releases that detail how the deployer was\nbuilt and how to download/decompress it. If you want to build one from scratch,\nsee Building a new deployer\n\nThe *RECON deployer* is meant to be copied on a USB stick, although strictly\nspeaking it is medium-agnostic. To use the *deployer*, go to the folder where it\nis stored, open the file called `README.html`, and follow the instructions\nprovided there.\n\n\n## Building a new *deployer*\n\nTo build/generate a new *deployer*, you can use the R script [`generate_deployer.R`](./generate_deployer.R):\n\n```\ncd ..\nRscript reconhub--deployer/generate_deployer.R\n```\n\n### Details\n\nThe RECON Deployer is an application of `nomad`, a R package for creating\nportable R environments. This script will do the following:\n\n1. attempt to upgrade [provisioner](https://github.com/mrc-ide/provisionr) and \n   [nomad](https://github.com/reconhub/nomad)\n2. generate the deployer\n3. split the deployer into 4 compressed files with md5sums that can be [uploaded\n   to github for release](https://github.com/reconhub/deployer/releases/new )\n\nThe files you end up with are:\n\n| File name          | Description                                    |\n|--------------------|------------------------------------------------|\n|`\u003cname\u003e/`           | Source Directory for the deployer              |\n|`\u003cname\u003e_md5sums.txt`| summary of the above files                     |\n|`\u003cname\u003e_release.md` | release page to be placed on github            |\n|                    |                                                |\n|`\u003cname\u003e_base.tar`   | source packages, cheat sheets, and instructions|\n|`\u003cname\u003e_extra.tar`  | binaries for R, git, Rtools, and RStudio       |\n|`\u003cname\u003e_macosx.tar` | binary packages built for macos                |\n|`\u003cname\u003e_windows.tar`| binary packages built for windows              |\n\n\u003e Note: These will likely be over 1GB each, so make sure you have a strong\n\u003e internet connection when uploading these to github.\n\nOnce downloaded from the github release page, the users can decompress the files\nvia R:\n\n```r\nuntar('\u003cname\u003e_base.tar')\nuntar('\u003cname\u003e_extra.tar')\nuntar('\u003cname\u003e_macosx.tar')\nuntar('\u003cname\u003e_windows.tar')\n```\n\n### Generating the deployer manually\n\nThe RECON Deployer is an application of `nomad`, a R package for creating\nportable R environments. You first need to install this package, which also depends on `provisionr`:\n\n```r\nremotes::install_github(\"mrc-ide/provisionr\", upgrade = FALSE)\nremotes::install_github(\"reconhub/nomad\", upgrade = FALSE)\n```\n\nTo create a deployer in a given directory named `deployer_[date]`, type:\n\n```r\nout_dir \u003c- paste(\"deployer\", gsub(\"-\", \"_\", Sys.Date()), sep = \"_\")\nnomad::build(\"reconhub/deployer\", out_dir)\n```\n\n\n## Adding or updating packages \n\nIf you need to add or update an R package, you can use the [`add_packages.R`](./add_packages.R)\nscript with the names of the CRAN packages to use.\n\n```\nRscript add_packages.R officer kableExtra\n```\n\nIf you have non-cran packages, then be sure to add the github repositories to\n[`package_sources.txt`](./package_sources.txt).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freconhub%2Fdeployer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Freconhub%2Fdeployer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freconhub%2Fdeployer/lists"}