Creating a Virtual Labs project

Projects are the primary way that most will use Virtual Labs, as they allow learners to create their own containers using the image you have prepared.The project is also where you say "I'm going to have 100 learner containers that will run for a week", and get something that you can use with the Container Launcher XBlock to make your lab a reality. This article assumes you have an image imported, but need to make some changes to it before it's learner-ready. If you have not yet pulled your image into Virtual Labs, check out the following articles first:

Assuming the image exists and you're ready to create a container, follow the following steps to convert it into something your learners can actually use.

  1. Create an admin container from an image by clicking the Create Container button on the image you want to use on the Images tab of your Virtual Labs dashboard and filling in the name of your new container.

  2. In the Admin Containers tab, find the container you just created and click the link to open it up. At this point you can interact with your software in order to manipulate it into the state that you want to present to your learners.

  3. Once you're done, save the container as an image by clicking the Save As Image button. Again, name it distinctively so that you can find it again later.

  4. Next head back to the Images tab and find your image, either by scrolling or searching, and hit the Create Project button.

  5. In the dialogue that appears, enter the following:
    • The Name of your project
    • Student container duration: i.e. how long you want containers to run (note that containers are not deleted after this time, simply suspended) 
    • Maximum containers: how many containers you would like to cap the lab at. Typically for this, you should use your projected learner numbers +25% for a reasonable buffer.
      Do not just put in a random huge number. This will cause resource issues.
    • If you are using a shared volume container, pick the paired image. Most of the time, you will not need to do this, and should leave it set to (Don't add a paired image) but check out Creating shared volume containers in Virtual Labs for the full process of doing that.


  6. Hit Create and head over to the Projects tab in order to see your new project.

Once your project exists, you can follow the steps outlined in  Adding a Virtual Labs project to your Open edX course to make use of it.