Splunk® Enterprise

Installation Manual

Download manual as PDF

This documentation does not apply to the most recent version of Splunk. Click here for the latest version.
Download topic as PDF

Start Splunk Enterprise for the first time

Before you begin using your new Splunk Enterprise upgrade or installation, take a few moments to make sure that the software and your data are secure. For more information, see Hardening Standards in the Securing Splunk Enterprise manual.

If you start Splunk Enterprise with the --no-prompt CLI argument, then the software does not prompt you to create the administrator password. If you do not create a password, then upon login, Splunk displays a message that there is no user, and you are unable to log into Splunk Enterprise. You must then manually create the credentials before you can log in. See "Create admin credentials manually" later in this topic for instruction on creating the credentials.

On Windows

You can start Splunk Enterprise on Windows using either the command line or the Services control panel. Using the command line offers more options.

From a command prompt or PowerShell window, run the following commands:

cd <Splunk Enterprise installation directory>\bin
splunk start

(For Windows users: in subsequent examples and information, replace $SPLUNK_HOME with C:\Program Files\Splunk if you have installed Splunk in the default location. You can also add %SPLUNK_HOME% as a system-wide environment variable by using the Advanced tab in the System Properties dialog box.)

On UNIX

  1. Use the Splunk Enterprise command-line interface (CLI):
    cd <Splunk Enterprise installation directory>/bin
    ./splunk start
    
  2. Create your admin credentials.
    This appears to be your first time running this version of Splunk.
    
    An Admin password must be set before installation proceeds.
    Password must contain at least:
    * 8 total printable ASCII character(s).
    Please enter a new password:
  3. If the default management and Splunk Web ports are already in use (or are otherwise not available), Splunk Enterprise offers to use the next available ports. You can either accept this option or specify a port to use.
  4. You can optionally set the SPLUNK_HOME environment variable to the Splunk Enterprise installation directory. Setting the environment variable lets you refer to the installation directory later without having to remember its exact location:
    export SPLUNK_HOME=<Splunk Enterprise installation directory>
    cd $SPLUNK_HOME/bin
    ./splunk start
    
  5. Splunk Enterprise displays the license agreement and prompts you to accept before the startup sequence continues.

On Mac OS X

Start Splunk Enterprise from the Finder

  1. Double-click the Splunk icon on the Desktop to launch the helper application, entitled "Splunk's Little Helper".
  2. Click OK to allow Splunk to initialize and set up the trial license.
  3. (Optional) Click Start and Show Splunk to start Splunk Enterprise and direct your web browser to open a page to Splunk Web.
  4. (Optional) Click Only Start Splunk to start Splunk Enterprise, but not open Splunk Web in a browser.
  5. (Optional) Click Cancel to quit the helper application. This does not affect the Splunk Enterprise instance itself, only the helper application.

After you make your choice, the helper application performs the requested application and terminates. You can run the helper application again to either show Splunk Web or stop Splunk Enterprise.

The helper application can also be used to stop Splunk Enterprise if it is already running.

Start Splunk Enterprise from the command line

  1. On macOS, the default Splunk Enterprise installation directory is /Applications/splunk.
    cd <Splunk Enterprise installation directory>/bin
    ./splunk start
    
  2. Create your admin credentials.
    This appears to be your first time running this version of Splunk.
    
    An Admin password must be set before installation proceeds.
    Password must contain at least:
    * 8 total printable ASCII character(s).
    Please enter a new password:

Other start options

Accept the Splunk license automatically when starting for the first time

  1. Add the --accept-license option to the start command:
    $SPLUNK_HOME/bin/splunk start --accept-license
  2. Create your admin credentials.
    
    This appears to be your first time running this version of Splunk.
    
    An Admin password must be set before installation proceeds.
    Password must contain at least:
    * 8 total printable ASCII character(s).
    Please enter a new password:
  3. The startup sequence displays:
    Splunk> All batbelt. No tights.
    
    Checking prerequisites...
    	Checking http port [8000]: open
    	Checking mgmt port [8089]: open
    	Checking appserver port [127.0.0.1:8065]: open
    	Checking kvstore port [8191]: open
    	Checking configuration...  Done.
    	Checking critical directories...	Done
    	Checking indexes...
    		Validated: _audit _blocksignature _internal _introspection _thefishbucket history main msad msexchange perfmon sf_food_health sos sos_summary_daily summary windows wineventlog winevents
    	Done
    	Checking filesystem compatibility...  Done
    	Checking conf files for problems...
    	Done
    All preliminary checks passed.
    
    Starting splunk server daemon (splunkd)...  
    Done
                                                               [  OK  ]
    
    Waiting for web server at http://127.0.0.1:8000 to be available... Done
    
    
    If you get stuck, we're here to help.  
    Look for answers here: http://docs.splunk.com
    
    The Splunk web interface is at http://localhost:8000
    
    

