# Installing and troubleshooting Tableau Server on Linux

*Tableau Architect Study Guide · Deploy Tableau Server · Last updated November 13, 2026 · https://www.certifyforce.com/study-guide/tableau-architect/deploy-tableau-server/installing-and-troubleshooting-tableau-server-on-linux*

How to install and initialize Tableau Server on Linux, choose the initialize-tsm options that cannot change later, and resolve the common locale, path, host name, firewall, font, driver, proxy, log and permission problems on Linux nodes.

- Certification: Salesforce Tableau Architect
- Exam section: Deploy Tableau Server
- Study guide: https://www.certifyforce.com/study-guide/tableau-architect

**Official exam objective:**

> 2.4 Install and verify Tableau Server on Linux: 2.4.1 Install Tableau Server on Linux by using CLI or the Installation Wizard; 2.4.2 Identify and resolve issues with installation on Linux; 2.4.3 Identify and resolve issues with operating system and networking configurations; 2.4.4 Identify and resolve issues with interfaces and interactions with external systems; 2.4.5 Identify and resolve issues with proxy issues; 2.4.6 Identify appropriate operating system logs and Tableau logs for troubleshooting; 2.4.7 Verify system groups and file system permissions.

## What the exam expects

- Install the package and run `initialize-tsm` with every option that cannot be changed afterward, then finish setup through the TSM web UI or CLI.
- Diagnose installation failures caused by locale, data-directory paths, existing accounts, host-name changes and Windows-authored files.
- Open the right firewall ports, supply fonts and the PostgreSQL driver, and configure a forward proxy during or after installation.
- Pick the right Tableau and operating-system log for a failure.
- Verify the unprivileged user, the TSM authorization group and file-system permissions.

Key terms:
- **initialize-tsm:** the one-time script in the scripts directory that creates accounts and starts TSM.
- **Unprivileged user:** the account (default `tableau`) that runs all Tableau Server processes.
- **TSM authorization group:** the Linux group (default `tsmadmin`) whose members may administer TSM.
- **Data directory:** where extracts, logs and data live (default `/var/opt/tableau/tableau_server`).
- **systemd user service:** how TSM services run since 2018.1, under the unprivileged user instead of root.

## Key facts

| Fact | Detail | Source |
|---|---|---|
| Non-default install location | RHEL-like only, via `rpm -i --prefix` | [Before you install](https://help.tableau.com/current/server-linux/en-us/requ.htm) |
| One-time initialize options | Non-default user or group, and data directory | [Install and Initialize TSM](https://help.tableau.com/current/server-linux/en-us/setup.htm) |
| Joining a node | `initialize-tsm -b <bootstrap> -u <admin> --accepteula` | [initialize-tsm help](https://help.tableau.com/current/server-linux/en-us/initialize_tsm-h.htm) |
| `https_proxy` value | Uses `http://` | [initialize-tsm help](https://help.tableau.com/current/server-linux/en-us/initialize_tsm-h.htm) |
| Data directory path | No period or space; not NFS or a symbolic link | [Before you install](https://help.tableau.com/current/server-linux/en-us/requ.htm) |
| License service ports | 27000-27009 on the License node | [Before you install](https://help.tableau.com/current/server-linux/en-us/requ.htm) |
| Admin views driver | PostgreSQL driver on every VizQL Server node | [Troubleshoot on Linux](https://help.tableau.com/current/server-linux/en-us/troubleshoot_linux.htm) |
| Proxy after install | `.conf` in `~tableau/.config/systemd/tableau_server.conf.d` | [Configuring Proxies (Linux)](https://help.tableau.com/current/server-linux/en-us/proxy.htm) |
| Script logs | `/var/tmp`, one per run | [Logs and Locations](https://help.tableau.com/current/server-linux/en-us/logs_loc.htm) |
| Ubuntu systemd log | `/var/log/syslog` via `journalctl` | [Troubleshoot on Linux](https://help.tableau.com/current/server-linux/en-us/troubleshoot_linux.htm) |
| `tsm.authorized.groups` | Overwrites; comma-separated list allowed | [Custom TSM Group](https://help.tableau.com/current/server-linux/en-us/security_tsm_admin_group.htm) |

## Check yourself

- Which fonts ship with Tableau Server on Linux?
- When can the TSM and Gateway ports end up on numbers other than 8850 and 80?
- Why should you not give up on a `tsm` restore that stops showing progress after two hours?
- How do you produce the file passed to `tsm register --file`?

## Sources

- [Before you install... (Linux)](https://help.tableau.com/current/server-linux/en-us/requ.htm)
- [Install and Initialize TSM (Linux)](https://help.tableau.com/current/server-linux/en-us/setup.htm)
- [Help Output for initialize-tsm Script](https://help.tableau.com/current/server-linux/en-us/initialize_tsm-h.htm)
- [Jump-start Installation (Linux)](https://help.tableau.com/current/server-linux/en-us/jumpstart.htm)
- [Troubleshoot Tableau Server on Linux](https://help.tableau.com/current/server-linux/en-us/troubleshoot_linux.htm)
- [Configuring Proxies and Load Balancers for Tableau Server (Linux)](https://help.tableau.com/current/server-linux/en-us/proxy.htm)
- [Tableau Server Logs and Log File Locations (Linux)](https://help.tableau.com/current/server-linux/en-us/logs_loc.htm)
- [Files and Permissions in TSM](https://help.tableau.com/current/server-linux/en-us/file_permissions_tsm.htm)
- [System User, sudo Privileges, and systemd](https://help.tableau.com/current/server-linux/en-us/security_privilege_linux.htm)
- [Configure a Custom TSM Administration Group](https://help.tableau.com/current/server-linux/en-us/security_tsm_admin_group.htm)

## About the full unit

The "Core concepts", "Exam traps" and "Worked scenario" sections of this unit, its 22 linked practice questions, and unlimited timed mock exams are included with the Tableau Architect pack (USD $19): https://www.certifyforce.com/practice-exams