To enable developers to easily debug failed Nextflow workflows on Latch, the Latch SDK provides support
for inspecting the contents of an execution’s work directory. This allows users to inspect/create/update
files in the work directory and relaunch the workflow using the updated state.Note: Once an execution’s work directory has expired, it can no longer be inspected. See Caching and Resuming for information
on how to extend the expiration of an execution’s work directory.To get started, verify that you are using latch >= 2.53.8.
latch --version
To debug an execution, run the following command:
latch nextflow attach
This will prompt you to select the name of the execution you wish to debug:After selecting an execution, the Latch SDK will connect you to a container containing the contents of that execution’s work directory.
The work directory is mounted under /nf-workdir inside the container. Once you are connected, you can inspect, create, and/or update
files. Any changes made inside the container will be reflected in the work directory of the execution.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"LatchBio","colors":{"primary":"#001AAE","light":"#92A2FF","dark":"#92A2FF"},"logo":{"light":"https://mintcdn.com/latchbio/rAgK9Jh7PMGtmcOA/logo/light.svg?fit=max\u0026auto=format\u0026n=rAgK9Jh7PMGtmcOA\u0026q=85\u0026s=4d10f1ae3113e21d7923ecaec6c9557e","dark":"https://mintcdn.com/latchbio/rAgK9Jh7PMGtmcOA/logo/dark.svg?fit=max\u0026auto=format\u0026n=rAgK9Jh7PMGtmcOA\u0026q=85\u0026s=6385a39407ab99828572d5b3b26c00d6"},"favicon":"https://mintcdn.com/latchbio/AQfMXqpyiLJx3G2h/favicon.png?fit=max\u0026auto=format\u0026n=AQfMXqpyiLJx3G2h\u0026q=85\u0026s=9420e120f36246f73ecd4753289382a6","navbar":{"links":[{"href":"mailto:support@latch.bio","label":"Contact Us"},{"href":"https://console.latch.bio/","label":"Log In"}],"primary":{"type":"button","label":"Sign Up","href":"https://console.latch.bio/signup"}},"footer":{"socials":{"twitter":"https://twitter.com/latchbio","linkedin":"https://www.linkedin.com/company/latchbio"}},"errors":{"404":{"redirect":false,"title":"Page Not Found","description":"The page might have been moved or been removed.\n \u003cCallout icon=\"arrow-right\" color=\"#001AAE\" iconType=\"regular\">Go to [Home](/)\u003c/Callout> \n \u003cCallout icon=\"arrow-right\" color=\"#001AAE\" iconType=\"regular\">Check out [Developer Docs](/docs)\u003c/Callout>"}},"styling":{"latex":true},"integrations":{"koala":{"publicApiKey":"pk_0469d6299947a84c711662e1ed49f0fea8d7"}},"navigation":{"global":{"tabs":[{"tab":"Blog","href":"https://latchbio.substack.com/"},{"tab":"Website","href":"https://latch.bio/"},{"tab":"Change Log","href":"https://latchbio.notion.site/LatchBio-Product-Change-Logs-ca76a6ae05a74a4daf78cb4006ad80ac"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"latchbio","hasAudioNarration":false,"actualSubdomain":"latchbio","customDomains":["wiki.latch.bio"],"gitSource":{"type":"github","owner":"latchbio","repo":"wiki","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af265145dfd3b833eca24fb","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Workflows \u0026 SDK","count":66},{"language":"default","tag":"Plots","count":56},{"language":"default","tag":"Developer Tools","count":37},{"language":"default","tag":"Pods","count":24},{"language":"default","tag":"Agent","count":22},{"language":"default","tag":"Registry","count":20},{"language":"default","tag":"Administration","count":19},{"language":"default","tag":"Data","count":19},{"language":"default","tag":"Ready-to-Use Workflows","count":15},{"language":"default","tag":"Cell Types","count":14}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"workflows/sdk/nextflow/debugging","slug":"/workflows/sdk/nextflow/debugging","pageMetadata":{"title":"Debugging Nextflow","icon":"bug","iconType":"solid","description":null,"href":"/workflows/sdk/nextflow/debugging"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Note,OptimizedImage}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);return _jsxs(_Fragment,{children:[_jsxs(Note,{children:[`Available in `,_jsx(_components.code,{children:`latch >= 2.53.8`})]}),`\n`,_jsx(_components.p,{children:`To enable developers to easily debug failed Nextflow workflows on Latch, the Latch SDK provides support\nfor inspecting the contents of an execution’s work directory. This allows users to inspect/create/update\nfiles in the work directory and relaunch the workflow using the updated state.`}),`\n`,_jsx(_components.p,{children:_jsxs(_components.em,{children:[`Note: Once an execution’s work directory has expired, it can no longer be inspected. See `,_jsx(_components.a,{href:`/workflows/sdk/nextflow/caching`,children:`Caching and Resuming`}),` for information\non how to extend the expiration of an execution’s work directory.`]})}),`\n`,_jsxs(_components.p,{children:[`To get started, verify that you are using `,_jsx(_components.code,{children:`latch >= 2.53.8`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`latch`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --version`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`To debug an execution, run the following command:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`latch`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` nextflow`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` attach`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`This will prompt you to select the name of the execution you wish to debug:`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/latchbio/uN1BKX4g3v1ZQv8l/images/workflows/nextflow/nextflow-attach.png?fit=max\u0026auto=format\u0026n=uN1BKX4g3v1ZQv8l\u0026q=85\u0026s=899fdfdff16831ce1831c4f8828ba8d2`,\"data-og-width\":`1233`,width:`1233`,\"data-og-height\":`185`,height:`185`,\"data-path\":`images/workflows/nextflow/nextflow-attach.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/latchbio/uN1BKX4g3v1ZQv8l/images/workflows/nextflow/nextflow-attach.png?w=280\u0026fit=max\u0026auto=format\u0026n=uN1BKX4g3v1ZQv8l\u0026q=85\u0026s=52aa96bddb405df100f9d3d8d2959e7c 280w, https://mintcdn.com/latchbio/uN1BKX4g3v1ZQv8l/images/workflows/nextflow/nextflow-attach.png?w=560\u0026fit=max\u0026auto=format\u0026n=uN1BKX4g3v1ZQv8l\u0026q=85\u0026s=d2b11ea9e66725ce3d43111ecb166c72 560w, https://mintcdn.com/latchbio/uN1BKX4g3v1ZQv8l/images/workflows/nextflow/nextflow-attach.png?w=840\u0026fit=max\u0026auto=format\u0026n=uN1BKX4g3v1ZQv8l\u0026q=85\u0026s=4d4a9671522cf09ac2465b28496fc8bc 840w, https://mintcdn.com/latchbio/uN1BKX4g3v1ZQv8l/images/workflows/nextflow/nextflow-attach.png?w=1100\u0026fit=max\u0026auto=format\u0026n=uN1BKX4g3v1ZQv8l\u0026q=85\u0026s=f0994f9a7ef483a60b15beea90ca61de 1100w, https://mintcdn.com/latchbio/uN1BKX4g3v1ZQv8l/images/workflows/nextflow/nextflow-attach.png?w=1650\u0026fit=max\u0026auto=format\u0026n=uN1BKX4g3v1ZQv8l\u0026q=85\u0026s=aaf392cab9914fe7a36384f0d0a88fe6 1650w, https://mintcdn.com/latchbio/uN1BKX4g3v1ZQv8l/images/workflows/nextflow/nextflow-attach.png?w=2500\u0026fit=max\u0026auto=format\u0026n=uN1BKX4g3v1ZQv8l\u0026q=85\u0026s=2f3a55dcdd92bcb6ce5ac1896fbfdf97 2500w`}),`\n`,_jsxs(_components.p,{children:[`After selecting an execution, the Latch SDK will connect you to a container containing the contents of that execution’s work directory.\nThe work directory is mounted under `,_jsx(_components.code,{children:`/nf-workdir`}),` inside the container. Once you are connected, you can inspect, create, and/or update\nfiles. Any changes made inside the container will be reflected in the work directory of the execution.`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/latchbio/uN1BKX4g3v1ZQv8l/images/workflows/nextflow/nextflow-attach-2.png?fit=max\u0026auto=format\u0026n=uN1BKX4g3v1ZQv8l\u0026q=85\u0026s=ea7ef5c7b1bd90782281211f384a1c3e`,\"data-og-width\":`957`,width:`957`,\"data-og-height\":`191`,height:`191`,\"data-path\":`images/workflows/nextflow/nextflow-attach-2.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/latchbio/uN1BKX4g3v1ZQv8l/images/workflows/nextflow/nextflow-attach-2.png?w=280\u0026fit=max\u0026auto=format\u0026n=uN1BKX4g3v1ZQv8l\u0026q=85\u0026s=208ff6e142f5ec565d3015c77583e01b 280w, https://mintcdn.com/latchbio/uN1BKX4g3v1ZQv8l/images/workflows/nextflow/nextflow-attach-2.png?w=560\u0026fit=max\u0026auto=format\u0026n=uN1BKX4g3v1ZQv8l\u0026q=85\u0026s=0f834a425dd053c19cdf917cd896cad1 560w, https://mintcdn.com/latchbio/uN1BKX4g3v1ZQv8l/images/workflows/nextflow/nextflow-attach-2.png?w=840\u0026fit=max\u0026auto=format\u0026n=uN1BKX4g3v1ZQv8l\u0026q=85\u0026s=4beba4bedf531ee6b2d1a9db5969eddd 840w, https://mintcdn.com/latchbio/uN1BKX4g3v1ZQv8l/images/workflows/nextflow/nextflow-attach-2.png?w=1100\u0026fit=max\u0026auto=format\u0026n=uN1BKX4g3v1ZQv8l\u0026q=85\u0026s=a50fd93f405c48bb61093c9819185086 1100w, https://mintcdn.com/latchbio/uN1BKX4g3v1ZQv8l/images/workflows/nextflow/nextflow-attach-2.png?w=1650\u0026fit=max\u0026auto=format\u0026n=uN1BKX4g3v1ZQv8l\u0026q=85\u0026s=00ff351718d088227a4eef041ee9726c 1650w, https://mintcdn.com/latchbio/uN1BKX4g3v1ZQv8l/images/workflows/nextflow/nextflow-attach-2.png?w=2500\u0026fit=max\u0026auto=format\u0026n=uN1BKX4g3v1ZQv8l\u0026q=85\u0026s=2c0aa66ec097120a65310fde1122c236 2500w`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Debugging Nextflow","icon":"bug","iconType":"solid","description":null,"href":"/workflows/sdk/nextflow/debugging"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/latchbio/1643336dc262c788/syft.js","/_mintlify/custom/latchbio/1643336dc262c788/data/syft.js","/_mintlify/custom/latchbio/1643336dc262c788/start/syft.js","/_mintlify/custom/latchbio/1643336dc262c788/wiki/syft.js","/_mintlify/custom/latchbio/1643336dc262c788/workflows/syft.js"],"subdomain":"latchbio","siteName":"LatchBio","title":"Debugging Nextflow - LatchBio","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-01T21:44:30.907Z","originalFileLocation":"workflows/sdk/nextflow/debugging.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"LatchBio\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/latchbio/RhSEdiC7Zz8UPgc7/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/latchbio/RhSEdiC7Zz8UPgc7/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/latchbio/RhSEdiC7Zz8UPgc7/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/latchbio/RhSEdiC7Zz8UPgc7/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/latchbio/RhSEdiC7Zz8UPgc7/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/latchbio/RhSEdiC7Zz8UPgc7/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/latchbio/RhSEdiC7Zz8UPgc7/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/latchbio/RhSEdiC7Zz8UPgc7/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/latchbio/RhSEdiC7Zz8UPgc7/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Debugging Nextflow - LatchBio\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"LatchBio\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://wiki.latch.bio/workflows/sdk/nextflow/debugging\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://latchbio.mintlify.site/_mintlify/api/og/v2?division=Nextflow+SDK\u0026amp;title=Debugging+Nextflow\u0026amp;theme=d90b8111872316c70d8029f9\u0026amp;signature=322f09b375652d952fade39233670424c943c902badde9a9c60c4771d38912db\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Debugging Nextflow - LatchBio\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://latchbio.mintlify.site/_mintlify/api/og/v2?division=Nextflow+SDK\u0026amp;title=Debugging+Nextflow\u0026amp;theme=d90b8111872316c70d8029f9\u0026amp;signature=322f09b375652d952fade39233670424c943c902badde9a9c60c4771d38912db\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/latchbio/RhSEdiC7Zz8UPgc7/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"LatchBio\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#001AAE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://wiki.latch.bio/workflows/sdk/nextflow/debugging\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/workflows/sdk/nextflow/debugging.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://wiki.latch.bio/#organization\",\"name\":\"LatchBio\",\"url\":\"https://wiki.latch.bio\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/latchbio/rAgK9Jh7PMGtmcOA/logo/light.svg?fit=max\u0026auto=format\u0026n=rAgK9Jh7PMGtmcOA\u0026q=85\u0026s=4d10f1ae3113e21d7923ecaec6c9557e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://wiki.latch.bio#website\",\"name\":\"LatchBio\",\"url\":\"https://wiki.latch.bio\",\"publisher\":{\"@id\":\"https://wiki.latch.bio/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://wiki.latch.bio/workflows/sdk/nextflow/debugging#webpage\",\"url\":\"https://wiki.latch.bio/workflows/sdk/nextflow/debugging\",\"name\":\"Debugging Nextflow\",\"dateModified\":\"2026-06-01T21:44:30.907Z\",\"isPartOf\":{\"@id\":\"https://wiki.latch.bio#website\"},\"breadcrumb\":{\"@id\":\"https://wiki.latch.bio/workflows/sdk/nextflow/debugging#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://wiki.latch.bio/workflows/sdk/nextflow/debugging#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Developer Tools\",\"item\":\"https://wiki.latch.bio/workflows/sdk/python/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Nextflow SDK\",\"item\":\"https://wiki.latch.bio/workflows/sdk/nextflow/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Debugging Nextflow\",\"item\":\"https://wiki.latch.bio/workflows/sdk/nextflow/debugging\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://wiki.latch.bio/workflows/sdk/nextflow/debugging#article\",\"headline\":\"Debugging Nextflow\",\"name\":\"Debugging Nextflow\",\"url\":\"https://wiki.latch.bio/workflows/sdk/nextflow/debugging\",\"mainEntityOfPage\":{\"@id\":\"https://wiki.latch.bio/workflows/sdk/nextflow/debugging#webpage\"},\"dateModified\":\"2026-06-01T21:44:30.907Z\",\"publisher\":{\"@id\":\"https://wiki.latch.bio/#organization\"},\"isPartOf\":{\"@id\":\"https://wiki.latch.bio#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"LatchBio\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"LatchBio\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/workflows/sdk/nextflow/debugging.md","siteName":"LatchBio","nav":{"global":{"tabs":[{"tab":"Blog","href":"https://latchbio.substack.com/"},{"tab":"Website","href":"https://latch.bio/"},{"tab":"Change Log","href":"https://latchbio.notion.site/LatchBio-Product-Change-Logs-ca76a6ae05a74a4daf78cb4006ad80ac"}]},"anchors":[{"anchor":"Introduction","icon":"house","pages":[{"title":"Introduction","href":"/start/introduction"}]},{"anchor":"Data","icon":"file-chart-column","pages":[{"title":"Data","href":"/data/overview"}]},{"anchor":"Registry","icon":"table","pages":[{"title":"Registry","href":"/registry/what-is-a-registry"}]},{"anchor":"Workflows \u0026 SDK","icon":"screwdriver-wrench","groups":[{"group":"Workflows \u0026 SDK","pages":[{"title":"What are Latch Workflows?","sidebarTitle":"Overview","icon":"window","iconType":"solid","href":"/workflows/overview"}]},{"group":"Developer Tools","pages":[{"group":"Python SDK","icon":"https://upload.wikimedia.org/wikipedia/commons/c/c3/Python-logo-notext.svg","pages":[{"title":"Overview","sidebarTitle":"Overview","icon":"magnifying-glass","iconType":"solid","href":"/workflows/sdk/python/overview"},{"title":"Quick Start","icon":"play","iconType":"solid","href":"/workflows/sdk/python/quick-start"},{"title":"Tutorial","icon":"arrow-progress","iconType":"duotone","href":"/workflows/sdk/python/authorizing-your-own-workflow"},{"title":"Workflow Environment","sidebarTitle":"Workflow Environment","icon":"docker","href":"/workflows/sdk/python/workflow-environment/overview"},{"title":"Environments for Individual Tasks","sidebarTitle":"Per Task Environments","icon":"docker","href":"/workflows/sdk/python/workflow-environment/environments-for-individual-tasks"},{"title":"Defining Cloud Resources","sidebarTitle":"Cloud Resources","icon":"cloud","iconType":"solid","href":"/workflows/sdk/python/defining-cloud-resources"},{"title":"Caching and Resuming","icon":"window-restore","iconType":"solid","href":"/workflows/sdk/python/caching"},{"title":"Conditional Sections","icon":"code-branch","iconType":"solid","href":"/workflows/sdk/python/conditional-sections"},{"title":"Map Task","sidebarTitle":"Task Parallelization","icon":"grip-lines-vertical","iconType":"solid","href":"/workflows/sdk/python/map-task"}]},{"group":"Nextflow SDK","icon":"https://files.svgcdn.io/vscode-icons/file-type-nextflow.png","pages":[{"title":"Overview","icon":"magnifying-glass","iconType":"solid","href":"/workflows/sdk/nextflow/overview"},{"title":"Tutorial","icon":"arrow-progress","iconType":"duotone","href":"/workflows/sdk/nextflow/tutorial"},{"title":"Execution Profiles","icon":"user","iconType":"solid","href":"/workflows/sdk/nextflow/profiles"},{"title":"Caching and Resuming","icon":"window-restore","iconType":"solid","href":"/workflows/sdk/nextflow/caching"},{"title":"Dependencies","icon":"arrow-progress","iconType":"solid","href":"/workflows/sdk/nextflow/dependencies"},{"title":"Private Registries","icon":"lock","iconType":"solid","href":"/workflows/sdk/nextflow/registries"},{"title":"Shared Storage","icon":"hard-drive","iconType":"solid","href":"/workflows/sdk/nextflow/shared-storage"},{"title":"Using GPU Accelerators","icon":"microchip","iconType":"solid","description":null,"href":"/workflows/sdk/nextflow/gpus"},{"title":"Debugging Nextflow","icon":"bug","iconType":"solid","href":"/workflows/sdk/nextflow/debugging"}]},{"group":"Snakemake SDK","icon":"https://avatars.githubusercontent.com/u/33450111?s=200\u0026v=4","pages":[{"title":"Overview","icon":"magnifying-glass","iconType":"solid","description":null,"href":"/workflows/sdk/snakemake-v2/overview"},{"title":"Tutorial","icon":"arrow-progress","iconType":"duotone","href":"/workflows/sdk/snakemake-v2/tutorial"},{"title":"Metadata","icon":"palette","iconType":"solid","href":"/workflows/sdk/snakemake-v2/metadata"},{"title":"Parameter Encoding","icon":"file-code","iconType":"solid","href":"/workflows/sdk/snakemake-v2/encoding"},{"title":"The Entrypoint","icon":"circle-play","href":"/workflows/sdk/snakemake-v2/entrypoint"},{"title":"Using Latch Storage","icon":"database","iconType":"solid","href":"/workflows/sdk/snakemake-v2/storage"},{"title":"Using the Latch Executor Plugin","icon":"person-biking","iconType":"solid","href":"/workflows/sdk/snakemake-v2/executor"},{"title":"Writing the Dockerfile","icon":"docker","iconType":"solid","href":"/workflows/sdk/snakemake-v2/dockerfile"}]},{"group":"CLI","icon":"square-terminal","pages":[{"title":"Commands","icon":"terminal","iconType":"solid","href":"/workflows/sdk/cli/commands"},{"title":"Latch URLs","icon":"link","iconType":"solid","href":"/workflows/sdk/python/latch-urls"}]},{"group":"API","icon":"webhook","pages":[{"group":"Registry","icon":"table","pages":[{"title":"Overview","icon":"table-tree","iconType":"solid","href":"/registry/sdk/latch-sdk-registry-integration"},{"title":"Account Objects","icon":"user","iconType":"solid","href":"/registry/sdk/account-objects"},{"title":"Registry Projects","icon":"diagram-project","iconType":"solid","href":"/registry/sdk/registry-projects"},{"title":"Table Objects","icon":"table","iconType":"solid","href":"/registry/sdk/table-objects"},{"title":"Record Objects","icon":"table-rows","iconType":"solid","href":"/registry/sdk/record-objects"},{"title":"Registry Usage Tutorial","sidebarTitle":"Usage Tutorial","icon":"arrow-progress","iconType":"duotone","href":"/workflows/sdk/api/registry-usage-tutorial"}]},{"title":"Plot Artifacts","sidebarTitle":"Plots Artifacts","icon":"file","iconType":"solid","href":"/plots/developer/artifacts"},{"title":"Remote Files","sidebarTitle":"Remote Files","icon":"file-arrow-down","iconType":"solid","href":"/workflows/sdk/api/working-with-files"},{"title":"LatchFile / LatchDir (Legacy)","icon":"file-arrow-down","iconType":"solid","href":"/workflows/sdk/python/legacy-file-support"},{"title":"Storing and Using Secrets","sidebarTitle":"Secrets","icon":"key","iconType":"solid","href":"/workflows/sdk/api/storing-and-using-secrets"}]}]},{"group":"Workflow User Interface","pages":[{"title":"UI Definition","icon":"palette","iconType":"solid","href":"/workflows/sdk/ui/latch-metadata"},{"title":"Launch Plans","icon":"rocket","iconType":"solid","href":"/workflows/sdk/ui/launch-plans"},{"title":"Messages","icon":"message","iconType":"solid","href":"/workflows/sdk/ui/messages"},{"title":"Results","icon":"square-poll-vertical","iconType":"solid","href":"/workflows/sdk/ui/results"}]},{"group":"Testing","pages":[{"title":"Development and Debugging","icon":"bug","iconType":"solid","href":"/workflows/sdk/testing-and-debugging-a-workflow/development-and-debugging"},{"title":"Programmatic Execution","icon":"code","iconType":"solid","href":"/workflows/sdk/testing-and-debugging-a-workflow/programmatic-execution"}]},{"group":"Latch Console Dashboard","pages":[{"title":"Overview","icon":"umbrella","iconType":"solid","href":"/workflows/sdk/console/execution-monitoring"},{"title":"Resource Monitoring","icon":"memory","iconType":"solid","href":"/workflows/sdk/console/resource-monitoring"},{"title":"Versioning","icon":"code-compare","iconType":"solid","href":"/workflows/sdk/console/versioning"},{"group":"Automation","icon":"robot","pages":[{"title":"Overview","icon":"magnifying-glass","iconType":"solid","href":"/workflows/sdk/automation/overview"},{"title":"Data Addition Trigger","sidebarTitle":"Example Data Addition Trigger","icon":"table","iconType":"solid","href":"/workflows/sdk/automation/example-data-addition"},{"title":"Interval Trigger","sidebarTitle":"Example Interval Trigger","icon":"alarm-snooze","iconType":"solid","href":"/workflows/sdk/automation/example-interval"}]}]},{"group":"Ready-to-Use Workflows","pages":[{"group":"Bulk RNA-seq","pages":[{"title":"What is Bulk RNAseq?","icon":"flask-gear","iconType":"solid","sidebarTitle":"Bulk RNA Seq Overview","href":"/workflows/bulk-rna-seq-deep-dive"},{"title":"Bulk RNAseq Quantification Walkthrough","icon":"screwdriver-wrench","iconType":"solid","sidebarTitle":"Bulk RNA Seq","href":"/workflows/bulk-rna-seq"}]},{"group":"ATAC-seq","pages":[{"title":"What is ATAC seq?","icon":"flask-gear","iconType":"solid","sidebarTitle":"ATAC Seq Overview","href":"/workflows/ATAC-Seq-Deep-Dive"},{"title":null,"icon":"screwdriver-wrench","iconType":"solid","sidebarTitle":"ATAC Seq","href":"/workflows/ATAC-Seq"}]},{"title":"CRISPResso2","href":"/workflows/crispresso2"},{"title":"CAS-OFFinder","href":"/workflows/cas-offinder"},{"title":"CRISPOR","href":"/workflows/crispor"},{"title":"AlphaFold","href":"/workflows/alphafold"},{"group":"MAGeCK","pages":[{"title":"Overview - MAGeCK","href":"/workflows/mageck-overview"},{"title":"MAGeCK - Count","href":"/workflows/mageck-count"},{"title":"MAGeCK - Test","href":"/workflows/mageck-test"},{"title":"MAGeCK - MLE","href":"/workflows/mageck-mle"},{"title":"MAGeCK - Pathway","href":"/workflows/mageck-pathway"},{"title":"MAGeCK - Plot","href":"/workflows/mageck-plot"}]},{"title":"CSV Parameter Import","icon":"file-import","iconType":"solid","href":"/workflows/csv-import"}]}]},{"anchor":"Pods","icon":"hexagon","pages":[{"title":"Pods","href":"/pods/overview"}]},{"anchor":"Plots","icon":"chart-scatter-bubble","pages":[{"title":"Plots","href":"/plots/overview"}]},{"anchor":"Agent","icon":"robot","pages":[{"title":"Agent","href":"/agent/overview"}]},{"anchor":"Curate","icon":"dna","pages":[{"title":"Curate","href":"/curate/overview"}]},{"anchor":"Administration","icon":"screen-users","pages":[{"title":"Administration","href":"/admin/overview"}]},{"anchor":"Resources","icon":"clipboard-question","pages":[{"title":"Resources","href":"/resources/faq"}]},{"anchor":"API Reference","icon":"webhook","pages":[{"title":"API Reference","href":"/reference/sdk"}]}]},"basePath":"","title":"Debugging Nextflow - LatchBio","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js"]}