Using a Custom Landing Page

Overview

It is possible to specify a custom landing page that your anonymous/logged-out users see when they visit RStudio Connect.

Configuration

Use the Server.LandingDir configuration setting to specify the path to a custom landing page. We recommend using an absolute path to the directory containing your landing page. If you do not specify an absolute path, the server resolves the path as relative to your RStudio Connect installation hierarchy (typically /opt/rstudio-connect).

Custom Landing Page Assets

Include all assets (JavaScript, CSS, images, etc.) for your custom landing page in the directory you specified in the Server.LandingDir configuration setting. Be sure to include an index.html, which will be served by default.

Example

Your RStudio Connect installation includes an example landing page in the /opt/rstudio-connect/examples/landing-page directory. Feel free to use this content when building your own landing page.

Note

The examples/landing-page directory should be used as a reference. Do not use this location for your landing page, as it will be overwritten on upgrades of RStudio Connect.

Here are the settings to use this example landing page:

; /etc/rstudio-connect/rstudio-connect.gcfg
[Server]
LandingDir = /opt/rstudio-connect/examples/landing-page