The OpenStack User Group HOWTO is intended to serve as a guide to founding,
maintaining, and growing an OpenStack user group.
Starting a new OpenStack User Group
Based on the experiences gathered by other OpenStack user groups, like the
San Francisco User Group, the questions and answers below will help guide
you to creating a sustainable user group. We have an
which you can ask for help for mentoring through the process.
Here are the steps to create a new OpenStack User Group:
- Contact your local Ambassador,
they're here to help you through the process!
- Add yourself to the mailing list for
- Check the User Group List to double-check
there is no existing group nearby. If there is a group in your city,
contact their organisers and offer to help. Note that some countries have
an umbrella group that covers the entire country.
- It takes a lot of work to start and operate a user group, so make sure that
you get at least one additional person to help you and act as a backup.
- Find your audience. Who do you want to attract to your user group meetings?
Where do they live and work? What will their skill level be? What content
do they want?
- Ask for more volunteers - many people are willing to assist with tasks like
registration, contacting lecturers, hosting meetings, sending reminders,
- Register a new group in the
Groups Portal. Ensure you fill in the description and add all the details
to allow your audience to find you. Once your Ambassador approves the
request, add your co-organisers as administrators.
- Announce the new group on the openstack mailing lists and any social media
that is popular in your location.
Working with different skill levels
Even though you may be an OpenStack expert, not everyone who comes to your
group will be. Here are some tips for the various skill levels we've observed:
- Beginner: If you want to attract new users to OpenStack then you will want
to discuss the architecture and the basics of how to use OpenStack.
There are many suitable presentations available online.
- Intermediate: Developers and operators that want to understand how to make
OpenStack production ready for their organization need a place to discuss
setups, review and share topics like details on APIs, package installation,
and configuration. You might teach new attendees how to use devstack, or
hold bug squash hackathons for developers.
- Advanced: Some groups tend to call this a ‘‘devOps meeting’'. The topics
are generally about blueprints, advanced operations, or specific deep dive
into part of OpenStack like Neutron. You may ask OpenStack developers for
assistance with the advanced meetings, even if they can only present
Planning your meetings
A surprising amount of effort goes into making an informal gathering
successful. Here are some quick tips.
- Attendance: For free events, it's not uncommon that 30% of people who
register don't show up, so plan accordingly. Track the no-show rate for
- Sponsorship: There are many vendors in the OpenStack community who are
happy to provide space, food and drink, or money in exchange for placing
their logo on your group page, putting up banners or giving a 5-minute pitch.
Go through the list of companies
and contact who you can in your area. If the company is serious about being
involved they will help you out! Ask them if they can do a short talk on
their company's involvement with OpenStack.
- Food and drink: If you can afford it or have a sponsor, it makes the
meetings much more sociable.
- Promotion: Look for local sysops/sysadmin/network ops email lists or online
forums and promote your events there to get folks along. Also write to the
Heads of Schools of the University IT faculties in the area and
invite them and their school along.
- Content: Your topics will your different types of users who attend. Have a
look at other user groups on the groups portal to see what they have done
recently, or ask your ambassador for help. An interesting user story is
always a good bet. Once you have an idea of content, you can contact
- Location: This is critical part of your user group. It makes your life much
easier if you can find a location that will be there long term. There may
be a local function room that is under-utilized early in the week, or
cloud computing companies in your area may have a conference room. Local
universities, technical colleges or co-working spaces may also be interested.
Check other non-OpenStack user groups in your city. And ask your friends,
relatives and colleagues about other meetings they have gone to. Free spaces
can be found basically everywhere in the world.
- Materials: there are some basic meeting materials you will want to go ensure
are present. White boards, projectors, tables and chairs are the basics.
The location you secured may have a few of these things, but don't assume
- Other Venue Preparation: Consider after-hours heating or cooling, lighting,
and security. A small room can get hot or cold, very quickly with the air
conditioning turned off. Sometimes our security forgets the event and locks
- Reminder Announcements: A lot of OpenStack User Group use Meetup
to announce their meeting, since it automatically sends reminders. You can
pick the tool you prefer to organize your events.
- Afterward: keep the conversations going online after a meeting. In order to
support those who couldn't make it this time, collect materials such as
speech scripts, photos, video, and reports and make them accessible online
as much as possible, Collecting the material immediately at the event works
better than chasing speakers afterward. Write a blog post and share the
Example Planning Schedule
This is an example planning schedule from the SFBay OpenStack User Group.
1. Establish dates and times at least 6 months in advance
2. Schedule speakers, assistants at least a month in advance
3. Schedule tweets and emails to go out 7, 2, 1, and 0 days before the meetup reminding possible attendees of the meetup. Examples below
* T-7 day 11:30: @[[OpenStack]] #OSSFO hackathon meetup happening next Thursday at #Yahoo Sunnyvale, RSVP via ow.ly/g2V3u, webex avail
* T-2 day 11:30: @[[OpenStack]] #OSSFO hackathon meetup happening next Thursday at #Yahoo Sunnyvale, RSVP via ow.ly/g2V3u, webex avail
* T-1 day 11:30: @[[OpenStack]] #OSSFO hackathon meetup happening tomorrow at #Yahoo Sunnyvale, RSVP via ow.ly/g2V3u, webex avail
* T-0 day 11:30: @[[OpenStack]] #OSSFO hackathon meetup happening today at #Yahoo Sunnyvale, RSVP via ow.ly/g2V3u, webex avail
- Schedule an email to go out to the community mailing list with the same content
* To: firstname.lastname@example.org
* Subject: [[OpenStack]] SFBay hackathon next Thursday
* Body: @[[OpenStack]] #OSSFO hackathon meetup happening next Thursday at
* #Yahoo Sunnyvale, RSVP via http://meetup.com/openstack, webex avail. More updates via @sarob
4. Book your meeting space at least 1 month in advance
5. Notify security about the meetup and so they can provide directions so
visitors do not get lost
6. Order the food at least 3 days in advance. A good gauge is about 70% of the
RSVPs actually show up. Better topics get a higher percentage turnout.
7. Prep the room about an hour before the meetup. Check the AV equipment,
power strips, seats, food, drink, and white boards are ready to go. Setup
the video camera, so you know where the static viewing area is. Line up
the projector screen to be in the picture. Lay down a tape box where the
speaker should stand. Dial into the audio conference line. If you are using
webex or youtube, check for connection to the remote server.
8. Post Meetup: After the meeting, you can prepare a summary blog post with
images, links to video, marketing updates for the OpenStack blog.
User Groups covering larger geographical areas
The exact spread of a user group, in terms of the area it covers and how it is
managed, depends on the needs of the area and its cultural norms. Some regions
value independence and autonomy (eg a city taking care of its own needs),
whereas others prefer more coordination and sharing (a nationally coordinated
group with meetings in multiple cities). This section aims to provide some
examples of the latter:
- Australia - Due to the sparse population, the group is centrally coordinated
at a national level, with one group entry and meetup.com page. Local
organisers in each city arrange events to post on the central page, and
national coordinators help share speakers and organisational practices
- China - There are leaders in several cities who organise the local meetup
group there, and each city has their own group entry/meetup.com page.
However, for national events such as China Day, and to help start and mentor
new groups, leaders based in various locations come together to collaborate
nation-wide. Some highly respected leaders are granted administrative rights
over the meetup.com pages of the local city groups, in addition to the local
- India - A strong national-level group helps mentor leaders in many cities,
and organises nation-wide events like India Day. Local groups organise
events and post them on single group entry/meetup.com page.
- USA - no national coordination, each city has a completely separate
meetup.com group and organising team. Coordinated loosely by ambassadors,
using the Official User Group Process to avoid overlapping claims.