Overview
Whether you're running Yellowfin from your laptop, the cloud or a server, the deployment process is the same. The first time you start Yellowfin, you will also need to configure some settings to match your environment.
First-time deployment steps
Each of these steps is covered in the section below on this page.
- Start the Yellowfin application server (this will automatically start the database).
- Login with the default admin credentials. (and change your password).
- Configure the External Base URL.
Post-deployment steps
We highly recommend you spend some time learning more about Yellowfin before diving in with your data. The steps below contain links to other pages and sections within the wiki. Each link provides valuable information that will help you set up Yellowfin without the guesswork.
- Learn about log files and their contents.
- Learn about the Yellowfin directory structure.
- Learn what new users see when they first log in.
- Learn more about Yellowfin administration.
First-time deployment procedure
Start the Yellowfin application server
Before you log into Yellowfin, you must start the Yellowfin application.
If you're running Yellowfin within a container such as Docker, the start-up process is covered in ourInstall in a Container section (find your environment type for full details).
If you're running Yellowfin directly from a cloud marketplace (such as Yellowfin for AWS), the start-up process is covered in ourInstall in the Cloudsection (find your cloud type for full details).
If you're running Yellowfin on a server or a local machine using Windows, Mac OS X or Linux, follow the steps below.
- Find the new Yellowfin directory: this was shown on the Installation Complete page at the end of your installation, or you can find it manually via your installation path > appserver folder > bin folder
- For Windows, locate thestartup.bak file and double-click on it
- For Mac OS X or Linux, locate theStartup (terminal).command file and double-click on it (if you'd prefer to run it in the background, use Startup (background).commandinstead)
A terminal window will open and the Yellowfin application will start; this takes 60-90 seconds the first time, and 30-60 seconds after that (the time is shown at the end of the server start-up process):
You can stop the Yellowfin application server from a different file within the same directory. Find theshutdown.bat file(Windows) or Shutdown.commandfile (Mac/Linux) and double-click on it to trigger the shutdown.
Windows - start the Yellowfin service
On Windows, you have an additional option of starting Yellowfin as a service.
- On your keyboard press theWindows+R keys to open the Run dialogue box
- Type services.msc and press the Enter key
- Find the Yellowfin service in the list and right-click on it to display a pop-up menu
- Click on the Startmenu option
- If you'd like Yellowfin to start automatically with your computer, double-click on the Yellowfin service to open the Yellowfin Properties dialogue box
- From the Startup Type dropdown, select Automatic, then click on the OK button.
- To stop the Yellowfin service, right-click on it and select Stop
top
Log in to Yellowfin
When the Yellowfin application server has started, you can use a web browser to go to the Yellowfin clientlogin page. Yellowfin supports the following web browsers:
- Chrome
- Firefox 2+
- Microsoft Edge
- Opera 8+
- Safari 2+
Please note that Microsoft is phasing out support for its browser, Internet Explorer 11. As a result, Yellowfin software is no longer supported to run on IE11 and we can no longer guarantee that all Yellowfin features will be available should you choose to continue to use IE11.
If you installed Yellowfin locally, make sure you access the Yellowfin client from the same computer.
If you installed Yellowfin on a shared server, you can access the Yellowfin client from the same computer or any other computer that has access to the shared server.
- Open a supported browser of your choice
- Enter the URL that matches the server host and port details you provided during installation (for example, localhost:8080 for a local installation, or server-name.yourcompany.com for a shared server installation)
The Yellowfin splash screen will appear, prompting you for your username and password - Enter the default login details, shown below, then click on the Login button
Username: admin@yellowfin.com.au
Password: test - Follow the prompt to change your password to something more secure
top
Configure the External Instance Base URL
Setting the External Instance Base URL ensures that email links and JS API access to Yellowfin are enabled.
- In Yellowfin, click on the menu on the left and click onAdministration, then Admin Console, thenConfiguration
- Click on theAdminbutton at the top
- Click onGeneral Settingsand locate the field calledExternal Instance Base URL
- Change the text from localhost to whatever your actual external URL is to access your instance of Yellowfin
- Click on the Save button in the top right corner
When setting this field for certain clustered installations (using Yellowfin 9.3 only), there are some additional considerations. If you experience issues running PDF broadcasts please refer tothis community article.
Yellowfin is now minimally configured to run. Please see the list in the Post-deployment steps section above to learn about logging and other useful administration information.
top
Section navigation
Current topic - Deploy Yellowfin
This page is part of the Install And Deploy Yellowfin section of the wiki, which has these topics:
Install on Premises
Deploy Yellowfin
- Installation Steps
Install in the Cloud
Install in the Cloud
- Yellowfin for AWS
- Yellowfin for Azure
- Yellowfin for Google Cloud Platform
Install in a container
Install in a Container
- Docker
- Kubernetes
- Upgrading Yellowfin Container Deployment
Deploy Yellowfin
Deploy Yellowfin
- Logs and Logging
- Yellowfin Directory Structure
- User Welcome
Advanced Deployments
Advanced Deployments
- Clustering Guide
- Yellowfin Server Specification
- Automate Yellowfin Deployment on Linux
- SAML Bridge
- Standalone Configuration Tools
top