Container management solution with an accent on modeling containerized applications and provide placement based on dynamic policy allocation
Java JavaScript Go HTML CSS Shell Other
Latest commit 8ec3d73 Jan 18, 2017 @AntonioFilipov AntonioFilipov [UI] Add a checkbox for continueProvisioningOnError prop
- when it is checked, the provisioning will complete, although
the health check failed.

Change-Id: Idda8e5cd0cac0300aada74c2f5bb86bf37b93714
Bellevue-Verified: jenkins <>
CS-Verified: jenkins <>
Upgrade-Verified: jenkins <>
Reviewed-by: Tony Georgiev <>
Failed to load latest commit information.
adapter Implement kubernetes adapter Jan 19, 2017
cli Remove usage of user defined host id (self link) Jan 18, 2017
closures [VBV-910] String results of closure execution are surrounded by " Jan 18, 2017
common-test Revert "Attempt to speedup maven build" Jan 19, 2017
common Implement kubernetes adapter Jan 19, 2017
compute [UI] Add a checkbox for continueProvisioningOnError prop Jan 20, 2017
container-images VBV-856 - Add a proper authN for container shell proxy. Jan 4, 2017
continuous-delivery Implement kubernetes adapter Jan 19, 2017
contrib Add support for range of years in headers Jan 19, 2017
host Implement kubernetes adapter Jan 19, 2017
request Initialize SpreadAffinityFilter Jan 20, 2017
test-closure-integration Reverting the change in add host API. Fixing bugs. Jan 17, 2017
test-closure-performance Fix number of closures per thread in Closure performance test Jan 12, 2017
test-compute-integration Reverting the change in add host API. Fixing bugs. Jan 17, 2017
test-integration Initialize SpreadAffinityFilter Jan 20, 2017
test-performance-unit Xenon query rework. Jan 19, 2017
test-performance Temporary fix for perf job to collect the appropiate container count. Jan 6, 2017
test-upgrade Attempt to fix timeout in upgrade integration test Jan 19, 2017
tools/build Add support for range of years in headers Jan 19, 2017
ui [UI] Add a checkbox for continueProvisioningOnError prop Jan 20, 2017
.gitignore Refactoring SSH code and removing SSH adapter. Prototype for "install… Nov 24, 2016 Update custom template icon colors Jan 10, 2017 Add CONTRIBUTING template Aug 22, 2016
LICENSE Adding license for Admiral 0.9.2 Dec 14, 2016
NOTICE Adding license and notice for version 0.9.1 Oct 31, 2016 Compress the agent image Nov 10, 2016
admiral.l10n Adding .l10n file for localization team Oct 18, 2016
pom-integration.xml Mark 0.9.5-SNAPSHOT for development Dec 27, 2016
pom-performance.xml Remove unit tests from the performance job because of compilation Nov 11, 2016
pom.xml Bump photon-model to 0.5.8-SNAPSHOT Jan 13, 2017




What is Admiral?

Admiral™ is a highly scalable and very lightweight Container Management platform for deploying and managing container based applications. It is designed to have a small footprint and boot extremely quickly. Admiral™ is intended to provide automated deployment and lifecycle management of containers.

This container management solution can help reduce complexity and achieve advantages including simplified and automated application delivery, optimized resource utilization along with business governance and applying business policies and overall data center integration.

Admiral is a service written in Java and based on VMware's Xenon framework. This service enables the users to:

  • manage Docker hosts, where containers will be deployed
  • manage Policies (together with Resource Pools, Deployment Policies, etc.), to establish the preferences about what host(s) a container deployment will actually use
  • manage Templates (including one or more container images) and Docker Registries
  • manage Containers and Applications
  • manage other common and required entities like credentials, certificates, etc.

Getting started

Running Admiral

There are three ways you can start Admiral:

1. Run container image

docker run -d -p 8282:8282 --name admiral vmware/admiral

Open http://<docker-host-IP>:8282 in browser...Configure Docker Host

2. Download the published build archive, you can find it in 'Downloads' section here.

java -jar admiral-host-*-uber-jar-with-agent.jar --bindAddress= --port=8282

Open in browser...Configure Docker Host

3. Clone the repo and build locally. Detailed instructions about building locally can be found in the Admiral developer guide:

  • Building the Admiral agent first (to achieve smaller image file size an LZMA2 compression is used, you need xz utils )
cd container-images/admiral-agent
make buildall
  • Building the Java project
mvn clean install -DskipTests
  • Run the project
java -jar host/target/admiral-host-*-jar-with-dependencies-and-agent.jar --bindAddress= --port=8282

Open in browser...Configure Docker Host

Building the code

mvn clean install

More info on Admiral wiki


You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can. If you wish to contribute code and you have not signed our contributor license agreement (CLA), our bot will update the issue when you open a Pull Request. For any questions about the CLA process, please refer to our FAQ.

Before you start to code, we recommend discussing your plans through a GitHub issue or discuss it first with the official project maintainers via the chat or project-admiral forum, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.


Admiral is available under the Apache 2 license.

This project uses open source components which have additional licensing terms. The source files / docker images and licensing terms for these open source components can be found at the following locations:

Admiral wiki