-
Notifications
You must be signed in to change notification settings - Fork 5
[EDU-849] docs: Add free tier onboarding guide #871
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from all commits
Commits
Show all changes
8 commits
Select commit
Hold shift + click to select a range
8ae4e39
Add free tier onboarding guide
llewellyn-sl 5e0ade6
Add credentials to list of free resources, with link to overview
llewellyn-sl b24ede5
Apply suggestion from @justinegeffen
justinegeffen 1bab2af
Update platform-cloud/docs/quickstart.md
llewellyn-sl 0a62df8
Merge branch 'master' into edu-849-free-tier-guide
llewellyn-sl e32f662
Update quickstart.md
llewellyn-sl 508f7cf
Fix links, add real-time-billing code review suggestions
llewellyn-sl 32ef60e
Update Docs home page "Get started with Cloud" link to new free tier …
llewellyn-sl File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
350 changes: 0 additions & 350 deletions
350
platform-cloud/docs/getting-started/quickstart-demo/comm-showcase.md
This file was deleted.
Oops, something went wrong.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,144 @@ | ||
| --- | ||
| title: "Explore Seqera Cloud" | ||
| description: "Explore your free workspace resources and launch your first pipelines in Seqera Cloud." | ||
| date created: "2025-10-16" | ||
| toc_max_heading_level: 4 | ||
| tags: [pipelines, versioning, nextflow, parameters] | ||
| --- | ||
|
|
||
| When you create a new Seqera Cloud account with a verified work email, Seqera automatically provisions starter resources on your first login. These resources give you everything you need to start running bioinformatics pipelines immediately, including a Seqera compute environment and $100 in free credits to launch pipelines and Studios. | ||
|
|
||
| :::note | ||
| Generic email domains like Gmail are not eligible for the free resources detailed in this guide. | ||
| ::: | ||
|
|
||
| This guide shows you how to launch your first pipelines with the starter resources provided. | ||
|
|
||
| ## Your free resources | ||
|
|
||
| When you first log in after verifying your email, Seqera automatically creates an organization and workspace for you. You can **Explore Platform** and look around your workspace while starter resources are provisioned in the background, or wait for the setup to complete. Resource provisioning typically takes under a minute. Once setup is complete, you'll see a banner confirming that starter resources are ready for you to start launching pipelines. | ||
|
|
||
| Seqera provisions four types of resources to get you started: | ||
| - A [Seqera Compute environment](./compute-envs/seqera-compute.md) with $100 in free credits | ||
| - [Credentials](./credentials/overview.md) used by your compute environment to create and manage cloud resources on your behalf | ||
| - A cloud storage bucket in [Data Explorer](./data/data-explorer.md) | ||
| - Pre-configured nf-core pipelines, ready to launch | ||
|
|
||
| ### Seqera Compute environment | ||
|
|
||
| Your organization workspace includes a pre-configured [Seqera Compute](https://docs.seqera.io/platform-cloud/compute-envs/seqera-compute) environment that requires no cloud account setup or configuration. This environment includes $100 in free credits that can be used to run pipelines or Studios. | ||
llewellyn-sl marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
|
||
| Credits are consumed based on the computational resources your pipeline runs and Studio session use, calculated from CPU-hours, GB-hours, and network and storage costs. You can monitor your credit balance in the **Usage overview** dropdown in the top navigation bar, or view detailed usage in your organization or workspace **Settings** tab. | ||
|
|
||
| See [Credit management](./administration/credit-management) for more information on monitoring usage and requesting additional credits. | ||
|
|
||
| ### Data Explorer | ||
|
|
||
| Your workspace includes an automatically provisioned cloud storage bucket in [Data Explorer](https://docs.seqera.io/platform-cloud/data/data-explorer), linked to your Seqera Compute environment. This bucket provides storage for pipeline outputs, intermediate files, and any data you want to browse or manage through the Seqera interface. Your organization includes 25 GB of free cloud storage. | ||
|
|
||
| :::tip | ||
| After completing pipeline test runs, delete working directory files and other data you no longer need to manage your cloud storage optimally. | ||
| ::: | ||
|
|
||
| ### Launchpad | ||
|
|
||
| Your workspace Launchpad includes six pre-configured [nf-core](https://nf-co.re) pipelines, all set up with a `test` profile so you can launch them immediately with test data. | ||
|
|
||
| #### nextflow-io/hello | ||
|
|
||
| Nextflow's [Hello World](https://github.com/nextflow-io/hello) — a simple example pipeline that demonstrates basic Nextflow functionality. This pipeline is ideal for verifying that your compute setup is working correctly and for understanding how pipeline execution works in Seqera. | ||
|
|
||
| **To launch this pipeline**: | ||
|
|
||
| 1. From the **Launchpad** in the left navigation menu, select **Launch** next to the **nextflow-io/hello** pipeline. | ||
| 1. While this pipeline requires no inputs to run, you can optionally explore the parameters in the launch form. For example, note the **Work directory** is pre-populated with your compute environment work directory path. | ||
| 1. Select **Launch**. | ||
|
|
||
| #### nf-core/demultiplex | ||
|
|
||
| The [nf-core/demultiplex](https://nf-co.re/demultiplex) pipeline separates pooled sequencing reads into individual samples based on barcode sequences. It supports Illumina sequencing data and can handle both single and dual indexing strategies. | ||
|
|
||
| **Use case**: Sequencing facilities often pool multiple samples into a single sequencing run to reduce costs. This pipeline is used to separate the pooled data back into individual sample files based on the unique barcode assigned to each sample during library preparation. | ||
|
|
||
| **To launch this pipeline**: | ||
|
|
||
| 1. From the **Launchpad** in the left navigation menu, select **Launch** next to the **nf-core/demultiplex** pipeline. | ||
| 1. From the **General config** tab, scroll down and copy your **Work directory** path. You can optionally enter a custom **Workflow run name** or create and add **Labels** to the run. | ||
| 1. From the **Run parameters** tab, scroll to the **outdir** field and paste your work directory path. It is recommended to add `/demultiplex/outdir` to the end, to keep your cloud storage organized. | ||
| 1. If the **input** field is not automatically populated, fetch and paste the example samplesheet URL from the [nf-core/demultiplex documentation](https://nf-co.re/demultiplex/latest/docs/usage#example-pipeline-samplesheet). | ||
| 1. Select **Launch**. | ||
|
|
||
| #### nf-core/molkart | ||
|
|
||
| The [nf-core/molkart](https://nf-co.re/molkart) pipeline performs spatial analysis of highly multiplexed tissue imaging data. It processes images from technologies like CODEX, CycIF, or IMC to segment cells, quantify marker expression, and analyze spatial relationships between cells. | ||
|
|
||
| This pipeline is used in spatial biology and pathology research to understand how different cell types are organized in tissue and how they interact. For example, researchers studying tumor immunology use it to map where immune cells are located relative to cancer cells and analyze their spatial relationships. | ||
|
|
||
| **To launch this pipeline**: | ||
|
|
||
| 1. From the **Launchpad** in the left navigation menu, select **Launch** next to the **nf-core/molkart** pipeline. | ||
| 1. From the **General config** tab, scroll down and copy your **Work directory** path. You can also optionally enter a custom **Workflow run name** or create and add **Labels** to the run. | ||
| 1. From the **Run parameters** tab, scroll to the **outdir** field and paste your work directory path. It is recommended to add `/molkart/outdir` to the end, to keep your cloud storage organized. | ||
| 1. If the **input** field is not automatically populated, fetch and paste the example samplesheet URL from the [nf-core/molkart documentation](https://nf-co.re/molkart/latest/docs/usage#full-samplesheet). | ||
| 1. Select **Launch**. | ||
|
|
||
| #### nf-core/rnaseq | ||
|
|
||
| RNA-seq is one of the most common applications in genomics research. Scientists use this pipeline to measure gene expression levels across different conditions, time points, or tissues. For example, researchers studying disease mechanisms might compare gene expression between healthy and diseased tissue to identify which genes are turned on or off. | ||
|
|
||
| The [nf-core/rnaseq](https://nf-co.re/rnaseq) pipeline performs RNA sequencing analysis, from raw reads to gene expression quantification. It includes quality control, read alignment, transcript quantification, and quality metrics reporting. | ||
|
|
||
| **To launch this pipeline**: | ||
|
|
||
| 1. From the **Launchpad** in the left navigation menu, select **Launch** next to the **nf-core/rnaseq** pipeline. | ||
| 1. From the **General config** tab, scroll down and copy your **Work directory** path. You can also optionally enter a custom **Workflow run name** or create and add **Labels** to the run. | ||
| 1. From the **Run parameters** tab, scroll to the **outdir** field and paste your work directory path. It is recommended to add `/rnaseq/outdir` to the end, to keep your cloud storage organized. | ||
| 1. If the **input** field is not automatically populated, fetch and paste the example samplesheet URL from the [nf-core/rnaseq documentation](https://nf-co.re/rnaseq/latest/docs/usage#full-samplesheet). | ||
| 1. Select **Launch**. | ||
|
|
||
| #### nf-core/sarek | ||
|
|
||
| The [nf-core/sarek](https://nf-co.re/sarek) pipeline performs variant calling and annotation from whole genome or targeted sequencing data. It detects germline and somatic variants, including SNVs, indels, and structural variants, and provides comprehensive annotation. | ||
|
|
||
| This pipeline is widely used in cancer genomics and rare disease research. Clinical researchers use Sarek to identify disease-causing mutations in patient genomes, while cancer researchers use it to detect somatic mutations in tumor samples and compare them to normal tissue. | ||
|
|
||
| **To launch this pipeline**: | ||
|
|
||
| 1. From the **Launchpad** in the left navigation menu, select **Launch** next to the **nf-core/sarek** pipeline. | ||
| 1. From the **General config** tab, scroll down and copy your **Work directory** path. You can also optionally enter a custom **Workflow run name** or create and add **Labels** to the run. | ||
| 1. From the **Run parameters** tab, scroll to the **outdir** field and paste your work directory path. It is recommended to add `/sarek/outdir` to the end, to keep your cloud storage organized. | ||
| 1. If the **input** field is not automatically populated, fetch and paste the example samplesheet URL from the [nf-core/sarek documentation](https://nf-co.re/sarek/latest/docs/usage#overview-samplesheet-columns). | ||
| 1. Select **Launch**. | ||
|
|
||
| #### nf-core/scrnaseq | ||
|
|
||
| The [nf-core/scrnaseq](https://nf-co.re/scrnaseq) pipeline processes single-cell RNA sequencing data. It performs read alignment, cell barcode and UMI quantification, quality control, and generates count matrices for downstream analysis. | ||
|
|
||
| Single-cell RNA-seq allows researchers to measure gene expression in individual cells rather than bulk tissue. This pipeline is used to study cellular heterogeneity, identify rare cell populations, and understand how individual cells respond differently to treatments or disease states. For example, immunologists use it to characterize the diverse cell types within the immune system. | ||
|
|
||
| **To launch this pipeline**: | ||
|
|
||
| 1. From the **Launchpad** in the left navigation menu, select **Launch** next to the **nf-core/scrnaseq** pipeline. | ||
| 1. From the **General config** tab, scroll down and copy your **Work directory** path. You can also optionally enter a custom **Workflow run name** or create and add **Labels** to the run. | ||
| 1. From the **Run parameters** tab, scroll to the **outdir** field and paste your work directory path. It is recommended to add `/scrnaseq/outdir` to the end, to keep your cloud storage organized. | ||
| 1. If the **input** field is not automatically populated, fetch and paste the example samplesheet URL from the [nf-core/scrnaseq documentation](https://nf-co.re/scrnaseq/latest/docs/usage#full-samplesheet). | ||
| 1. Select **Launch**. | ||
|
|
||
llewellyn-sl marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| ### Studios | ||
|
|
||
| Seqera Studios provides cloud-based, on-demand development environments for interactive bioinformatics work. Studios are fully integrated with Seqera Platform and offer VS Code or JupyterLab interfaces with access to your pipeline data and compute resources. | ||
|
|
||
| While your free workspace does not include an existing Studio, see [Studios for interactive analysis](https://docs.seqera.io/platform-cloud/studios/overview) to learn how to configure and run Studios on your Seqera Compute environment. The guide includes instructions for adding publicly available data to analyze in your Studios. | ||
|
|
||
llewellyn-sl marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| ## Next steps | ||
|
|
||
| After launching your first pipelines, you can: | ||
| - [Monitor run progress](./monitoring/run-details.mdx) | ||
| - [Explore output data](./data/data-explorer.md) | ||
|
|
||
| When you're ready to run pipelines and Studios with your own data, you can: | ||
| - [Add data](./getting-started/quickstart-demo/add-data.md) | ||
| - [Add new pipelines](./getting-started/quickstart-demo/add-pipelines.md) | ||
| - [Add participants](./getting-started/workspace-setup.md) to collaborate with your team | ||
|
|
||
| Contact the [Seqera community forum](https://community.seqera.io/) or ask [Seqera AI](https://seqera.io/ask-ai/chat-v2) if you encounter any unexpected issues or need assistance. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.