Home

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.

Need Help?

Check out the user and administration documentation, or connect with Eucalyptus on IRC, and the euca-users mailing list.

Resources

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.

Blogs — Read our blogs at Eucalyptus.com. Most blog postings are technical; some are business-oriented.

Bugs — You can file bugs on our Jira instance.

Code — See the code for the latest release, Eucalyptus 4.1.0. You can also see all of our projects on Github.

Contribute — If you'd like to contribute, please check out the Contributor Guidelines first. We also have some more information on our Git setup especially focused on sending documentation patches.

Documentation — Reference all of our product documentation.

Feedback — You can always ask questions on any of our Eucalyptus mailing lists.

Friends — Be our friends on Facebook or contacts on LinkedIn.

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 — We've got great people working at Eucalyptus. Meet some of them.

Questions — You can ask questions on StackOverflow or Quora.

Videos — You can see how Eucalyptus works on videos at Vimeo and 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.
• Fedora 18 Single System Install - How to install a full Eucalyptus test environment on a single system.
• 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.
• Scalable Walrus - Configuration information for the Scalable Walrus/RiakCS integration tech preview introduced in 3.4.0.

For Developers

• 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
• UI Guide - Information on the layout of the web UI and how to modify it.
• Developer Guide (incomplete) - A work-in-progress guide to getting started on the Eucalyptus code and architecture.