✨ 2025 Year review

Make a minimalist Ubuntu + gmsaas Docker image

Our gmsaas CLI tool for Genymotion SaaS is a lightweight binary, coded in Python. It can be easily installed and executed within a minimalist Linux docker image. In this tutorial, we will cover how to create a minimalist Ubuntu 22.04 docker container with gmsaas and how to use it.

Pre-requiste

Dockerfile

Here is a Dockerfile you can use to create the docker image:

Dockerfile
FROM ubuntu:22.04

# Needed to pass tzdata interactive configuration
ENV DEBIAN_FRONTEND="noninteractive" TZ="Europe/London"

# Install packages as root
RUN apt-get -y update \
    && apt-get install -y \
        android-sdk \
        locales \
        python3 \
        python3-pip \
        sudo

# Set up environment variables
ENV ANDROID_HOME=/usr/lib/android-sdk

# Required by Python to use utf-8 by default
RUN locale-gen en_US.UTF-8
ENV LANG=en_US.UTF-8
ENV LC_ALL=en_US.UTF-8

# Create a non-root user
ARG USERNAME=appuser
ARG USER_UID=1000
ARG USER_GID=$USER_UID

RUN groupadd --gid $USER_GID $USERNAME \
    && useradd --uid $USER_UID --gid $USER_GID -m $USERNAME \
    && echo "$USERNAME ALL=(ALL) NOPASSWD:ALL" > /etc/sudoers.d/$USERNAME \
    && chmod 0440 /etc/sudoers.d/$USERNAME

# Give the new user ownership of the Android SDK directory if needed
RUN chown -R $USERNAME:$USERNAME $ANDROID_HOME

# Switch to the non-root user
USER $USERNAME
WORKDIR /home/$USERNAME

# Install Python packages as the non-root user
RUN pip3 install --user --upgrade pip \
    && pip3 install --user virtualenv \
    && pip3 install --user gmsaas \
    && ~/.local/bin/gmsaas config set android-sdk-path $ANDROID_HOME

# Make sure the .local/bin directory is in PATH
ENV PATH="/home/$USERNAME/.local/bin:${PATH}"

CMD ["/bin/bash"]

We recommend saving the file as “Dockerfile”, without any extensions.

Build the container and start using gmsaas

We assume that you are working in the same folder where you saved your Dockerfile. Then run the following command in a terminal:

Bash
docker build --tag genymotion/gmsaas . # Build the container from the Dockerfile
uuid=$(docker run --detach --tty --interactive genymotion/gmsaas)
docker exec -ti $uuid /bin/bash

You will then access the container bash terminal to pass your gmsaas commands. See gmsaas documentation for more details about gmsaas commands.

Stop the container

When done, you can stop the container with the command:

Bash
docker stop $uuid

Scroll to Top

Select Product Portal

SaaS Platform

Access to our SaaS solution and use virtual machines in the cloud on any web browsers.

Or

Or

Desktop Platform

Access to manage your Genymotion Desktop licenses, your invoices and account information.

How to get a quote for multiple Business Licenses?

  1. You need a Genymotion Desktop account. If you haven’t one yet, you can create it here.
  2. After creation and activation, or if you already have an account, follow this link.
  3. Add the number of desired licenses to your shopping cart and click “Continue to Billing”
  4. Add a shipping address, or select one if you already created one.
  5.  In the next page, click “Get a quote”:
    Payment details
  6. A quote will be automatically generated in PDF format.

Genymotion Device Image for Cloud providers
- Private Offer -

Genymotion Device On-premise
- Contact Us -

Genymotion SaaS
- Increase Maximum Simultaneous devices -

Genymotion SaaS Enterprise Plan
- Get a Quote -

Genymotion SaaS Premium Plan
- Get a Quote -

Personal Use - Free

Genymotion Desktop for personal use is not suitable for trial or POC: you will not get any assistance and some features will be disabled. If you have already selected “personal use” and wish to get a trial license, please contact our Sales at [email protected].

Technical support is not available with Genymotion Desktop free edition for personal use. For more details, please refer to Genymotion conditions of use (Personal Use).

The following features are not available in personal use mode:

Follow these steps to get Genymotion Desktop and activate personal use mode:

  1. Go to the Download page and get the latest version for your system.
  2. Follow the instructions from Genymotion Desktop quickstart guide to install Genymotion Desktop.
  3. Launch Genymotion and click CREATE to create an account. You should receive an activation email within an hour. If not, make sure to check your spam.
  4. After activating your account, return to Genymotion and log in with your credentials.
  5. Select personal use when prompted.
  6. Read Genymotion Desktop quickstart guide carefully to setup Genymotion for your needs.

Indie Plan Application Form

This plan is strictly reserved to individual workers (freelancers, self-employed).

Contact Sales
- Premium Plan -

Educational Plan Application Form

The Educational plan is restricted to:

  • schools, teachers or students who wish to use Genymotion Desktop for tuition
  • students who wish to use Genymotion Desktop for a school project

It is subject to valid proof (student card, teacher card, etc.)

Select a Cloud provider Marketplace