How do I start using Genymotion on a Linux operating system?
Starting Genymotion on Linux
We will guide you step-by-step through the installation and first start of Genymotion Desktop on a Linux distribution.
### 1️⃣ Requirements
| Component | Requirement | Note |
|------------|-------------|---------|
| **CPU** | Intel Core i5 or higher (64-bit) | |
| **RAM** | 16 GB+ | |
| **GPU** | OpenGL 3.3-capable graphics processor | For NVIDIA cards, we recommend the proprietary driver |
| **Storage** | 120 MB for Genymotion + 1 GB per virtual Android device | |
| **Distro** | Ubuntu LTS, Debian Stable, Fedora Workstation (64-bit) | Other distros are not officially supported |
| **Hypervisor** | QEMU (Standard, recommended) | VirtualBox is possible, but outdated |
> **💡 Tip:** If you have an NVIDIA graphics card, install the proprietary NVIDIA driver to avoid graphics errors. (see [Linux Genymotion Crash FAQ](https://support.genymotion.com/hc/en-us/articles/360002732938-Linux-Genymotion-Desktop-crashes-when-starting-a-Virtual-Device))
### 2️⃣ Download and Install
1. Visit the [Download Page](https://genymotion.com/product-desktop/download)
- Select your distribution (Ubuntu, Debian, Fedora)
- Download the 64-bit version (SHA-256: `48ff1448afb3bce02288ee771674d4a9f63b475f40bb29c3d44c5a716332b505`)
2. Extract the archive, for example:
```bash
tar -xvf genymotion_3.9.0_amd64.tar.xz
```
3. Change into the directory and run the installation script:
```bash
cd genymotion
sudo ./install.sh
```
*If you don't have root rights, install it only for your user:*
```bash
./install.sh
```
4. After installation, you will find the application in the application menu or start it from the terminal:
```bash
~/genymotion/genymotion
```
*(or `/opt/genymotion/genymotion`, if you installed globally)*
### 3️⃣ First Start & Setup
1. **Login**
- Start Genymotion.
- Log in with your Genymotion account or create a new one.
2. **Network**
- If you work behind a proxy, open *View → Proxy Options* and enter the proxy details.
3. **License selection**
- For personal use, select *Personal use* (free).
- For advanced features and support, select *I have a license* (Pro license).
4. **Dashboard**
- Once you are logged in, the *Genymotion Launcher Dashboard* appears.
- Here, you can add, start, or manage virtual devices.
### 4️⃣ Common Problems & Solutions
| Problem | Solution |
|---------|--------|
| **Virtual device does not start / display is black** | Install the proprietary NVIDIA driver. |
| **QEMU error** | Ensure KVM is installed and enabled (`sudo apt install qemu-kvm`) |
| **Devices not displayed** | Check if you have the latest version of Genymotion and VirtualBox/QEMU. |
| **Proxy problems** | Set up the proxy settings correctly, as described above. |
---
> **🔍 Next step:** Once your first device is running, you can install apps, run automated tests, or integrate the platform into your CI/CD pipeline.
> Do you need help creating test scripts or setting up Genymotion in a CI environment?
---
**Question:** What version of your Linux distribution are you currently using (e.g., Ubuntu 22.04 LTS or Fedora 38)? This will help us provide you with the most accurate installation instructions.