This how-to will guide you through the steps that are needed to run the Galaxy RNA workbench on Mac OSX by setting up Kitematic, a tool which provides a graphical user interface to run Docker containers stored on Docker Hub.
- Installation prerequisites
- Installation procedure
- Launching the workbench
- Taking a tour
- Troubleshooting
Before proceeding, make sure your system is up to date using App Store's update manager.
Finally, go to Kitematic's page, and download the Docker Toolbox.
The following instructions are based on our Kitematic installation screencast:
- Once downloaded, place the Docker Toolbox installer where it is more convenient for you (here we placed it on the desktop for simplicity). Once the Docker Toolbox package is fully downloaded, double-click to proceed to its installation.
- The Docker Toolbox installer starts. Click Continue to proceed with the installation.
- The installer gives an overview of what is provided in the Docker Toolbox. As you can see, Kitematic is going to be installed alongside Docker, providing a desktop GUI for managing its images and containers. Click Continue.
- Click on the drive where you want to install the Docker Toolbox. Click Continue.
- The Docker Toolbox installer provides different types of installation settings, where you can select the different components that are required to run Docker images. Click Customize to review the components and fine-tune your installation, or leave the installation at its defaults (what we did here) by clicking Install.
- Click Continue to finalize the installation. Kitematic will be installed within your system's Applications directory
The installation is now complete.
- Locate the Kitematic icon within your system's Applications directory, and launch it. The Docker GUI starts. Let it load.
- Once loaded, the GUI asks you to connect to Docker Hub to retrieve publicly available Docker images.
Insert your credentials, and click Login.
- Once logged in, the GUI shows some popular Docker images readily available for running on your system.
We are interested in the Galaxy RNA workbench. Type galaxy-rna-workbench in the search bar located on the top of the window to search for this image on the Docker Hub.
- The search dialog shows the retrieved results. Select the first on the left by clicking Create.
- A connection to the Docker Hub is started for the retrieval of the RNA workbench.
Running out of space? Check out our troubleshooting section.
- Once fully downloaded, the Docker container starts, loggin messages on the console. A web preview of the Galaxy RNA workbench is provided next to the console log. Click on the preview window to open it in a browser.
- The workbench is opened in your default browser, where you can readily start working on your workflows.
The opening page shows some useful options to configure Galaxy, install new tools, or try the workbench through guided tours. Tours are interactive demos that show how the interface works in different usage scenarios.
Try the workbench through a guided tour. Tours are interactive, and can be stopped at any time, providing you an overview of what can be done through Galaxy, using its tools, and reusing all available workflows.
To have an introductory tour on how to get accustomed with the Galaxy interface, click on Help -> Interactive Tours, and select the Galaxy UI tour.
Your Galaxy RNA workbench tour has started. Have fun! :)
Kitematic creates virtual machines with a default storage space of 20GB. The RNA workbench is roughly 12GB, therefore if you want to increase disk space, use the Docker CLI (Docker Command Line Interface) that was installed alongside Kitematic.
Once opened, expand the storage space of your virtualbox default machine with the following command:
docker-machine -D create -d virtualbox --virtualbox-disk-size "100000" default
This error is likely to happen when you try to download the workbench a second time on the same virtual machine, after having stopped and removed the container that was created the first time your run it. In this case you can avoid resizing the storage space: just create a new container by clicking + New, and go to the My Images tab. You will see a list of all the images you already downloaded from Docker Hub. Locate the one of the RNA workbench, and click create.