Skip to content
Tutorials Center
My learning

Topics

Lesson 3 of 36 ยท Getting Started

Install Splunk Enterprise and Sign In for the First Time

Step-by-step Splunk Enterprise installation on Windows and Linux, starting the service, opening Splunk Web on port 8000, creating the admin user and basic checks.

A one-machine installation is the best lab for this course: it runs the web interface, the indexer and the search engine in a single process tree. In this lesson you install Splunk Enterprise, start it, sign in and confirm that it works. Because the installer cannot run here, you will follow the steps on your own computer. Stand-ins below check ports and commands so you recognize common problems.

Before you install

  • Hardware for a lab: a modern laptop with 8 GB of RAM or more and a few GB of disk is enough. Production sizing is far larger (see deployment topologies and sizing).
  • Account: download the package from the vendor's website (a free account is required). Choose the package for your operating system.
  • Ports: Splunk Web listens on 8000, the management port (splunkd REST API) is 8089, and receiving indexers usually listen on 9997. Make sure nothing else uses these.
  • Time: correct system clock and time zone matter, because everything in Splunk is time-based.

Install on Windows

  1. Run the .msi installer and accept the license.
  2. Choose Customize Options if you want to change the install folder (default C:\Program Files\Splunk).
  3. Pick the account that runs the service. For a lab, Local System is fine; production uses a dedicated service account.
  4. Create the administrator username and a strong password when prompted.
  5. Finish. Splunk installs as a Windows service named Splunkd Service and opens Splunk Web.

Install on Linux

Most production Splunk runs on Linux. With a .tgz package:

Terminal
# create a dedicated user (recommended, never run as root)
sudo useradd -m splunk

# extract into /opt (creates /opt/splunk)
sudo tar -xzf splunk-<version>-linux-amd64.tgz -C /opt
sudo chown -R splunk:splunk /opt/splunk

# first start: accept the license and set admin credentials
sudo -u splunk /opt/splunk/bin/splunk start --accept-license

The first start asks you for an administrator name and password, creates the folders, and prints the Splunk Web address. To start Splunk at boot, run as root:

Terminal
sudo /opt/splunk/bin/splunk enable boot-start -user splunk

$SPLUNK_HOME is the install folder (/opt/splunk or C:\Program Files\Splunk). All commands live in $SPLUNK_HOME/bin.

Everyday service commands

Terminal
splunk start
splunk stop
splunk restart
splunk status
splunk version

If splunk is not found, call it by its full path or add $SPLUNK_HOME/bin to your PATH. Configuration changes often require a restart; you will see a banner in Splunk Web when one is needed.

Python Stand-in: checking the default Splunk ports for conflicts

Press Run (or Ctrl + Enter) to see the result here.

Program input ยท what you'd type while the program runs

Type the answers before you press Run, one per line. Each time the program reads a line (with input()), it gets the next line from this box.

If port 8000 is taken, Splunk offers to use another port during start-up, or you can change it later in Settings > Server settings > General settings > Web port.

First login

  1. Open http://localhost:8000 (or http://<server-name>:8000).
  2. Sign in with the administrator name and password you created.
  3. A Welcome dialog and a short tour may appear; you can dismiss them.
  4. The Home page shows the apps list (left), Explore Splunk Enterprise panels and any configured dashboards.

Splunk Web uses HTTP by default. For anything beyond a lab, enable HTTPS in Settings > Server settings > General settings > Enable SSL (HTTPS) in Splunk Web.

Do not expose port 8000 or 8089 directly to the Internet. Put the instance behind a firewall or VPN and enable HTTPS and strong passwords.

Verify the install

  • Settings > Server settings > Server info shows version, build, OS and the instance name.
  • Settings > Licensing shows the license type and the daily allowance.
  • Run your first search in the Search & Reporting app:
SPL
index=_internal | head 10

_internal is an index that Splunk itself fills with its own logs, so it always has data. If you see events, indexing and searching work end to end.

Python Stand-in: what a first search does

Press Run (or Ctrl + Enter) to see the result here.

Program input ยท what you'd type while the program runs

Type the answers before you press Run, one per line. Each time the program reads a line (with input()), it gets the next line from this box.

Upgrading and uninstalling

To upgrade, stop Splunk, install the new package over the old one (same folder, same user) and start it; Splunk migrates settings on first start. Always back up $SPLUNK_HOME/etc first. To uninstall on Windows use Add/Remove Programs; on Linux stop Splunk and delete the folder.

Common problems

Symptom Likely cause Fix
Browser cannot connect Service not running or firewall splunk status; open port 8000
Login loop Cookies or clock skew Clear cookies; check the time
"Port already in use" Another app on 8000/8089 Change the port or stop the other app
Low-disk warnings, searches paused Less than the minimum free space Free disk space; Splunk pauses indexing when disk is nearly full

Check your understanding

Quick check ยท 4 questions

of 4 answered You scored / 4 ยท perfect!

  1. 1. Which port does Splunk Web use by default?

    8000 is Splunk Web, 8089 is the management port, 9997 is the usual forwarder receiving port.
  2. 2. Which search confirms that indexing and search work on a fresh install?

    The _internal index holds Splunk's own logs, so it always contains events.
  3. 3. Which command starts Splunk from the command line?

    splunk start, stop, restart and status control the service.
  4. 4. Why should you not run Splunk as root on Linux?

    Use a dedicated low-privilege account, a normal security practice.

Summary

  • Install Splunk Enterprise on a lab machine; default ports are 8000, 8089 and 9997.
  • On Linux use a dedicated splunk user and splunk start --accept-license.
  • Sign in at http://localhost:8000 and verify with index=_internal | head 10.
  • Back up $SPLUNK_HOME/etc before upgrades and never expose management ports publicly.

Next: A tour of Splunk Web