Join GitHub today
GitHub is home to over 31 million developers working together to host and review code, manage projects, and build software together.Sign up
Eucalyptus is open source software for building AWS-compatible private clouds.
This Eucalyptus wiki is a collection of technical documents for cloud users, cloud administrators, code contributors and partners.
For the official Eucalyptus web site, visit eucalyptus.com.
About Eucalyptus — Eucalyptus is a set of web services, modeled after and compatible with Amazon Web Services (AWS). Written mostly in Java, Eucalyptus integrates components from over 100 open source projects, tested and packaged into a single easy-to-install and easy-to-use product. Eucalyptus runs on virtualized infrastructure (Linux+KVM).
Acronym — Eucalyptus is actually an acronym, which stands for "Elastic Utility Computing Architecture, Linking Your Programs To Useful Systems".
Architecture — You can see the design documents for Eucalyptus in our architecture repository.
AWS Tools — Eucalyptus is AWS Compatible. See the AWS tools we recommend, and how to configure them for use with Eucalyptus, on our AWS Tools page.
Bugs — You can file bugs on our Jira instance.
Documentation — Reference all of our product documentation.
Feedback — You can always ask questions on any of our Eucalyptus mailing lists.
Install — To install Eucalyptus, try the one-line installer with Faststart. After install completes (usually in less than 30 minutes) you can immediately begin using your private cloud platform with the default account, user and password.
IRC — You can find us on Freenode IRC on #eucalyptus
Mailing List — Join one of the Eucalyptus mailing lists to keep up with latest developments and join our users and developers in conversation.
Nightlies — You can install nightly builds of the latest Eucalyptus development builds by following these instructions.
People — Lots of great people contribute to Eucalyptus. Meet some of them.
Videos — You can see how Eucalyptus works on videos at YouTube.
For Cloud Users
- Bundling Images - How to use euca-bundle-vol to "rebundle" modified VM instances back into the Eucalyptus image catalog as a new EMI.
- Instance Best Practices - Recommendations regarding best practices associated with instance and image management.
- Convert AMI to EMI - How to import an AMI (Amazon Machine Image) into Eucalyptus as an EMI (Eucalyptus Machine Image).
- Kexec Loader - How to use a specialized EKI and ERI to boot the EMI's own in-filesystem kernel and ramdisk using GRUB.
- Using PHP with Eucalyptus - How to use the Amazon AWS PHP SDK with Eucalyptus.
- Starter Images - Starter Images that can be accessed via emis.eucalyptus.com or eustore.
- Stackato Image - Information regarding status of getting Stackato image to work on Eucalyptus.
- Fog - Information regarding status of Fog working with Eucalyptus
- Ansible - Using Ansible to orchestrate EC2 and Eucalyptus instances; deployment and configuration management.
For Cloud Administrators
- Network Troubleshooting FAQ - How to solve common VM networking problems.
- Eutester and Nagios - How to setup and configure Eutester and Nagios to carry out a simple test of cloud availablity.
- Keepalived VIP on Cluster Controllers - How to install and configure keepalived to be used as a shared IP for Node Controller gateways when using MANAGED mode and a private network.
- Eucalyptus Storage - High-level overview of storage in Eucalyptus including Walrus and the Storage Controller and how they work. Also includes some best practices and recommendations.
- Design Docs - Internal Eucalyptus design documentation.
- Debugging Eucalyptus Java-language components - Advice on working with Eucalyptus from an IDE.
- Debugging Eucalyptus C-language components - Tools and advice to debug the components of Eucalyptus written in C** — Node Controller and Cluster Controller.
- Image deployment and construction - Details of how disk images are deployed in the system
- Developer Guide (incomplete) - A work-in-progress guide to getting started on the Eucalyptus code and architecture.
- Generating API WSDLS - How to generate the WSDLS for Eucalyptus services.