OpenStack Hackathon Toolkit

About OpenStack Hackathons:

The clock is ticking. One teammate whiteboards while another digs through documentation. The best idea wins, but everyone learns. OpenStack Hackathons bring together hundreds of technologists in a supportive learning environment to practice their skills with the latest cloud tools.

For team members of all roles––be it appdev, devops, UX, sysadmin, or network engineering––hackathons are a great way to rapidly learn in a fun and competitive environment.

Host an OpenStack Hackathon:

As hackathon organizer, you will lead a team of dedicated community volunteers who are inspired by learning the latest cloud skills. Hackathons are hard work to run, requiring 3-6 months of planning, but the value of a hackathon is multifold:

To get started planning a hackathon, contact the chairs of the Hackathon Working Group.  Need more co-organizers? Contact your local users groups and ambassadors to see if they can help.


Can anyone host a Hackathon?

Yes, of course, we are a worldwide community! Hackathons are a great way to expand your community and/or improve the skills of your staff. There are two common Hackathon formats:

a.) Community (large) hackathons: Grow the cloud app development skills of your regional community. These events bring together hundreds of participants from universities, companies, governments and other open cloud supporters.

b.) Internal organization / corporate (small) hackathons: Train internal teams on OpenStack infrastructure and improve team collaboration through company-wide hackathons. Attendees will walk away with new knowledge about open infrastructure tools and cloud native applications.

How do I decide what size event to do? ​If you are: arranging sponsorship for a dedicated event, planning to charge for attendance, expecting more than 100 people, planning a press release or any media involvement ... plan on doing a large hackathon.Selection_139.png

We can connect you with community members (like Victor in the video below) who have run  hackathons and can provide advice and guidance:


Who attends a Hackathon?

Hackathons are for everyone! It takes a variety of roles to take a concept from ideation to production, and hackathon attendance reflects that. Common attendees are network engineers, system administrators, developer operations, application developers, and usability experts, but there’s no limit to who you might want to invite or who will attend. 



How can the OpenStack Foundation help?

Once an event is approved by the Hackathon Working Group, the Foundation provides support including training videos/materials/graphics, advisory sessions, and potentially sponsorship depending on size and scope of the event. The Foundation will also help make connections and promote the event via its website, mailing lists, user groups and social media to help attract attendees and potential sponsors.

Hackathon Toolkit Outline:

  1. Planning Tools
  1. Hackathon overview for organizers
  1. Official Foundation agreement and sponsorship contract, including:
  1. Example timelines/checklist for pre-training activities
  2. Example volunteer roles for large hackathons
  3. Example floor plan for hackathon setup
  4. Suggested activities for company-specific/internal hackathons
  1. Event Steering Committee (see below)
  1. For large events 150+ participants plus, it is a good idea to assemble a steering committee who can help act as guides as you progress on your event.  The Steering Committee should NOT be doing the hard-lifting for the event (that’s for you and your team), but they should be helping advise you so your time is well spent.
  1. Procuring cloud infrastructure
  1. A primary goal of the hackathon is making the attendee’s first experience with OpenStack positive, which is why it is critical to procure and test reliable, performant infrastructure for your event
  2. A best practice is to find a public cloud provider to sponsor the event, because they may also provide attendees with vouchers or discounts to continue their work after the event. The OpenStack User Committee can connect you with public cloud providers.
  3. Use a cloud built for the event only as a last resort - it requires significantly more effort to reach the required level of reliability. If a Public Cloud cannot be arranged, see if you can find an organisation to allow temporary access to their Private cloud instead.
  1. Venue
  1. Location is key
  2. Add in key venue items
  3. Tips
  1. Registration, promotion and feedback
  1. Registration Questionnaire
  1. Sample Registration Template Process from Guadalajara Hackathon
  1. Post-event survey question examples
  1. Taiwan event organiser feedback reflection board
  2. Mexico feedback session with team mentor-helpers
  1. Social media coverage examples
  2. The Foundation will manage the Eventbrite registration process
  1. Sponsorship/Finance
  1. Sample sponsorship prospectus for Public Clouds
  2. Sample sponsorship prospectus for Enterprises
  3. Sample sponsorship agreement contract (venues/in-kind)
  4. Community partnership agreement (joint advertising)
  5. Financial advice from organizers
  1. Pre-event training guides
  1. Cloud App Labs for SDKs
  2. Sample email from Lead Mentor to prepare participants for hackathon on C/PaaS
  1. Safety/Code of Conduct
  1. https://www.openstack.org/legal/community-code-of-conduct/
  2. https://www.openstack.org/legal/code-of-conduct/
  3. https://wiki.openstack.org/wiki/Open 
  1. Hackathon branding collateral
  1. Artwork
  1. Stickers
  1. Design files
  2. Swag store: https://www.openstack.org/store/
  1. Sample giveaways:
  1. Camping tents
  2. Towels & soap
  3. T-shirts
  4. Supply the leads, judges, mentors, and staff with different color t-shirts so they are easily recognized by attendees
  1. Slide templates
  1. Sample Opening Ceremony Slides from Guadalajara
  2. Sample Opening Ceremony from Taiwan
  3. Sample Closing Ceremony Slides from Taiwan
  4. Sample Voting Process Slides from Mexico
  1. Hackathon Website
  1. Each Hackathon organizer is responsible for setting up the Hackathon website
  2. The Foundation and Steering committee is here to support you by providing sample templates of other Hackathon websites
  1. Guadalajara website example: http://hackathon.openstackgdl.org
  2. Sydney website example: xx


  1. OpenStack logo and trademark: The hackathon logo and digital assets were created by the talented Guadalajara community.  The Foundation will customize each logo to include the location or your event.  To request your official OpenStack Hackathon logo and branding kit, please send an email to events@openstack.org.
  1. Openstack Brand Policy: https://www.openstack.org/brand/
  2. OpenStack Privacy Policy: https://www.openstack.org/privacy/
  3. OpenStack Trademark Policy: https://www.openstack.org/brand/openstack-trademark-policy/

