Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

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 or VMware).

Quick Guide

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 stable branch, Eucalyptus 3.2.2, or the code for the upcoming release. 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 documentation.

Feedback. You can always ask questions on any of our Eucalyptus mailing lists, or send a question to feedback@eucalyptus.com.

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

Install. To install Eucalyptus, try our Faststart ISO, which should have you up and running your own cloud within an hour, on as little as a single system.

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.

Slides. You can see presentations on Slideshare.

Videos. You can see how Eucalyptus works on videos at Vimeo.

Pages 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.

Pages 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.

Developer Resources

Something went wrong with that request. Please try again.