How to Start Tableau Server in Linux

Getting your Tableau Server up and running on a Linux machine is the first step to sharing dashboards and empowering your team with data. This guide walks you through the exact commands and steps to start the server, verify its status, and troubleshoot some common hiccups along the way.

Graphed

Build AI Agents for Marketing

Build virtual employees that run your go to market. Connect your data sources, deploy autonomous agents, and grow your company.

Build Your First Agent

Before You Begin: Key Prerequisites

Before you jump into the command line, let's quickly cover the essentials. Trying to start the server without these in place is a recipe for errors and frustration. Make sure you have the following:

• Tableau Server Installed: This one might seem obvious, but you need to have already completed the Tableau Server installation process on your Linux distribution (like Ubuntu, RHEL, or CentOS).
• Initialized Server: The server must be initialized. If this is a brand new installation, you've likely just completed this step, which involves setting up identity stores and administrator accounts.
• Sudo Access: The user account you are using must have sudo privileges. Many Tableau Server Management (TSM) commands require elevated permissions to manage system-level services.
• TSM Command Line Interface: You should know how to access the TSM CLI. This is the primary tool for managing your Tableau Server installation on Linux.

Understanding Server Statuses

Tableau Server isn't just "on" or "off." It has several states, and understanding them helps diagnose what's happening. The three most common states you'll encounter are:

• RUNNING: Everything is working as expected. All configured processes are active and communicating correctly. This is the goal.
• DEGRADED: One or more services have failed, but the main gateway process is still running. This means some functionality might be available (like you can log in), but other features will be broken (like refreshing extracts or rendering certain vizzes).
• STOPPED: All Tableau Server processes are down, and the server is completely offline.

Knowing these states is important because after you issue the start command, you need to check which of these states the server lands in.

The Core Command: tsm start

The primary command to bring your Tableau Server online is short and simple. To initiate the startup sequence for all configured services, you use:

tsm start

When you run this command, TSM communicates with the Tableau Server Controller and begins starting all the individual processes - like the Application Server, VizQL Server, Data Server, and Backgrounder - in the correct order. The command prompt will provide updates as it progresses through the startup sequence, which can take several minutes depending on your server's hardware and configuration.

AI Agents for Marketing

Crash Course

Graphed

Free PDF · the crash course

AI Agents for Marketing Crash Course

Learn how to deploy AI marketing agents across your go-to-market — the best tools, prompts, and workflows to turn your data into autonomous execution without writing code.

Download the PDF

Step-by-Step Guide to Starting Tableau Server

Let's put it all together. Here is the exact process from opening your terminal to having a running server.

1. Open a Terminal Session

Connect to your Linux server, either directly or through an SSH client like PuTTY or your local machine's terminal.

2. Log In as a User with Sudo Privileges

Make sure you are logged in as a user who is part of the tsmadmin group or has general sudo rights. Tableau configuration files are owned by the tableau user and managed by the tsmadmin group, so proper permissions are essential.

3. Execute the Start Command

At the command prompt, type the following and press Enter:

tsm start

4. Monitor the Startup Process

The terminal will display real-time feedback. You'll see messages like "Starting services..." and a progress indicator. This process typically takes between 5 to 15 minutes.

The output will look something like this:

67% - Starting service...
80% - Waiting for services to start...
Successfully started the server.

Once you see "Successfully started the server," the command has finished. However, this only means TSM thinks everything worked. Your next step should always be to verify it.

How to Verify the Server is Running Properly

Never assume the server is fully operational just because the start command finished without an error. You need to actively check the status of all its services. The best way to do this is with the status command.

Run the following command in your terminal:

tsm status -v

The -v flag provides a "verbose" output, showing the status of every single service. This is incredibly useful for spotting issues. Here's how to interpret what you see:

