#1 Version Mismatch
Issue:
The launcher shows the version in red, meaning the database version does not match the installed application version.
What happens:
When clicking Launch, it will fail or show an error explaining the mismatch.
Cause:
The Yellow Dog Inventory application was recently upgraded and has not launched since upgrade allowing the application to update files.
Troubleshooting:
- Close the Yellow Dog Launcher application.
- Launch Yellow Dog Inventory from the original Yellow Dog file location and right click to Run as Administrator.

- If a recent upgrade is the root cause, Yellow Dog will present a notification that the application was recently upgraded. Click Yes to restart the application.

Open the Yellow Dog Launch application and verify the version now displays in green text.
* If the text is still red, reach out to Yellow Dog Support. See the bottom of the article for support contact information.
#2 Database Connection Failure
Issue:
The database name appears in red.
Cause:
There is a connection error.
Troubleshooting:
- Check https://status.yellowdog.software/ and verify service statuses.
- If database services are down: Please close the application and wait for services to come back online. You can subscribe to updates by scrolling down to the bottom of the page and entering your email address.
If database services are all online: Contact the Yellow Dog Support Team. See the bottom of the article for support contact information.
#3 Yellow Dog Launcher Not Loading
Issue:
The Yellow Dog Launcher is stuck on the loading screen.
Troubleshooting:
Reach out to Yellow Dog Support. See the bottom of the article for support contact information.
#4 Shared Drive Configuration Problems
Issue:
The Yellow Dog Launcher is inaccessible.
Cause:
- If the launcher is installed on a shared drive, problems can occur if:
- Not all installs are accessible to every user.
- Paths point to local machines instead of the shared drive.
Recommendation:
- Locally installing Yellow Dog Inventory instances and the Yellow Dog Launcher is recommended.
Troubleshooting:
- Verify that all install files are accessible to the user.
- In the Yellow Dog Launcher Application go to Settings > Programs and review the Auto-Scan Install Directory and the Auto-Scan Config Directory. If either directory is pointed to a local machine, move the directory to a location on the shared drive and update the paths in the Yellow Dog Launcher.
- Contact the Yellow Dog Support Team if issues still occur. See the bottom of the article for support contact information.
Contact support if you have
questions or need assistance:
- Support Hotline: Call 757.663.7514,
Monday to Friday, 9 AM to 8 PM EST.
- Emergency Support: For immediate help,
call 757.663.7514 and press option 1.
- Submit Support Tickets: Use the Customer
Portal at portal.yellowdogsoftware.com.