Troubleshooting errors

Authors:

When you get a red dataset in your history, it means something went wrong. But how can you find out what it was? And how can you report errors?

When something goes wrong in Galaxy, there are a number of things you can do to find out what it was. Error messages can help you figure out whether it was a problem with one of the settings of the tool, or with the input data, or maybe there is a bug in the tool itself and the problem should be reported. Below are the steps you can follow to troubleshoot your Galaxy errors.

Expand the red history dataset by clicking on it.
- Sometimes you can already see an error message here
View the error message by clicking on the bug icon galaxy-bug
Check the logs. Output (stdout) and error logs (stderr) of the tool are available:
- Expand the history item
- Click on the details icon
- Scroll down to the Job Information section to view the 2 logs:
  - Tool Standard Output
  - Tool Standard Error
- For more information about specific tool errors, please see the Troubleshooting section
Submit a bug report! If you are still unsure what the problem is.
- Click on the bug icon galaxy-bug
- Write down any information you think might help solve the problem
  - See this FAQ on how to write good bug reports
- Click galaxy-bug Report button
Ask for help!
- Where?
  - In the GTN Gitter Channel
  - In the Galaxy Gitter Channel
  - Browse the Galaxy Help Forum to see if others have encountered the same problem before (or post your question).
- When asking for help, it is useful to share a link to your history

Still have questions?

Gitter Chat Support

Galaxy Help Forum

Want to embed this snippet (FAQ) in your GTN Tutorial?

{% snippet  faqs/galaxy/analysis_troubleshooting.md %}