Apache CloudStack Wiki: Info on developing and contributing to Apache CloudStack
This is the home of Apache Cloudstack. Feel free to edit this page. If you see something wrong, edit it. If you have new information, please add it. Or to put it another way: edit boldly. It's a wiki - any changes can be reverted if necessary.
CloudStack Technical Documentation -- Installation Guide, Admin Guide, API Developer's Guide, CloudStack Nicira NVP Guide, and Release Notes.
API Reference -- CloudStack API command syntax and description; a companion to the API Developer's Guide
Developer Docs and Resources
To get the CloudStack source, use:
- 101 - Basics This is the intro page to developing for CloudStack.
- Coding Conventions Coding Styles for CloudStack.
- Contributing as a non-committer This page will explain how to get started on CloudStack development without direct commit access.
- CloudStack Git Repo Web front-end for the CloudStack Git Repo.
- CloudStack Tutorials This section is dedicated to guides on configuring CloudStack within your environment.
- Design This section contains the design specs written for CloudStack
- Troubleshooting Troubleshooting techniques and solutions
We do most of our discussion and work on the Apache CloudStack mailing lists. Specifically, developer discussions happen on the cloudstack-dev mailing list. If you're looking for user support, the cloudstack-users list is the best place to go. (You may be tempted to send mails to both lists looking for help. Avoid that temptation. It's much better etiquette to direct emails to one list only, and to use the appropriate lists.) For guidelines on participating on the mailing list, see Mailing List Guidelines.
Please note that all of the lists are high-volume.
- To join the cloudstack-dev mailing list send an email to email@example.com. The archives can be found on mail-archives.apache.org.
- To join the cloudstack-users mailing list send an email to firstname.lastname@example.org. The archives can be found on mail-archives.apache.org.
- To join the cloudstack-commits mailing list send an email to email@example.com. The archives can be found on mail-archives.apache.org.
- 中文用户可以参加CloudStack的中文用户邮件列表。请寄封电邮给 firstname.lastname@example.org.
- To join the cloudstack-marketing mailing list send an email to email@example.com. The archives can be found on mail-archives.apache.org.
Before posing questions to the mailing lists ensure that you have looked through the archives. A very searchable archive of all the cloudstack mailing lists is available at markmail
Marketing and Promoting CloudStack
Spread the word on how awesome CloudStack is. Below are the proposed open plans to gain visibility. By promoting CloudStack you can help to show the world that there is a "real", stable, user friendly, easy to use, feature-full production ready cloud platform.
We maintain several community IRC channels for real-time discussion and support, but please note that if it didn't happen on the mailing list, it didn't happen. Decisions are made on the mailing list (cloudstack-dev). But if you're looking for real-time answers to development or user questions, IRC is a great way to find help. All channels are on Freenode.
- #cloudstack: This channel is for general cloudstack discussion and support.
- #cloudstack-dev: This channel is for developer discussions and support. This channel also receives notices of commits, build failures, etc.
- #cloudstack-meeting: Meetings are held here.
Due to the speed of the confluence, the index generation is now on a lower page. Clicking on the Index Generator page will take a good 30 seconds to complete. Use at your own risk.