Anbox Cloud documentation

Anbox Cloud enables running Android apps on any cloud platform at scale. It uses system containers or virtual machines to run the nested Android containers and Juju for deployment in a cloud environment.

Anbox Cloud supports x86 and Arm64 hardware, providing the same set of features for both architectures.

Since Anbox Cloud uses system containers or virtual machines to emulate Android systems, you can achieve the isolation and security level of a virtual machine without the associated overhead. Therefore, compared to other Android emulation solutions, Anbox Cloud can provide at least twice the density and can serve up to 100 Android instances per server.

Due to its highly scalable nature and performance optimisation, delivering device-agnostic mobile applications is very easy. Popular use cases of Anbox Cloud include mobile game streaming services, corporate application streaming, application automation and testing.

In this documentation

Tutorials
Get started - a hands-on introduction to Anbox Cloud for new users
How-to guides
Step-by-step guides covering key operations and common tasks
Explanation
Concepts - discussion and clarification of key topics, architecture
Reference
Technical information - specifications, APIs

Project and community

Anbox Cloud is a Canonical product. It originally grew out of the Anbox open-source project, but its code base is now completely independent.

Thinking about using Anbox Cloud for your next project? Get in touch!

Navigation

Navigation
Level Path Navlink
0 / Anbox Cloud documentation
0
1 tut/landing Tutorials
2 tut/installing-appliance 1. Install the appliance
2 tut/getting-started-dashboard 2. Get started using the web dashboard
2 tut/getting-started 3. Get started using the CLI
2 tut/stream-client 4. Set up a stream client (Optional)
2 tut/creating-addon 5. Create an addon (Optional)
0
1 howto/landing How-to guides
2 howto/install-appliance/landing Install the appliance
3 howto/install-appliance/aws Install on AWS
3 howto/install-appliance/azure Install on Azure
3 howto/install-appliance/google-cloud Install on Google Cloud
2 howto/install/landing Install Anbox Cloud
3 howto/install/deploy-juju Deploy with Juju
3 howto/install/deploy-bare-metal Deploy on bare metal
3 howto/install/customise Customise the installation
3 howto/install/high-availability Enable High Availability
3 howto/install/validate Validate the deployment
2 howto/update/landing Update an installation
3 howto/update/control Control updates
3 howto/update/upgrade-appliance Upgrade the appliance
3 howto/update/upgrade-anbox Upgrade Anbox Cloud
2 howto/manage/landing Manage Anbox Cloud
3 howto/manage/tls-for-appliance Set up TLS for appliance
3 howto/manage/images Manage Anbox Cloud images
3 howto/manage/ams-access Control AMS remotely
3 howto/manage/benchmarks Run benchmarks
3 howto/manage/resize-storage Resize LXD storage
2 howto/dashboard/web-dashboard Use the web dashboard
2 howto/application/landing Manage applications
3 howto/application/create Create an application
3 howto/application/wait Wait for an application
3 howto/application/list List applications
3 howto/application/userdata Pass custom data
3 howto/application/test Test your application
3 howto/application/update Update an application
3 howto/application/delete Delete an application
3 howto/application/extend Extend an application
2 howto/application/virtual-devices Create a virtual device
2 howto/aar/landing Manage AAR
3 howto/aar/deploy Deploy an AAR
3 howto/aar/configure Configure an AAR
3 howto/aar/revoke Revoke an AAR client
2 howto/port/landing Port Android apps
3 howto/port/permissions Grant permissions
3 howto/port/architecture Choose APK architecture
3 howto/port/obb-files Port APKs with OBB files
3 howto/port/configure-watchdog Configure the watchdog
3 howto/port/install-system-app Install APK as a system app
2 howto/instance/landing Manage instances
3 howto/instance/create Create an instance
3 howto/instance/start Start an instance
3 howto/instance/wait Wait for an instance
3 howto/instance/access Access an instance
3 howto/instance/list List instances
3 howto/instance/geographic-location Configure geographic location
3 howto/instance/logs View the instance logs
3 howto/instance/stop Stop an instance
3 howto/instance/backup-and-restore Back up and restore application data
3 howto/instance/delete Delete an instance
3 howto/instance/expose-services Expose services
2 howto/addons/landing Use addons
3 howto/addons/create Create addons
3 howto/addons/enable-globally Enable globally
3 howto/addons/update Update addons
3 howto/addons/migrate Migrate from previous versions
3 howto/addons/install-tools Example: Install tools
3 howto/addons/backup-and-restore Example: Back up data
3 howto/addons/customise-android Example: Customise Android
3 howto/addons/emulate-platforms Example: Emulate platforms
2 howto/stream/landing Implement streaming
3 howto/stream/access Access the stream gateway
3 howto/stream/oob-data Exchange OOB data
3 howto/stream/client-side-keyboard Use a client-side keyboard
2 howto/cluster/landing Manage the cluster
3 howto/cluster/appliance Join a machine to the appliance
3 howto/cluster/configure-nodes Configure cluster nodes
3 howto/cluster/scale-up Scale up a LXD cluster
3 howto/cluster/scale-down Scale down a LXD cluster
2 howto/anbox/landing Work with the Anbox runtime
3 howto/anbox/develop-platform Develop a platform plugin
3 howto/anbox/develop-addon Develop and test addons
2 howto/troubleshoot/landing Troubleshoot Anbox Cloud
3 howto/troubleshoot/initial-setup Troubleshoot initial setup
3 howto/troubleshoot/logs View logs
3 howto/troubleshoot/application-creation Troubleshoot application creation
3 howto/troubleshoot/instance-failures Troubleshoot instance failures
3 howto/troubleshoot/lxd-cluster Troubleshoot LXD cluster
3 howto/troubleshoot/dashboard-issues Troubleshoot dashboard issues
3 howto/troubleshoot/streaming-issues Troubleshoot streaming issues
2 howto/monitor/landing Monitor Anbox Cloud
0
1 ref/landing Reference
2 ref/releases-versions Releases and versions
3 ref/roadmap Release roadmap
3 ref/release-notes Release notes
3 ref/supported-versions Supported versions
3 ref/component-versions Component versions
2 ref/requirements Requirements
2 ref/appliance-command-reference/landing Appliance command reference
2 ref/amc-command-reference/landing AMC command reference
2 ref/provided-images Provided images
2 ref/supported-rendering-resources Supported rendering resources
2 ref/supported-codecs Supported codecs
2 ref/android-features Supported Android features
2 ref/ams-configuration AMS configuration
2 ref/application-manifest Application manifest
2 ref/api-reference APIs
3 ref/ams-http-api AMS HTTP API
3 ref/anbox-https-api Anbox HTTP API
3 ref/anbox-stream-gateway Stream Gateway API
3 ref/anbox-platform-sdk-api Anbox Platform SDK API
2 ref/sdks Anbox Cloud SDKs
2 ref/network-ports Network ports
2 ref/addon-manifest Addon manifest
2 ref/hooks Hooks
2 ref/webrtc-streamer WebRTC streamer
2 ref/prometheus Prometheus metrics
2 ref/perf-benchmarks Performance benchmarks
2 ref/license-information License information
2 ref/glossary Glossary
0
1 exp/landing Explanation
2 exp/anbox-cloud Anbox Cloud
2 exp/rendering-architecture Rendering architecture
2 exp/security Security
2 exp/ams AMS
2 exp/aar AAR
2 exp/applications Applications
3 exp/resources Resources and resource presets
2 exp/addons Addons
2 exp/application-streaming Application streaming
2 exp/instances Instances
2 exp/platforms Platforms
2 exp/gpus-instances GPUs and instances
2 exp/clustering Clustering
2 exp/performance Performance
2 exp/capacity-planning Capacity planning
2 exp/production Production planning
0
1 Documentation feedback
0
release-notes/1.20.0 Release notes-Anbox Cloud 1.20.0
release-notes/1.19.2 Release notes-Anbox Cloud 1.19.2
release-notes/1.19.1 Release notes-Anbox Cloud 1.19.1
release-notes/1.19.0-fix1 Hotfix release announcement
release-notes/1.19.0 Release notes-Anbox Cloud 1.19.0
release-notes/1.18.2 Release notes-Anbox Cloud 1.18.2
release-notes/1.18.1 Release notes-Anbox Cloud 1.18.1
release-notes/1.18.0 Release notes-Anbox Cloud 1.18.0
release-notes/1.17.2 Release notes-Anbox Cloud 1.17.2
release-notes/1.17.1 Release notes-Anbox Cloud 1.17.1
release-notes/1.17.0 Release notes-Anbox Cloud 1.17.0
release-notes/1.16.4 Release notes-Anbox Cloud 1.16.4
release-notes/1.16.3 Release notes-Anbox Cloud 1.16.3
release-notes/1.16.2 Release notes-Anbox Cloud 1.16.2
release-notes/1.16.1 Release notes-Anbox Cloud 1.16.1
release-notes/1.16.0 Release notes-Anbox Cloud 1.16.0
release-notes/1.15.3 Release notes-Anbox Cloud 1.15.3
release-notes/1.15.2 Release notes-Anbox Cloud 1.15.2
release-notes/1.15.1 Release notes-Anbox Cloud 1.15.1
release-notes/1.15.0 Release notes-Anbox Cloud 1.15.0
release-notes/1.14.2 Release notes-Anbox Cloud 1.14.2
release-notes/1.14.1 Release notes-Anbox Cloud 1.14.1
release-notes/1.14.0 Release notes-Anbox Cloud 1.14.0
release-notes/1.13.2 Release notes-Anbox Cloud 1.13.2
release-notes/1.13.1 Release notes-Anbox Cloud 1.13.1
release-notes/1.13.0 Release notes-Anbox Cloud 1.13.0
release-notes/1.12.5 Release notes-Anbox Cloud 1.12.5
release-notes/1.12.4 Release notes-Anbox Cloud 1.12.4
release-notes/1.12.3 Release notes-Anbox Cloud 1.12.3
release-notes/1.12.2 Release notes-Anbox Cloud 1.12.2
release-notes/1.12.1 Release notes-Anbox Cloud 1.12.1
release-notes/1.12.0 Release notes-Anbox Cloud 1.12.0
release-notes/1.11.5 Release notes-Anbox Cloud 1.11.5
release-notes/1.11.4 Release notes-Anbox Cloud 1.11.4
release-notes/1.11.3 Release notes-Anbox Cloud 1.11.3
release-notes/1.11.2 Release notes-Anbox Cloud 1.11.2
release-notes/1.11.1 Release notes-Anbox Cloud 1.11.1
release-notes/1.11.0 Release notes-Anbox Cloud 1.11.0
release-notes/1.10.3 Release notes-Anbox Cloud 1.10.3
release-notes/1.10.2 Release notes-Anbox Cloud 1.10.2
release-notes/1.10.1 Release notes-Anbox Cloud 1.10.1
release-notes/1.10.0 Release notes-Anbox Cloud 1.10.0
release-notes/1.9.5 Release notes-Anbox Cloud 1.9.5
release-notes/1.9.4 Release notes-Anbox Cloud 1.9.4
release-notes/1.9.3 Release notes-Anbox Cloud 1.9.3
release-notes/1.9.2 Release notes-Anbox Cloud 1.9.2
release-notes/1.9.1 Release notes-Anbox Cloud 1.9.1
release-notes/1.9.0 Release notes-Anbox Cloud 1.9.0
release-notes/1.8.3 Release notes-Anbox Cloud 1.8.3
release-notes/1.8.2 Release notes-Anbox Cloud 1.8.2
release-notes/1.8.1 Release notes-Anbox Cloud 1.8.1
release-notes/1.8.0 Release notes-Anbox Cloud 1.8.0
release-notes/1.7.4 Release notes-Anbox Cloud 1.7.4
release-notes/1.7.3 Release notes-Anbox Cloud 1.7.3
release-notes/1.7.2 Release notes-Anbox Cloud 1.7.2
release-notes/1.7.1 Release notes-Anbox Cloud 1.7.1
ref/appliance-command-reference/ams Appliance command reference - ams
ref/appliance-command-reference/cluster Appliance command reference - cluster
ref/appliance-command-reference/dashboard Appliance command reference - dashboard
ref/appliance-command-reference/destroy Appliance command reference - destroy
ref/appliance-command-reference/gateway Appliance command reference - gateway
ref/appliance-command-reference/help Appliance command reference - help
ref/appliance-command-reference/init Appliance command reference - init
ref/appliance-command-reference/status Appliance command reference - status
ref/appliance-command-reference/upgrade Appliance command reference - upgrade
ref/amc-command-reference/addon AMC command reference - addon
ref/amc-command-reference/application AMC command reference - application
ref/amc-command-reference/benchmark AMC command reference - benchmark
ref/amc-command-reference/completion AMC command reference - completion
ref/amc-command-reference/config AMC command reference - config
ref/amc-command-reference/delete AMC command reference - delete
ref/amc-command-reference/exec AMC command reference - exec
ref/amc-command-reference/help AMC command reference - help
ref/amc-command-reference/image AMC command reference - image
ref/amc-command-reference/info AMC command reference - info
ref/amc-command-reference/init AMC command reference - init
ref/amc-command-reference/launch AMC command reference - launch
ref/amc-command-reference/list AMC command reference - list
ref/amc-command-reference/logs AMC command reference - logs
ref/amc-command-reference/node AMC command reference - node
ref/amc-command-reference/remote AMC command reference - remote
ref/amc-command-reference/shell AMC command reference - shell
ref/amc-command-reference/show-log AMC command reference - show-log
ref/amc-command-reference/show AMC command reference - show
ref/amc-command-reference/start AMC command reference - start
ref/amc-command-reference/stop AMC command reference - stop
ref/amc-command-reference/wait AMC command reference - wait

