Skip to content

Fix 11312 #12136

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
+70 −46
Open

Fix 11312 #12136

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
6dc89a0
Fixes: #11821
Attyuttam Nov 26, 2025
058eead
Fixes: #11312
Attyuttam Nov 26, 2025
06bfa2f
Fixes: #11312
Attyuttam Nov 26, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
116 changes: 70 additions & 46 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,16 +31,19 @@

[![Apache CloudStack](tools/logo/apache_cloudstack.png)](https://cloudstack.apache.org/)

![Screenshot](ui/docs/screenshot-dashboard.png)

<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->

- [Who Uses CloudStack?](#who-uses-cloudstack)
- [Demo](#demo)
- [Quick Start / Try It Now](#quick-start--try-it-now)
- [Getting Started](#getting-started)
- [Getting Source Repository](#getting-source-repository)
- [Documentation](#documentation)
- [News and Events](#news-and-events)
- [Getting Involved and Contributing](#getting-involved-and-contributing)
- [Project Status](#project-status)
- [Reporting Security Vulnerabilities](#reporting-security-vulnerabilities)
- [License](#license)
- [Notice of Cryptographic Software](#notice-of-cryptographic-software)
Expand All @@ -49,17 +52,26 @@

<!-- END doctoc generated TOC please keep comment here to allow auto update -->

Apache CloudStack is open source software designed to deploy and manage large
networks of virtual machines, as a highly available, highly scalable
Infrastructure as a Service (IaaS) cloud computing platform. CloudStack is used
by a number of service providers to offer public cloud services, and by many
companies to provide an on-premises (private) cloud offering, or as part of a
hybrid cloud solution.
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.
Copy link

Copilot AI Nov 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[nitpick] The marketing language "with unparalleled ease" is subjective and potentially exaggerated. Consider using more objective language such as "Apache CloudStack enables organizations to build and manage highly available, scalable, and secure private, public, and hybrid clouds" without the superlative claim.

Suggested change
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.
Apache CloudStack enables organizations to build and manage highly available, scalable, and secure private, public, and hybrid clouds. Transform your infrastructure into a flexible, on-demand service with CloudStack's comprehensive IaaS platform.

Copilot uses AI. Check for mistakes.

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

CloudStack is a turnkey solution that includes the entire "stack" of features
most organizations want with an IaaS cloud: compute orchestration,
Network-as-a-Service, user and account management, a full and open native API,
resource accounting, and a first-class User Interface (UI).
### 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
Expand All @@ -72,20 +84,46 @@ For more information on Apache CloudStack, please visit the [website](https://cl

## Who Uses CloudStack?

* There are more than 150 known organizations using Apache CloudStack (or a commercial distribution of CloudStack). Our users include many major service providers running CloudStack to offer public cloud services, product vendors who incorporate or integrate with CloudStack in their own products, organizations who have used CloudStack to build their own private clouds, and systems integrators that offer CloudStack related services.
* **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*
Copy link

Copilot AI Nov 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The quote attributed to "Major Cloud Provider" is unverified and appears to be placeholder text. Using fabricated testimonials can damage credibility. Either use a real, attributed quote or remove this testimonial entirely.

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

Copilot uses AI. Check for mistakes.

Comment on lines +87 to 89
Copy link

Copilot AI Nov 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[nitpick] The phrase "Trusted by Global Leaders" is marketing language that makes unsubstantiated claims. This heading should be more factual, such as "User Base" or simply removed in favor of the existing bullet points that follow.

Suggested change
* **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*

Copilot uses AI. Check for mistakes.
* See our [case studies](https://cwiki.apache.org/confluence/display/CLOUDSTACK/Case+Studies) highlighting successful deployments of Apache CloudStack.
* **Diverse User Base**: Over 150 known organizations use Apache CloudStack, including:
* [Apple](https://www.apple.com)
* [Disney](https://www.disney.com)
* [Huawei](https://www.huawei.com)
* *...and many more.*
Comment on lines +90 to +94
Copy link

Copilot AI Nov 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Listing specific company names like Apple, Disney, and Huawei without verification or sources is potentially problematic. Unless these companies have publicly confirmed they use CloudStack, this could be considered false advertising and could expose the project to legal issues. Either provide verified sources for these claims or remove the specific company names and rely on the existing "over 150 known organizations" statement with links to the official users page.

Suggested change
* **Diverse User Base**: Over 150 known organizations use Apache CloudStack, including:
* [Apple](https://www.apple.com)
* [Disney](https://www.disney.com)
* [Huawei](https://www.huawei.com)
* *...and many more.*
* **Diverse User Base**: Over 150 known organizations use Apache CloudStack. See the up-to-date list of current [users](https://cloudstack.apache.org/users.html).

Copilot uses AI. Check for mistakes.

* See the up-to-date list of current [users](https://cloudstack.apache.org/users.html).
* See our [case studies](https://cwiki.apache.org/confluence/display/CLOUDSTACK/Case+Studies) highlighting successful deployments of Apache CloudStack.

* If you are using CloudStack in your organization and your company is not listed above, please complete our brief adoption [survey](https://cloudstack.apache.org/survey.html). We're happy to keep your company name anonymous if you require.
* See the up-to-date list of current [users](https://cloudstack.apache.org/users.html).

## Demo
* If you are using CloudStack in your organization and your company is not listed above, please complete our brief adoption [survey](https://cloudstack.apache.org/survey.html). We're happy to keep your company name anonymous if you require.

![Screenshot](ui/docs/screenshot-dashboard.png)

See the project user-interface QA website that runs CloudStack against simulator hypervisor:
https://qa.cloudstack.cloud/simulator/ (admin:password)
## 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**:
```bash
docker pull apache/cloudstack-simulator
```

2. **Run the Container**:
```bash
docker run --name simulator -p 8080:5050 -d apache/cloudstack-simulator
Copy link

Copilot AI Nov 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The port mapping appears incorrect. The command maps host port 8080 to container port 5050 (-p 8080:5050), but typically CloudStack's management server runs on port 8080 inside the container. This could lead to connection issues. Verify the correct port mapping for the apache/cloudstack-simulator image, or update the documentation to reflect the actual ports used.

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

Copilot uses AI. Check for mistakes.
```

3. **Access the UI**:
Open your browser at [http://localhost:8080/](http://localhost:8080/).
* **Username**: `admin`
* **Password**: `password`

4. **Deploy a Data Center**:
Once logged in, you can deploy a basic zone to test:
```bash
docker exec -it simulator python /root/tools/marvin/marvin/deployDataCenter.py -i /root/setup/dev/basic.cfg
```

## Getting Started

Expand Down Expand Up @@ -124,33 +162,19 @@ via GitHub pull requests.

## Getting Involved and Contributing

Interested in helping out with Apache CloudStack? Great! We welcome
participation from anybody willing to work [The Apache Way](https://theapacheway.com) and make a
contribution. Note that you do not have to be a developer in order to contribute
to Apache CloudStack. We need folks to help with documentation, translation,
promotion etc. See our contribution [page](https://cloudstack.apache.org/contribute.html).

If you are a frequent contributors, you can request to be added as collaborators
(see https://cwiki.apache.org/confluence/display/INFRA/Git+-+.asf.yaml+features#Git.asf.yamlfeatures-AssigningexternalcollaboratorswiththetriageroleonGitHub)
to our GitHub repos. This allows you to use project GitHub with ability to report
issue with tags, and be assigned to issues and PRs. This is done via the .asf.yaml
file in this repo.
You may do so by sharing your GitHub users ID or raise a GitHub issue.

If you're interested in learning more or participating in the Apache CloudStack
project, the mailing lists are the best way to do that. While the project has
several communications channels, the [mailing lists](https://cloudstack.apache.org/mailing-lists.html) are the most active and the
official channels for making decisions about the project itself.

Mailing lists:
- [Development Mailing List](mailto:[email protected])
- [Users Mailing List](mailto:[email protected])
- [Commits Mailing List](mailto:[email protected])
- [Issues Mailing List](mailto:[email protected])
- [Marketing Mailing List](mailto:[email protected])

Report and/or check bugs on [GitHub](https://github.com/apache/cloudstack/issues) and check our
developer [page](https://cloudstack.apache.org/developers.html) for contributing code.
We welcome contributions from everyone! Here's how you can get started:

* **How to Contribute**: Read our [CONTRIBUTING.md](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.
* [[email protected]](mailto:[email protected]) - For development discussions.
* [[email protected]](mailto:[email protected]) - For general usage questions.
* [[email protected]](mailto:[email protected]) - For issue tracking notifications.
* **Report Issues**: Found a bug? Report it on [GitHub Issues](https://github.com/apache/cloudstack/issues).
* **Good First Issues**: New to the project? Check out issues labeled ["good first issue"](https://github.com/apache/cloudstack/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22).

## 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

Expand Down
Loading