• A healthy server will show the overall status as RUNNING and every individual service node will have a status of 'is running' next to it.
• A degraded server will show an overall status of DEGRADED. When you look at the verbose list, you'll see one or more services with a status like 'is in an error state' or 'is stopped'. This is your cue to start troubleshooting.
• A stopped server will show an overall status of STOPPED and indicate that the nodes are unavailable.

You can also perform a final, practical check by simply opening a web browser and navigating to your Tableau Server URL. If the login page appears, it’s a great sign that the most critical services are working.

Graphed

Build AI Agents for Marketing

Build virtual employees that run your go to market. Connect your data sources, deploy autonomous agents, and grow your company.

Build Your First Agent

Troubleshooting Common Startup Problems

Sometimes, things don't go as planned. Here are a few common issues you might face when trying to start Tableau Server on Linux and how to handle them.

Problem 1: Permissions Denied

Symptom: The terminal returns an error immediately, stating you don't have permission to run tsm commands.

Solution: This is almost always a user permissions issue. Your account needs to be part of the tsmadmin group that was created during installation. You can check your group memberships with the groups command. If you're not in the tsmadmin group, a system administrator will need to add you using a command like:

sudo usermod -aG tsmadmin <your_username>

After being added, you'll need to log out and log back in for the changes to take effect.

Problem 2: The Process Hangs or Times Out

Symptom: The tsm start command gets stuck at "Waiting for services to start..." for a very long time (more than 20-30 minutes) and eventually fails with a timeout error.

Solution: This is often caused by insufficient server resources. Tableau Server needs a healthy amount of RAM and CPU to start all its processes. During startup, use tools like top or htop in another terminal window to monitor your server's CPU and memory usage. If you see memory consumption hitting 100% or CPU being maxed out for extended periods, your server is likely under-provisioned. Check your server specifications against Tableau's recommended hardware requirements for your version.

AI Agents for Marketing

Crash Course

Graphed

Free PDF · the crash course

AI Agents for Marketing Crash Course

Learn how to deploy AI marketing agents across your go-to-market — the best tools, prompts, and workflows to turn your data into autonomous execution without writing code.

Download the PDF

Problem 3: The Server Starts in a Degraded State

Symptom: tsm start completes, but tsm status -v reports that the server is DEGRADED because one or more services failed to start (for example, the VizQL Server or Backgrounder).

Solution: This requires a bit of detective work. The Tableau Server logs are your best friend here.

1. First, identify which service is failing from the tsm status -v output.
2. Next, generate a log archive to investigate. Run the following command:

tsm maintenance ziplogs -a -f logs.zip

1. This command will collect all the logs from all nodes into a single logs.zip file in the current directory.
2. Unzip the file and navigate to the directory of the service that failed (e.g., vizqlserver/). Look for the application logs (often files ending in .log) and check for recent ERROR-level messages around the time you tried to start the server. The error messages will often give you a clear reason for the failure, such as configuration issues, database connectivity problems, or file permission errors.

Other Essential TSM Commands: Stopping and Restarting

Your journey as a server administrator will involve more than just starting the server. Here are two other commands that go hand-in-hand with tsm start.

Stopping the Server

To safely shut down all Tableau Server processes, you use the stop command. This is necessary before performing configuration changes, maintenance, or server upgrades.

tsm stop

Restarting the Server

A restart is simply a stop followed by a start. This is useful for applying configuration changes that require a full server refresh. The restart command handles this sequence for you.

tsm restart

Final Thoughts

Starting your Tableau Server in Linux boils down to a single tsm start command, but effectively managing it requires a bit more. Knowing how to verify the system's status with tsm status -v and where to look for logs when things go wrong are the skills that separate a struggling admin from a confident one.

While mastering server administration is a valuable skill for enterprise-level BI, sometimes you just need actionable insights without the infrastructure overhead. We built Graphed to solve this problem. Instead of wrestling with server configurations, you can connect your marketing and sales data sources in seconds and use simple, natural language to instantly build the real-time dashboards you need.