Customizing the Sign-In Page

You can customize the content and appearance of the Posit Workbench sign-in page by including custom HTML within the page. This is accomplished by either:

• Providing a file at /etc/rstudio/login.html that includes additional HTML to include within the login page; or

• Specifying the auth-login-page-html option within the rserver.conf config file which points to an alternate location for the login HTML file. For example, the following specifies that the file located at /opt/config/rstudio-login.html should be included within the login page:

  # /etc/rstudio/rserver.conf
  auth-login-page-html=/opt/config/rstudio-login.html

The contents of the specified HTML file will be included after the standard login header and login username/password form. If you want to modify the appearance of the header and/or add content above the username/password form, you can use CSS and JavaScript within your login.html file to modify the page after it loads.

Important

Posit supports the mechanism for customizing the sign-in page (the login.html file and the auth-login-page-html option), but the contents of your custom HTML, CSS, and JavaScript are your own responsibility to create and maintain.

Posit Workbench releases may change the sign-in page’s structure or styling (for example, the placement of default branding elements). Such changes can affect the layout or behavior of your custom content. After upgrading, review your sign-in page customizations and update them as needed.