Anbox Cloud documentation

Note: With the latest 1.23.0 release, the Anbox Cloud documentation is moved to https://documentation.ubuntu.com/anbox-cloud/en/latest/. Hence, the information in this discourse post may be obsolete. The documentation posts on discourse will be unlisted and archived shortly.
Discourse will still be used for user engagement and release announcements.

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 tutorial/landing Tutorials
2 tutorial/installing-appliance 1. Install the appliance
2 tutorial/getting-started-dashboard 2. Get started using the web dashboard
2 tutorial/getting-started 3. Get started using the CLI
2 tutorial/stream-client 4. Set up a stream client (Optional)
2 tutorial/getting-started-aaos 5. Get started with AAOS (Optional)
2 tutorial/creating-addon 6. 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/manage/web-dashboard Use the web dashboard
2 howto/application/landing Manage applications
3 howto/application/create Create an application
3 howto/application/stream Stream 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/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/android/landing Work with Android
3 howto/android/graphics-debugging-with-renderdoc Graphics debugging with Renderdoc
3 howto/android/custom_vhal Replace the Anbox VHAL
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 reference/landing Reference
2 reference/releases-versions Releases and versions
3 reference/roadmap Release roadmap
3 reference/release-notes/release-notes Release notes
3 reference/supported-versions Supported versions
3 reference/component-versions Component versions
2 reference/requirements Requirements
2 reference/appliance-command-reference/landing Appliance command reference
2 reference/amc-command-reference/landing AMC command reference
2 reference/provided-images Provided images
2 reference/supported-rendering-resources Supported rendering resources
2 reference/supported-codecs Supported codecs
2 reference/android-features Supported Android features
2 reference/anbox-features Supported Anbox features
2 reference/ams-configuration AMS configuration
2 reference/application-manifest Application manifest
2 reference/api-reference APIs
3 reference/ams-http-api AMS HTTP API
3 reference/anbox-https-api Anbox HTTP API
3 reference/anbox-stream-gateway Stream Gateway API
3 reference/anbox-platform-sdk-api Anbox Platform SDK API
2 reference/sdks Anbox Cloud SDKs
2 reference/network-ports Network ports
2 reference/addon-manifest Addon manifest
2 reference/hooks Hooks
2 reference/webrtc-streamer WebRTC streamer
2 reference/prometheus Prometheus metrics
2 reference/perf-benchmarks Performance benchmarks
2 reference/deprecation-notices Deprecations
2 reference/license-information License information
2 reference/glossary Glossary
0
1 explanation/landing Explanation
2 explanation/anbox-cloud Anbox Cloud
2 explanation/rendering-architecture Rendering architecture
2 explanation/aaos AAOS
2 explanation/security Security
2 explanation/ams AMS
2 explanation/aar AAR
2 explanation/web-dashboard Dashboard
2 explanation/applications Applications
3 explanation/resources Resources and resource presets
2 explanation/addons Addons
2 explanation/application-streaming Application streaming
2 explanation/instances Instances
2 explanation/images Images
2 explanation/custom-images Custom images
2 explanation/nodes Nodes
2 explanation/platforms Platforms
2 explanation/gpus-instances GPUs and instances
2 explanation/clustering Clustering
2 explanation/performance Performance
2 explanation/capacity-planning Capacity planning
2 explanation/production Production planning
0
1 Documentation feedback
0
reference/release-notes/1.22.2 Release notes-Anbox Cloud 1.22.2
reference/release-notes/1.22.1 Release notes-Anbox Cloud 1.22.1
reference/release-notes/1.22.0 Release notes-Anbox Cloud 1.22.0
reference/release-notes/1.21.2 Release notes-Anbox Cloud 1.21.2
reference/release-notes/1.21.1 Release notes-Anbox Cloud 1.21.1
reference/release-notes/1.21.0 Release notes-Anbox Cloud 1.21.0
reference/release-notes/1.20.2 Release notes-Anbox Cloud 1.20.2
reference/release-notes/1.20.1 Release notes-Anbox Cloud 1.20.1
reference/release-notes/1.20.0 Release notes-Anbox Cloud 1.20.0
reference/release-notes/1.19.2 Release notes-Anbox Cloud 1.19.2
reference/release-notes/1.19.1 Release notes-Anbox Cloud 1.19.1
reference/release-notes/1.19.0-fix1 Hotfix release announcement
reference/release-notes/1.19.0 Release notes-Anbox Cloud 1.19.0
reference/release-notes/1.18.2 Release notes-Anbox Cloud 1.18.2
reference/release-notes/1.18.1 Release notes-Anbox Cloud 1.18.1
reference/release-notes/1.18.0 Release notes-Anbox Cloud 1.18.0
reference/release-notes/1.17.2 Release notes-Anbox Cloud 1.17.2
reference/release-notes/1.17.1 Release notes-Anbox Cloud 1.17.1
reference/release-notes/1.17.0 Release notes-Anbox Cloud 1.17.0
reference/release-notes/1.16.4 Release notes-Anbox Cloud 1.16.4
reference/release-notes/1.16.3 Release notes-Anbox Cloud 1.16.3
reference/release-notes/1.16.2 Release notes-Anbox Cloud 1.16.2
reference/release-notes/1.16.1 Release notes-Anbox Cloud 1.16.1
reference/release-notes/1.16.0 Release notes-Anbox Cloud 1.16.0
reference/release-notes/1.15.3 Release notes-Anbox Cloud 1.15.3
reference/release-notes/1.15.2 Release notes-Anbox Cloud 1.15.2
reference/release-notes/1.15.1 Release notes-Anbox Cloud 1.15.1
reference/release-notes/1.15.0 Release notes-Anbox Cloud 1.15.0
reference/release-notes/1.14.2 Release notes-Anbox Cloud 1.14.2
reference/release-notes/1.14.1 Release notes-Anbox Cloud 1.14.1
reference/release-notes/1.14.0 Release notes-Anbox Cloud 1.14.0
reference/release-notes/1.13.2 Release notes-Anbox Cloud 1.13.2
reference/release-notes/1.13.1 Release notes-Anbox Cloud 1.13.1
reference/release-notes/1.13.0 Release notes-Anbox Cloud 1.13.0
reference/release-notes/1.12.5 Release notes-Anbox Cloud 1.12.5
reference/release-notes/1.12.4 Release notes-Anbox Cloud 1.12.4
reference/release-notes/1.12.3 Release notes-Anbox Cloud 1.12.3
reference/release-notes/1.12.2 Release notes-Anbox Cloud 1.12.2
reference/release-notes/1.12.1 Release notes-Anbox Cloud 1.12.1
reference/release-notes/1.12.0 Release notes-Anbox Cloud 1.12.0
reference/release-notes/1.11.5 Release notes-Anbox Cloud 1.11.5
reference/release-notes/1.11.4 Release notes-Anbox Cloud 1.11.4
reference/release-notes/1.11.3 Release notes-Anbox Cloud 1.11.3
reference/release-notes/1.11.2 Release notes-Anbox Cloud 1.11.2
reference/release-notes/1.11.1 Release notes-Anbox Cloud 1.11.1
reference/release-notes/1.11.0 Release notes-Anbox Cloud 1.11.0
reference/release-notes/1.10.3 Release notes-Anbox Cloud 1.10.3
reference/release-notes/1.10.2 Release notes-Anbox Cloud 1.10.2
reference/release-notes/1.10.1 Release notes-Anbox Cloud 1.10.1
reference/release-notes/1.10.0 Release notes-Anbox Cloud 1.10.0
reference/release-notes/1.9.5 Release notes-Anbox Cloud 1.9.5
reference/release-notes/1.9.4 Release notes-Anbox Cloud 1.9.4
reference/release-notes/1.9.3 Release notes-Anbox Cloud 1.9.3
reference/release-notes/1.9.2 Release notes-Anbox Cloud 1.9.2
reference/release-notes/1.9.1 Release notes-Anbox Cloud 1.9.1
reference/release-notes/1.9.0 Release notes-Anbox Cloud 1.9.0
reference/release-notes/1.8.3 Release notes-Anbox Cloud 1.8.3
reference/release-notes/1.8.2 Release notes-Anbox Cloud 1.8.2
reference/release-notes/1.8.1 Release notes-Anbox Cloud 1.8.1
reference/release-notes/1.8.0 Release notes-Anbox Cloud 1.8.0
reference/release-notes/1.7.4 Release notes-Anbox Cloud 1.7.4
reference/release-notes/1.7.3 Release notes-Anbox Cloud 1.7.3
reference/release-notes/1.7.2 Release notes-Anbox Cloud 1.7.2
reference/release-notes/1.7.1 Release notes-Anbox Cloud 1.7.1
reference/appliance-command-reference/ams Appliance command reference - ams
reference/appliance-command-reference/dashboard Appliance command reference - dashboard
reference/appliance-command-reference/destroy Appliance command reference - destroy
reference/appliance-command-reference/gateway Appliance command reference - gateway
reference/appliance-command-reference/help Appliance command reference - help
reference/appliance-command-reference/init Appliance command reference - init
reference/appliance-command-reference/status Appliance command reference - status
reference/appliance-command-reference/upgrade Appliance command reference - upgrade
reference/amc-command-reference/addon AMC command reference - addon
reference/amc-command-reference/application AMC command reference - application
reference/amc-command-reference/benchmark AMC command reference - benchmark
reference/amc-command-reference/completion AMC command reference - completion
reference/amc-command-reference/config AMC command reference - config
reference/amc-command-reference/delete AMC command reference - delete
reference/amc-command-reference/exec AMC command reference - exec
reference/amc-command-reference/help AMC command reference - help
reference/amc-command-reference/image AMC command reference - image
reference/amc-command-reference/info AMC command reference - info
reference/amc-command-reference/init AMC command reference - init
reference/amc-command-reference/launch AMC command reference - launch
reference/amc-command-reference/list AMC command reference - list
reference/amc-command-reference/logs AMC command reference - logs
reference/amc-command-reference/node AMC command reference - node
reference/amc-command-reference/remote AMC command reference - remote
reference/amc-command-reference/shell AMC command reference - shell
reference/amc-command-reference/show-log AMC command reference - show-log
reference/amc-command-reference/show AMC command reference - show
reference/amc-command-reference/start AMC command reference - start
reference/amc-command-reference/stop AMC command reference - stop
reference/amc-command-reference/wait AMC command reference - wait