Redirects

Mapping table
Path Location
/docs/install-appliance /docs/tut/installing-appliance
/docs/lxd-auto-scaling /docs/exp/clustering
/docs/usage/usecase-streaming-sdk /docs/ref/sdks
/docs/reference/ams-sdk-api-reference /docs/ref/sdks
/docs/installation/installation-appliance /docs/tut/installing-appliance
/docs/manage/getting-started /docs/tut/getting-started
/docs/installation/installation-quickstart /docs/howto/install/deploy-juju
/docs/installation/installation-customizing /docs/howto/install/customise
/docs/installation/high-availability /docs/howto/install/high-availability
/docs/installation/validation /docs/howto/install/validate
/docs/installation/upgrading-from-previous-versions /docs/howto/update/upgrade-anbox
/docs/howto/manage/managing-images /docs/howto/manage/images
/docs/howto/manage/managing-addons /docs/howto/addons/landing
/docs/howto/manage/managing-logs /docs/howto/manage/logs
/docs/howto/manage/managing-ams-access /docs/howto/manage/ams-access
/docs/manage/managing-ams-access /docs/howto/manage/ams-access
/docs/installation/installation-application-registry /docs/howto/aar/deploy
/docs/usage/usecase-application-testing /docs/howto/application/test
/docs/usage/usecase-virtual-devices /docs/howto/application/virtual-devices
/docs/manage/container-access /docs/howto/instance/access
/docs/howto/container/view-log /docs/howto/instance/logs
/docs/usage/usecase-container-configuration /docs/howto/instance/geographic-location
/docs/howto/containers/backup-and-restore /docs/howto/instance/backup-and-restore
/docs/implement-android-native-streaming-client /docs/howto/stream/native-client
/docs/implement-web-based-streaming-client /docs/howto/stream/web-client
/docs/howto/stream/web-client /docs/tut/stream-client
/docs/exchange-out-of-band-data /docs/howto/stream/oob-data
/docs/integrate-keyboard /docs/howto/stream/client-side-keyboard
/docs/faq /docs/howto/troubleshoot/landing
/docs/howto/troubleshoot/collect-info /docs/howto/troubleshoot/landing
/docs/sdks /docs/ref/sdks
/docs/reference/ams-rest-api-reference /docs/ref/ams-http-api
/docs/reference/anbox-http-api-reference /docs/ref/anbox-https-api
/docs/reference/anbox-stream-gateway-reference /docs/ref/anbox-stream-gateway
/docs/manage/instance-types-reference /docs/ref/instance-types
/docs/reference/anbox-platforms /docs/ref/platforms
/docs/reference/prometheus-metrics /docs/ref/prometheus
/docs/ams-configuration /docs/ref/ams-configuration
/docs/overview /docs/exp/anbox-cloud
/docs/manage/managing-applications /docs/exp/applications
/docs/manage/managing-addons /docs/howto/addons/landing
/docs/manage/application-registry /docs/exp/aar
/docs/manage/managing-containers /docs/exp/instances
/docs/manage/capacity-planning /docs/exp/clustering
/docs/manage/gpu-support /docs/exp/gpu-support
/docs/exp/gpu-support /docs/exp/gpus-instances
/docs/manage/benchmarking-a-deployment /docs/exp/benchmarking
/docs/manage/streaming-android-applications /docs/exp/application-streaming
/docs/usage/usecase-port-android-application-to-anbox-cloud /docs/exp/porting-issues
/docs/installation/installation-requirements /docs/requirements
/docs/exp/porting-issues /docs/howto/port/landing
/docs/exp/benchmarking /docs/howto/manage/benchmarks
/docs/changelog /docs/release-notes
/docs/howto/container/launch /docs/howto/instance/create
/docs/howto/stream/debug /docs/howto/troubleshoot/streaming-issues
/docs/howto/manage/web-dashboard /docs/howto/dashboard/web-dashboard
/docs/howto/manage/logs /docs/howto/troubleshoot/logs
/docs/ref/platforms /docs/exp/platforms
/docs/requirements /docs/ref/requirements
/docs/release-notes /docs/ref/release-notes
/docs/roadmap /docs/ref/roadmap
/docs/component-versions /docs/ref/component-versions
/docs/supported-versions /docs/ref/supported-versions
/docs/ref/instance-types /docs/ref/application-manifest
/docs/ref/supported-video-codecs /docs/ref/supported-codecs
/docs/howto/addons/best-practices /docs/exp/addons
/docs/ref/addons /docs/ref/addon-manifest
/docs/howto/manage/manage-appliance /docs/ref/appliance-command-reference/landing
/docs/exp/containers /docs/exp/instances
/docs/howto/container /docs/howto/instance
/docs/howto/troubleshoot/container-failures /docs/howto/troubleshoot/instance-failures
/docs/howto/container/access /docs/howto/instance/access
/docs/howto/container/backup-and-restore /docs/howto/instance/backup-and-restore
/docs/howto/container/create /docs/howto/instance/create
/docs/howto/container/delete /docs/howto/instance/delete
/docs/howto/container/expose-service /docs/howto/instance/expose-service
/docs/howto/container/geographic-location /docs/howto/instance/geographic-location
/docs/howto/container/landing /docs/howto/instance/landing
/docs/howto/container/list /docs/howto/instance/list
/docs/howto/container/logs /docs/howto/instance/logs
/docs/howto/container/start /docs/howto/instance/start
/docs/howto/container/stop /docs/howto/instance/stop
/docs/howto/container/wait /docs/howto/instance/wait
/docs/howto/application/resources /docs/exp/resources