Start Splunk Enterprise without prompting, or by answering "yes" to any prompts

There are two other start options: no-prompt and answer-yes.

  • If you run $SPLUNK_HOME/bin/splunk start --no-prompt, Splunk Enterprise proceeds with startup until it requires you to answer a question. Then, it displays the question, why it is quitting, and quits. Note that you will need to manually create admin credentials before you log in.
  • If you run SPLUNK_HOME/bin/splunk start --answer-yes, Splunk Enterprise proceeds with startup and automatically answers "yes" to all yes/no questions that it encounters during startup. It displays each question and answer as it continues.

If you start Splunk Enterprise with --no-prompt, it does not create administrator credentials, which prevents login. You must then manually create the credentials before you can log in to Splunk Enterprise. See "Create administrator credentials manually" later in this topic for the procedure.

If you run start with all three options in one line, for example:

$SPLUNK_HOME/bin/splunk start --answer-yes --no-prompt --accept-license
  • Splunk does not ask you to accept the license.
  • Splunk answers yes to any yes/no question.
  • Splunk quits when it encounters a non-yes/no question.

Change where and how Splunk Enterprise starts

To learn how to change system environment variables that control how Splunk Enterprise starts and operates, see "Set or change environment variables" in the Admin manual.

Create administrator credentials manually

If you start Splunk Enterprise for the first time and use the --no-prompt CLI argument, Splunk Enterprise can start without an administrator user, which prevents login. To fix this problem, you must create the credentials and then restart Splunk Enterprise.

  1. Stop Splunk Enterprise:
    ./splunk stop
    
  2. With a text editor, create $SPLUNK_HOME/etc/system/local/user-seed.conf, substituting $SPLUNK_HOME for where you installed the software.
  3. Within the file, add the following lines, substituting a password for your new password:
    [user_info]
    USERNAME = admin
    PASSWORD = <your new password>
    
  4. Save the file and close it.
  5. Restart Splunk Enterprise by following the instructions shown earlier in this topic.

For more information on administrator credential creation, including password management for automated installations, see Create a secure administrator password in Securing Splunk Enterprise.

Troubleshoot Splunk Enterprise not starting the first time

If you encounter a situation where Splunk Enterprise does not start, especially after an upgrade, confirm that you have not passed any illegal arguments to the Splunk CLI as part of the start process. If you have passed illegal arguments, rerun the splunk start command without the arguments.

Launch Splunk Web

With a supported web browser, navigate to:

http://<host name or ip address>:8000

Use whatever host and port you chose during installation.

PREVIOUS
Run Splunk Enterprise as a different or non-root user
  NEXT
What happens next?

This documentation applies to the following versions of Splunk® Enterprise: 7.1.0, 7.1.1, 7.1.2, 7.1.3, 7.1.4, 7.1.5, 7.1.6, 7.1.7, 7.1.8, 7.1.9


Comments

Ebaby, Splunk does not provide support for running Splunk Enterprise on Kubernetes. However, some users have run the software using containers and container orchestration, without support from Splunk. The Splunk Answers community (answers.splunk.com) might be able to assist you with your particular question.

Andrewb splunk, Splunker
October 2, 2018

i try to deploy splunk7.1.2 to the platform of kubernetes.
splunk can not start .


Login failed
Stopping splunkd...
Shutting down. Please wait, as this may take a few minutes.
...
Stopping splunk helpers...

Done.

Ebaby
September 29, 2018

Kangmi, no characters appear when you type your password at the command-line prompt, but the password is being entered as you type. If your first installation failed due to lack of valid password, re-run ./splunk start and create your password at the command line prompt.

Andrewb splunk, Splunker
June 19, 2018

Hi everyone,

I need help. I'm trying to install Splunk on my computer (Mac). I followed the step, and I have a problem with step "Create your admin credentials" because I can't create a new password. How can i create it ?

Thank you.

Kangmi
June 18, 2018

Was this documentation topic helpful?

Enter your email address, and someone from the documentation team will respond to you:

Please provide your comments here. Ask a question or make a suggestion.

You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters