cloudstack/README.md

Apache CloudStack

• Who Uses CloudStack?
• Quick Start / Try It Now
• Getting Started
• Getting Source Repository
• Documentation
• News and Events
• Getting Involved and Contributing
• Project Status
• Reporting Security Vulnerabilities
• License
• Notice of Cryptographic Software
• Star History
• Contributors

Apache CloudStack empowers organizations to build and manage highly available, scalable, and secure private, public, and hybrid clouds with unparalleled ease. Transform your infrastructure into a flexible, on-demand service with CloudStack's comprehensive IaaS platform.

Key Features

• Multi-hypervisor Support: Manage VMs across VMware vSphere, KVM, XenServer, and Hyper-V from a single pane of glass.
• Network-as-a-Service (NaaS): Automate virtual networking, load balancing, and firewall services.
• Rich API & UI: Programmatically control your cloud with a robust RESTful API and intuitive web interface.
• Storage Management: Flexible storage options including primary and secondary storage, snapshots, and disaster recovery.
• User & Account Management: Robust multi-tenancy with granular access control for users and accounts.
• Resource Accounting & Usage: Track resource consumption for billing and capacity planning.

Ecosystem & Integrations

CloudStack integrates seamlessly with your existing infrastructure and tools:

• Authentication: LDAP, Active Directory, SAML 2.0.
• Storage: S3-compatible object storage, Ceph, GlusterFS, SolidFire, Dell EMC, NetApp.
• Networking: Juniper, Cisco, F5, NetScaler, OpenDaylight, Tungsten Fabric.
• Monitoring & Logging: Prometheus, Grafana, ELK Stack, Splunk.
• Configuration Management: Ansible, Terraform, Chef, Puppet.

CloudStack currently supports the most popular hypervisors: VMware vSphere, KVM, XenServer, XenProject and Hyper-V as well as OVM and LXC containers.

Users can manage their cloud with an easy to use Web interface, command line tools, and/or a full-featured query based API.

For more information on Apache CloudStack, please visit the website

Who Uses CloudStack?

• Trusted by Global Leaders: CloudStack is the backbone of infrastructure for major service providers, telecom operators, and enterprises worldwide.

  "CloudStack has enabled us to scale our public cloud offering with ease and reliability." - Major Cloud Provider

• Diverse User Base: Over 150 known organizations use Apache CloudStack, including:

  • Apple
  • Disney
  • Huawei
  • ...and many more.

• See our case studies highlighting successful deployments of Apache CloudStack.

• See the up-to-date list of current users.

• If you are using CloudStack in your organization and your company is not listed above, please complete our brief adoption survey. We're happy to keep your company name anonymous if you require.

Quick Start / Try It Now

The easiest way to try CloudStack is using the all-in-one Docker container. This is for evaluation purposes only.

1. Pull the Simulator Image:

   docker pull apache/cloudstack-simulator
   

2. Run the Container:

   docker run --name simulator -p 8080:5050 -d apache/cloudstack-simulator
   

3. Access the UI: Open your browser at http://localhost:8080/.

   • Username: admin
   • Password: password

4. Deploy a Data Center: Once logged in, you can deploy a basic zone to test:

   docker exec -it simulator python /root/tools/marvin/marvin/deployDataCenter.py -i /root/setup/dev/basic.cfg
   

Getting Started

• Download a released version
• Build from source with the instructions in the INSTALL.md file.

Getting Source Repository

Apache CloudStack project uses Git. The official Git repository is at:

https://gitbox.apache.org/repos/asf/cloudstack.git

And a mirror is hosted on GitHub:

https://github.com/apache/cloudstack

The GitHub mirror is strictly read only and provides convenience to users and developers to explore the code and for the community to accept contributions via GitHub pull requests.

Documentation

• Project Documentation
• Release notes
• Developer wiki
• Design documents
• API documentation
• How to contribute

News and Events

• Blog
• Twitter
• Events and meetup
• YouTube channel

Getting Involved and Contributing

We welcome contributions from everyone! Here's how you can get started:

• How to Contribute: Read our CONTRIBUTING.md guide for details on code, documentation, and translation contributions.
• Mailing Lists: Join the conversation on our mailing lists. This is where decisions are made.
  • dev@cloudstack.apache.org - For development discussions.
  • users@cloudstack.apache.org - For general usage questions.
  • issues@cloudstack.apache.org - For issue tracking notifications.
• Report Issues: Found a bug? Report it on GitHub Issues.
• Good First Issues: New to the project? Check out issues labeled "good first issue".

Project Status

Apache CloudStack is a mature, actively developed project with a vibrant community. We follow a regular release cadence, typically delivering major feature releases every 6 months, with maintenance releases in between. This ensures a balance of innovation and stability for production environments.

Reporting Security Vulnerabilities

If you've found an issue that you believe is a security vulnerability in a released version of CloudStack, please report it to security@apache.org with details about the vulnerability, how it might be exploited, and any additional information that might be useful.

For more details, please visit our security page.

License

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Please see the LICENSE file included in the root directory of the source tree for extended license details.

Notice of Cryptographic Software

This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See The Wassenaar Arrangement for more information.

The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms. The form and manner of this Apache Software Foundation distribution makes it eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.

The following provides more details on the included cryptographic software:

• CloudStack makes use of JaSypt cryptographic libraries.
• CloudStack has a system requirement of MySQL, and uses native database encryption functionality.
• CloudStack makes use of the Bouncy Castle general-purpose encryption library.
• CloudStack can optionally interact with and control OpenSwan-based VPNs.
• CloudStack has a dependency on and makes use of JSch - a java SSH2 implementation.

Star History

Contributors