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 globe icon menu galaxyserversGTN and 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

1 Like
Analyzing RNA-seq data
Problems with the tutorial data
RNA seq analysis: deprecated tools, updated tools, learning resources
How to merge or generate FASTA file with the same chromosome
Unexpected failure when I perform cufflinks: Deprecated tool. Solution: Use current Differential Expression Tools, Workflows, Tutorials, FAQs
MiRDeep2 identification of novel and known miRNAs
Comparing two different RNAseq datasets
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
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
From SRA to differential genes in Galaxy
How to share or publish your work in Galaxy -- Datasets, Histories, Workflows, Visualizations, Pages
Generate gene to transcript map: WARNING output
Cuffdiff--SQLite option is buggy for all versions or just for the latest one?!
Annotate VCF with gene names
substract overlapping intervals
Splitting interleaved/interlaced fastq data and Extracting fastq data from an sra archive
Server Issue? Jobs running slow -- Public server delays plus Using Galaxy choices
Data paused and keep getting error: Tophat RNA data -- Tophat/Tophat2 Deprecated, use HISAT2
Errors using LEfSe tool through the Galaxy/Huttenhower lab website
From FastQ to fasta - WGS Variant Analysis
Bam file to fasta file - Genome assembly
BAM file analysis -- Variant analysis tutorials
how can I get long non coding RNA from RNA-seq data?
Extremely Long Queue Times RNA-seq Data Processing
Server Issue? Jobs running slow -- Public server delays plus Using Galaxy choices
identify mutations in RNAseq data
What are the RNA-seq data processing steps in Galaxy according to de novo approach?
ERROR : "TERM environment variable not set"
DESeq2 job paused and cannot be resumed - Input dataset 'xxx' failed to properly set metadata
How to upload .tsv files into GALAXY
Help needed regarding usegalaxy.eu and usegalaxy.org
usegalaxy error "maximum allowed job run time"
HISAT2 errors meaning
HISAT2 errors meaning
Having issue with exome sequencing - Deprecated tool (BWA for Illumina) in older workflow
How jobs execute -- blast analysis running for several days and not ending
Extracting WGS reads belonging to a particular organism
https://usegalaxy.org/ -- Server issues Feb 25, 2020 Resolved
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
BWA-MEM results in "An error occurred setting metadata for this dataset"
Fatal error: exit code 1 () using cuffdiff
Pruning big files - Filtering SNPs
Create a Galaxy workflow to identify polymorphic sites in three individuals data - BWA error
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