Troubleshooting resources for errors or unexpected results

Check to see if there is a known usegalaxy.* server issue.

If the server was down when you first ran your job, try a rerun once back up. A rerun can also eliminate transient server issues too short in duration to trigger a statuspage warning.

Next, start by reviewing the troubleshooting FAQ. Common reasons and solutions for tool errors are explained. Most job errors can be resolved by correcting your input data’s format/content. Others indicate a tool setting/parameter problem. This summary FAQ links to most other support FAQs.

If you cannot determine how to fix a data/input problem, search existing Q&A topics, support FAQs, and other Galaxy resources. Someone else may have had the same problem with a posted solution. Many tools will have ongoing usage discussions. The most common data/usage issues have a dedicated FAQ.

If you are unsure about how to correct a tool usage problem, review the tool help and prior Q&A.

  • Full Tool help can be found by scrolling down on the tool form.
  • Clicking on the Tool Help icon tool-help-icon in an expanded dataset will display brief tool tips.
  • Clicking on the Job Details icon job-details-icon in an expanded dataset will allow you to review stdout and stderr messages.

If that is not enough tool usage information to solve your problem, try comparing your analysis methods with those in our tutorials:

  • Galaxy Training Network Tutorials: Some GTN tutorials are appropriate for Galaxy Main and some are not. Where you can run each is noted per tutorial – click on the Galaxy instances gear icon galaxyserversGTN to review the Public Galaxy server choices. If a tutorial is supported by a pre-configured Galaxy Docker training image, instructions for how to get it will be listed below the tutorial listings, per category.

If you think you found a software bug, review the issue FAQ and linked known issues to find out if it has already been reported and to learn how to report a new problem:

If you need help after troubleshooting on your own, or would like a suspected bug vetted, please let us know by creating a new post to this site. The more details you include, the more help we can offer. For example: include the exact tool name/version (found at the top of the tool form), input data type/source, error details, screenshots.

Thanks! The Galaxy team & community

Analyzing RNA-seq data
RNA seq analysis: deprecated tools, updated tools, learning resources
Problems with the tutorial data
How to merge or generate FASTA file with the same chromosome
Comparing two different RNAseq datasets
Having issue with exome sequencing - Deprecated tool (BWA for Illumina) in older workflow
Create a Galaxy workflow to identify polymorphic sites in three individuals data - BWA error
From FastQ to fasta - WGS Variant Analysis
Error with Bowtie2 tool
Understanding Indels with no Additional Info in VCF Output
Non-visual Galaxy documentation?
analyzing unknown DNA sequence and suggesting origin
How to make volcano plot
RNAseq analysis
Unexpected failure when I perform cufflinks: Deprecated tool. Solution: Use current Differential Expression Tools, Workflows, Tutorials, FAQs
DexSeq Count issue -- Job failing for exceeding memory resources: input problem or actually too large to execute at public server
Problem to make a bacterial genome assembly database for blast
Issue with StringTie
Seeking advice on amount of ambiguity in featureCounts
Almost Everything about ChIP-Seq data analysis. Focus on a beginner
Generating consensus sequence from bam file re: Variant analysis
Almost Everything about ChIP-Seq data analysis. Focus on a beginner
Pre.cluster issue
Automatically acquiring and adding NCBI data
MiRDeep2 identification of novel and known miRNAs
ATAC-seq analysis and tutorial
Issue resuming paused jobs.
How to use UMI-tools extract
DE lncRNA analysis pipeline
Missing tool: Annotate DESeq2/DEXSeq output tables
Cuff Suite Not Running -- Deprecated Tool Suite
Extract Hits file is empty - PIT workflow at https://galaxyproject.org/use/galaxy-integrated-omics-gio/
Custom genome help and troubleshooting plus where to find HISAT2 alignment statistics
Unicycler launched but still queued after 2 days
Generate gene to transcript map: WARNING output
How to share or publish your work in Galaxy -- Datasets, Histories, Workflows, Visualizations, Pages
From SRA to differential genes in Galaxy
Change pileup to vcf format allowing for great depth (100.000 reads)???
Question about tool errors in an older Galaxy release
SRA file and run fastq-dump error on local Galaxy
Fatal error: exit code 1 () using bowtie2
bam filter losing metadata
Pileup to consensus sequence aligned to reference - Please help
Error message related to memory-RNA star and MD tag
Extracting WGS reads belonging to a particular organism
BWA-MEM results in "An error occurred setting metadata for this dataset"
Fatal error: exit code 1 () using cuffdiff
Bam file to fasta file - Genome assembly
Pruning big files - Filtering SNPs