Skip to content

Commit

Permalink
Add rstudio subcommand docs
Browse files Browse the repository at this point in the history
  • Loading branch information
remlapmot committed Oct 25, 2024
1 parent 9baf409 commit 32111a6
Showing 1 changed file with 29 additions and 0 deletions.
29 changes: 29 additions & 0 deletions docs/opensafely-cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -195,6 +195,35 @@ opensafely exec IMAGE bash
This can be useful if you want to explore the image manually.


### `rstudio` - Running RStudio Server

This provides the RStudio interface to the r image, therefore, the versions of R and all the packages are the same as they are in the r image.

To launch an RStudio Server session please navigate to your research repository and run

```bash
opensafely rstudio
```

This will launch an RStudio Server session in a browser window. A message in your terminal will tell you which port to browse to.

In your RStudio Server session you can work on your files as usual, including saving your edits.

If you have an `.Rproj` file at the top level of your repository, the command will detect this and will open the RStudio Server session in RStudio's project mode. In this mode the Git pane is available, so you can make commits, or you can make commits locally as you usually do.

To end your RStudio Server session press ++ctrl+c++ in the Terminal window in which you ran the `opensafely rstudio` command.

Users with Apple Silicon computers need to [enable Rosetta emulation](/install-docker/#macs-with-an-apple-silicon-processor). For Docker Desktop versions between 4.16.0 and 4.24.4 this setting is found in Settings under the _Features in development_ and then _Beta features_ tab. The `opensafely rstudio` command will not run under either the Docker Virtual Machine Manager virtualization nor the legacy QEMU virtualization.

Users with Windows computers will notice that after opening a repository in RStudio project mode that their _.Rproj_ file will have had its line endings changed (from CRLF to LF). This is because RStudio always rewrites .Rproj files on opening a project. This can be overcome by resaving your .Rproj file with LF line endings, committing this change into your repository, then adding a special case, as shown below, to your _.gitattributes_ file to tell Git to always save this file with LF line endings (place this setting after the `* text=auto` line).

```text
*.Rproj text eol=lf
```

An alternative method to open your project in an RStudio Server session is to open your research repository in [Codespaces](/getting-started/how-to/use-github-codespaces-in-your-project/#how-to-access-rstudio).


### `jupyter` - Running JupyterLab

[Jupyter notebooks](https://jupyter.org/) are useful interactive
Expand Down

0 comments on commit 32111a6

Please sign in to comment.