Redirects

Mapping table
Path Location
/docs/tut/creating-addon /docs/tutorial/creating-addon
/docs/tut/getting-started-dashboard /docs/tutorial/getting-started-dashboard
/docs/tut/getting-started /docs/tutorial/getting-started
/docs/tut/installing-appliance /docs/tutorial/installing-appliance
/docs/tut/landing /docs/tutorial/landing
/docs/tut/stream-client /docs/tutorial/stream-client
/docs/ref/addon-manifest /docs/reference/addon-manifest
/docs/ref/ams-configuration /docs/reference/ams-configuration
/docs/ref/anbox-https-api /docs/reference/anbox-https-api
/docs/ref/android-features /docs/reference/android-features
/docs/ref/api-reference /docs/reference/api-reference
/docs/ref/application-manifest /docs/reference/application-manifest
/docs/ref/component-versions /docs/reference/component-versions
/docs/ref/glossary /docs/reference/glossary
/docs/ref/hooks /docs/reference/hooks
/docs/ref/landing /docs/reference/landing
/docs/ref/license-information /docs/reference/license-information
/docs/ref/network-ports /docs/reference/network-ports
/docs/ref/perf-benchmarks /docs/reference/perf-benchmarks
/docs/ref/prometheus /docs/reference/prometheus
/docs/ref/provided-images /docs/reference/provided-images
/docs/ref/releases-versions /docs/reference/releases-version
/docs/ref/requirements /docs/reference/requirements
/docs/ref/roadmap /docs/reference/roadmap
/docs/ref/sdks /docs/reference/sdks
/docs/ref/supported-codecs /docs/reference/supported-codecs
/docs/ref/supported-rendering-resources /docs/reference/supported-rendering-resources
/docs/ref/supported-versions /docs/reference/supported-versions
/docs/ref/webrtc-streamer /docs/reference/webrtc-streamer
/docs/ref/release-notes /docs/reference/release-notes
/docs/ref/appliance-command-reference/landing /docs/reference/appliance-command-reference/landing
/docs/ref/appliance-command-reference/ams /docs/reference/appliance-command-reference/ams
/docs/ref/appliance-command-reference/cluster /docs/reference/appliance-command-reference/cluster
/docs/ref/appliance-command-reference/dashboard /docs/reference/appliance-command-reference/dashboard
/docs/ref/appliance-command-reference/destroy /docs/reference/appliance-command-reference/destroy
/docs/ref/appliance-command-reference/gateway /docs/reference/appliance-command-reference/gateway
/docs/ref/appliance-command-reference/help /docs/reference/appliance-command-reference/help
/docs/ref/appliance-command-reference/init /docs/reference/appliance-command-reference/init
/docs/ref/appliance-command-reference/landing /docs/reference/appliance-command-reference/landing
/docs/ref/appliance-command-reference/status /docs/reference/appliance-command-reference/status
/docs/ref/appliance-command-reference/upgrade /docs/reference/appliance-command-reference/upgrade
/docs/ref/amc-command-reference/landing /docs/reference/amc-command-reference/landing
/docs/ref/amc-command-reference/addon /docs/reference/amc-command-reference/addon
/docs/ref/amc-command-reference/application /docs/reference/amc-command-reference/application
/docs/ref/amc-command-reference/benchmark /docs/reference/amc-command-reference/benchmark
/docs/ref/amc-command-reference/completion /docs/reference/amc-command-reference/completion
/docs/ref/amc-command-reference/config /docs/reference/amc-command-reference/config
/docs/ref/amc-command-reference/delete /docs/reference/amc-command-reference/delete
/docs/ref/amc-command-reference/exec /docs/reference/amc-command-reference/exec
/docs/ref/amc-command-reference/help /docs/reference/amc-command-reference/help
/docs/ref/amc-command-reference/image /docs/reference/amc-command-reference/image
/docs/ref/amc-command-reference/info /docs/reference/amc-command-reference/info
/docs/ref/amc-command-reference/init /docs/reference/amc-command-reference/init
/docs/ref/amc-command-reference/launch /docs/reference/amc-command-reference/launch
/docs/ref/amc-command-reference/list /docs/reference/amc-command-reference/list
/docs/ref/amc-command-reference/logs /docs/reference/amc-command-reference/logs
/docs/ref/amc-command-reference/node /docs/reference/amc-command-reference/node
/docs/ref/amc-command-reference/remote /docs/reference/amc-command-reference/remote
/docs/ref/amc-command-reference/shell /docs/reference/amc-command-reference/shell
/docs/ref/amc-command-reference/show-log /docs/reference/amc-command-reference/show-log
/docs/ref/amc-command-reference/show /docs/reference/amc-command-reference/show
/docs/ref/amc-command-reference/start /docs/reference/amc-command-reference/start
/docs/ref/amc-command-reference/stop /docs/reference/amc-command-reference/stop
/docs/ref/amc-command-reference/wait /docs/reference/amc-command-reference/wait
/docs/exp/landing /docs/explanation/landing
/docs/exp/aar /docs/explanation/aar
/docs/exp/addons /docs/explanation/addons
/docs/exp/ams /docs/explanation/ams
/docs/exp/anbox-cloud /docs/explanation/anbox-cloud
/docs/exp/application-streaming /docs/explanation/application-streaming
/docs/exp/applications /docs/explanation/applications
/docs/exp/capacity-planning /docs/explanation/capacity-planning
/docs/exp/clustering /docs/explanation/clustering
/docs/exp/gpus-instances /docs/explanation/gpus-instances
/docs/exp/instances /docs/explanation/instances
/docs/exp/performance /docs/explanation/performance
/docs/exp/platforms /docs/explanation/platforms
/docs/exp/production /docs/explanation/production
/docs/exp/rendering-architecture /docs/explanation/rendering-architecture
/docs/exp/resources /docs/explanation/resources
/docs/exp/security /docs/explanation/security
/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/howto/stream/web-client /docs/tut/stream-client
/docs/howto/troubleshoot/collect-info /docs/howto/troubleshoot/landing
/docs/manage/managing-containers /docs/exp/instances
/docs/exp/gpu-support /docs/explanation/gpus-instances
/docs/howto/container/launch /docs/howto/instance/create
/docs/howto/stream/debug /docs/howto/troubleshoot/streaming-issues
/docs/howto/manage/logs /docs/howto/troubleshoot/logs
/docs/ref/platforms /docs/explanation/platforms
/docs/ref/instance-types /docs/reference/application-manifest
/docs/ref/supported-video-codecs /docs/reference/supported-codecs
/docs/howto/addons/best-practices /docs/explanation/addons
/docs/ref/addons /docs/reference/addon-manifest
/docs/howto/manage/manage-appliance /docs/reference/appliance-command-reference/landing
/docs/exp/containers /docs/explanation/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/explanation/resources