See appendices of examples below:


Hackathon website and social media:





Email (campaign) invitation formatting:


Eventbrite ticket registration:


On-site event registration and help desk:

Event t-shirts:

Event badges:

Hackathon signage:

Event stage:

Event Organising team:

Winning team:

Event organisers:

Hackathon mentor, helpers and volunteers:

Media interviews:


Winning team prize:



Team based pre-training:

Hackathon teams at the international OpenStack Summit (5k people in audience)

Hackathon tweets and social media:







Sample event steering agenda:

Proposed (month-by-month) agenda items for Event Steering Committee:

Sample email invitation to mentors preparing them for event:

Thanks for volunteering to be a mentor at the OpenStack Hacking Up the Stack Hackathon in Sydney on the 3rd to the 5th of November hosted at the Doltone House in the Australian Technology Park.


Please be sure to register at http://hackathon.openstack.org.au/buy-tickets/ by October 20th and use the promotion code:


As you know, the Hackathon runs for 40 hours straight, so the next step will be to put together a schedule so we have good coverage of mentors and skills throughout the event. I’ll be in touch with each of you as we get closer to the event to begin scheduling our mentors into shifts, but in the meantime, here’s our current plan.

Schedule and Meeting your Team

We have a section on the Hackathon event website (http://hackathon.openstack.org.au) where your mentor’s profile will be posted.  This will help participants to identify mentors before the Hackathon that can bring experience/knowledge that fits their needs to build cloud applications.

Please plan to arrive on Friday, 3rd November, to register between 3pm - 5:30pm. The Opening Ceremony will begin at 5:30pm where we will welcome everyone to the Hackathon and provide introductions. At 7:30pm you will meet with your teams for your first networking session.  

Mentor Shift Schedule:



How to be an Amazing Mentor

Mentors set the tone for the Hackathon. Mentors are like an invisible extra team member to each team! You have to motivate your Hackathon teams when their spirit lows, give them tips and show them tricks and sometimes even jump-start the creative flow with a fresh idea.


At a Hackathon, participants learn how to turn their ideas into reality. Participants learn by doing, but Internet is not enough to teach someone how to build their first hack. This is where you come in! A good mentor can vastly improve a hacker's experience and learning, and inspire novel hackers to pursue their dreams.


To support Hackathon teams with your technical expertise. In the case where you can’t answer a question, you have to contact another mentor to support you. For example, a Hackathon team has questions about the platform they chose, but you are not sure about the answer, so, you need to identify another mentor with the experience needed, and ask them to assist the team with their issue.


Mentorship Type

As a mentor, you will be providing real-time assistance to the assigned Hackathon teams in the Hackathon venue during the Hackathon. Mentors should take shift in the Hackathon venue to help the teams.  As a onsite mentor, you will be assigned to a team; and you will have a sit available in your team table during the Hackathon, so you can work with them very closely.

Tips for Mentors

Things to Avoid


Required reading

We recommend you familiarise yourself with the three platforms available for the Hackathon. Training resources are available for each of the platforms at:



If you have any questions, or if you think you'll be unable to commit to the event, please get in touch with me.

Thanks for your support!




Andy Botting

Lead mentor

Link bibliography: archive of previous examples from hackathons

Website / Social media: