Configuring Tableau Server for R and Rserve

Published: 14 Jul 2014
Last Modified Date: 21 Jul 2020


How to configure Tableau Server for use with R and Rserve.


Tableau Server 


Step 1: Install and Configure R and Rserve

Install R and run the Rserve service. For more information on installing and configuring R, see R Implementation Notes.

To support running both SSL-enabled and plaintext connections to an Rserve instance, the Rserve Server administrator must add the following entry to the Rserve configuration file on the Rserve Server:  plaintext enable

Note: It is not recommended to install any other server applications or databases, including R, on the computers running Tableau Server. When R is not installed on the computer running Tableau Server, it must be configured for a remote connection.

Step 2: Configure Tableau Server

Tableau Server 10.5 to 2018.1: 

  1. Stop Tableau Server.
  2. Open the Command Prompt as an administrator and change to the Tableau Server bin directory. For example:
    • cd "C:\Program Files\Tableau\Tableau Server\10.5\bin"
  3. Enter the following commands to set the host address and port values:
    • tabadmin set <ip address of Rserve>
    • tabadmin set vizqlserver.extsvc.port <port of Rserve>
    • tabadmin set vizqlserver.extsvc.username <Rserve username>
    • tabadmin set vizqlserver.extsvc.password <Rserve password>
  4. Enter the following command to register the changes:
    • tabadmin config
  5. Start Tableau Server.

Tableau Server 2018.2 – 2020.1 (Windows) / Tableau Server 10.5 – 2020.1 (Linux):  

  1. Open TSM command line/shell.
  2. Enter the following command to configure the connection to Rserve:
    • tsm security vizql-extsvc-ssl enable --connection-type [rserve, rserve-secure] --extsvc-host <host_name> --extsvc-port <port>
  3. Apply Pending Changes (Tableau Server will restart)
    • tsm pending-changes apply
For more information on this command, see

Tableau Server 2020.1 and later (Windows and Linux):

More information can be found in the following article:
Did this article resolve the issue?