OpenStack Upstream Institute

OpenStack Upstream Institute


With over 2,000 developers from over 300 different organizations worldwide, OpenStack is one of the largest collaborative software-development projects. Because of its size, it is characterized by a huge diversity in social norms and technical conventions. These can significantly slow down the speed at which newcomers are successful at integrating their own roadmap into that of the OpenStack project.

We’ve designed a training program to share knowledge about the different ways of contributing to OpenStack like providing new features, writing documentation, participating in working groups, and so forth. The educational program is built on the principle of open collaboration and will teach the students how to find information and navigate the intricacies of the project’s technical tools and social interactions in order to get their contributions accepted. The live one and a half day class is focusing on hands-on practice like the students can use a prepared development environment to learn how to test, prepare and upload new code snippets or documentation for review. The attendees are also given the opportunity to join a mentoring program to get further help and guidance on their journey to become an active and successful member of the OpenStack community.

For more information, see OpenStack Upstream Institute Class Details.

When and where to get an OpenStack Upstream Institute class

The next session of the OpenStack Upstream Collaboration Training - OpenStack Upstream Institute - will be held in Beijing, in parallel to the conference part of the OPNFV Summit 2017.

Wednesday, June 14, 2017 at 11:00 a.m. to 5:00 p.m. - Thursday, June 15, 2017 at 11:00 a.m. to 5:00 p.m. (local time)

In order to RSVP you need to register to the OPNFV Summit first and you can add the course to your registration as an Add-On. If you registered already you can add the course to your registration later as well.

Please see the OpenStack Upstream Institute class information for more details.

See YOU in Beijing!

Please note that the language of the training is English.

How to prepare

  • Make sure you have a wifi enabled laptop with you.
  • Prepared virtual machine image with a development environment:
  • Prepare an environment by yourself from scratch:
    • Create a virtual machine on your laptop with Ubuntu 16.04 installed and 6+ GB of RAM.
    • Alternatively, you can use your virtual machine on a public cloud.
    • Check that you can ssh from your laptop to the virtual machine
    • Check that apt install works on the virtual machine
    • Read and complete the Setup IRC guide.
    • Read and complete the Setup and Learn GIT guide.
  • Read and complete the Account Setup guide. (Note: you will need to sign the Individual Contributor License Agreement (ICLA) during this.)

Etherpad for Beijing Upstream Collaboration Training


Training organizers

Ildiko Vancsa, Kendall Nelson

Further trainers/coaches

You can find the list of trainers/coaches on the training occaisons wiki page.

Best Practices for Trainers

If you’re joining the training activities as a trainer, coach, or if you hold training sessions locally you can find some tips and best practices to consider before hosting the class provided on the OpenStack Upstream Institute Trainers’ Guide page.

We have collected the suggestions based on our experiences from previous Upstream Institute trainings.

Outline and online slide index


Slides are made with Hieroglyph. To skim through slides quickly to find something, or jump ahead or back, use Slide table (press t in the browser). Some slides include additional explanation in the Presenter notes (press c to see them).

Setup the Development Environment


For more information about the past trainings and the local upstream trainings, see OpenStack Upstream Training Archives.

Archive of additional training activities


Activities listed here are not realized at every Upstream training.

Complete index in slide format only

Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.