diff --git a/_quarto.yml b/_quarto.yml index b94abd9..25b023c 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -5,7 +5,7 @@ project: - "*.qmd" website: - announcement: + announcement: icon: info-circle dismissable: false content: "Positron is available for beta testing and [may not yet be a good fit for you](start.qmd#is-positron-for-me). If you are interested in experimenting with it, we welcome your [feedback](feedback.qmd)!" @@ -31,12 +31,12 @@ website: href: "https://docs.posit.co/" - text: "" href: "https://posit.co/" - navbar: + navbar: left: - text: "Get Started" - href: start.qmd + href: start.qmd - text: "Guides" - href: interpreters.qmd + href: interpreters.qmd - text: "Help" href: troubleshooting.qmd @@ -56,11 +56,12 @@ website: - connections-pane.qmd - run-interactive-apps.qmd - updating.qmd + - workbench.qmd - title: "Help" style: "docked" contents: - troubleshooting.qmd - feedback.qmd - - faqs.qmd - + - faqs.qmd + diff --git a/workbench.qmd b/workbench.qmd new file mode 100644 index 0000000..28e25a7 --- /dev/null +++ b/workbench.qmd @@ -0,0 +1,33 @@ +--- +title: "Positron on Workbench" +--- + +Positron is available as a preview feature on [Posit Workbench](https://posit.co/products/enterprise/workbench/) as of its 2024.12.0 release. Important information about using Positron on Posit Workbench is available in the Workbench documentation [for admins](https://docs.posit.co/ide/server-pro/2024.12.0/positron_sessions/) and [for users](https://docs.posit.co/ide/server-pro/user/2024.12.0/positron/getting-started/), but we also want to highlight a few ways to have the best possible experience during this preview period. + +## Install binary R packages on Workbench + +Posit Workbench runs on Linux, but CRAN doesn't build Linux binaries for R packages. You _can_ install R packages using the default configuration, but you will likely find the process extremely slow. Instead, consider using a CRAN-like repository that provides binaries for your Linux architecture, such as [Posit Package Manager](https://packagemanager.posit.co/client/#/repos/cran/setup) and set that via `options()` in R. For example, if your Workbench is installed on Ubuntu 22.04 (Jammy), you would use: + +```r +options(repos = c(CRAN = "https://packagemanager.posit.co/cran/__linux__/jammy/latest")) +``` + +If you run this one time, you will set your `options` for the current R session. If you add this code to the `.Rprofile` in your home directory on Workbench, it will apply to all your R sessions. + +Follow along [on GitHub](https://github.com/posit-dev/positron/issues/5318) to learn about our plans for a better solution in the long term. + +### Resource profiles + +If your administrator has configured [resource profiles](https://docs.posit.co/ide/server-pro/getting_started/installation/kubernetes_installation.html#setup-resource-profiles) on Posit Workbench, you should allocate at least 4 GB of RAM when starting Positron sessions. + +We expect to make performance improvements in the future to decrease the memory needs of Positron. Follow along [on GitHub](https://github.com/posit-dev/positron/issues/5050) to learn about our plans for a better solution in the long term. + +### Python discovery + +We plan to add admin configuration to set defaults for both Python and R interpreters, as well as to control interpreter discovery. In the meantime, we suggest adding [Python interpreters appropriate for use in Workbench to the `PATH`](https://docs.posit.co/ide/server-pro/python/configuring_default.html) to ensure Positron can find and use those Python interpreters. + +Follow along [on GitHub](https://github.com/posit-dev/positron/issues/3574) to learn about our plans for a better solution in the long term. + +:::{.callout-note} +We encourage you as our customer to try out Positron on Workbench and we welcome any feedback via Posit Support, your Posit Customer Success representative, or [directly to the Positron team](/feedback.qmd). During this Public Beta period (before general availability), we recommend that Positron not be used in production. +:::