Skip to content

1. Gitpod

Gitpod is a cloud development environment for teams to efficiently and securely develop software. It can improve your developer experience by coding in a cloud development environment.

1.1 Creating a Gitpod account

You can create a free Gitpod account using your GitLab, GitHub, or Bitbucket account.

You can create an account using the Gitpod login page.

Gitpod log in

It is best to connect your LinkedIn account to receive a full 50 hours usage allocation.

Gitpod log in one step

After selecting your preferred editor, theme, and profile details, click continue and your account will be created and ready to use.

Note

It is recommended to use the VS code editor.

1.2 Running Gitpod

Click the following URL to run Gitpod: https://gitpod.io/#https://github.com/nextflow-io/training

This URL is the Nextflow training repository prefixed with https://gitpod.io/#.

Alternatively, you can click on the button below.

Open Gitpod

If you are already logged in, your Gitpod environment will start to load.

1.2.1 Explore your Gitpod IDE

After Gitpod has loaded, you should see something similar to the following:

Gitpod welcome

  • The sidebar allows you to customize your Gitpod environment and perform basic tasks (copy, paste, open files, search, git, etc.). You can click the explorer button to see which files are in this repository.
  • The terminal allows you to run all the programs in the repository. For example, both nextflow and docker are installed and can be executed.
  • The file explorer allows you to view and edit files. Clicking on a file in the explorer will open it within the main window.
  • The Simple Browser lets you view the nf-training material browser (https://training.nextflow.io/). If you close it by accident, you can load the simple browser again by typing the following in the terminal: gp preview https://training.nextflow.io.

1.2.2 Gitpod resources

Gitpod gives you 500 free credits per month, which is equivalent to 50 hours of free environment runtime using the standard workspace (up to 4 cores, 8 GB RAM, and 30 GB storage).

There is also a large workspace option that gives you up to 8 cores, 16GB RAM, and 50GB storage. However, the large workspace will use your free credits quicker and you will have fewer hours of access to this space.

Gitpod will time out after 30 minutes of inactivity and will save your changes for up to 2 weeks.

More information about Gitpod is available at gitpod.io.

1.2.3 Reopening a Gitpod session

You can reopen an environment from https://gitpod.io/workspaces. Previous environments will be listed. You can select the ellipsis (three dots icon) and then select Open to reopen a previous environment.

If you have saved the URL for your previous Gitpod environment, you can simply open it in your browser.

Alternatively, you can open a new training workspace by following the Gitpod URL: https://gitpod.io/#https://github.com/nextflow-io/training

1.2.4 Saving files from Gitpod to your local machine

To save any file from the explorer panel, right-click the file and select Download.