Recents

How to prepare a Mac with ARM architecture for GeneXus

This documentation is valid for:

This document provides the steps to install GeneXus, as well as considerations and existing restrictions regarding Apple M1 and M2 CPUs.

The required steps are as follows:

Install desktop virtualization software
Install Windows ARM
Install LocalDB
Install GeneXus
Install requirements for prototyping

1. Install desktop virtualization software

Since the GeneXus IDE runs on Windows, you need to install some desktop virtualization software and install a virtual machine. In this case, installing Parallels is suggested and the ongoing steps have been tested on it.

In addition to the Parallels requirements, you need to take into account the requirements associated with GeneXus.

2. Install Windows ARM

The Windows version that must be installed in Parallels is Windows ARM.

If you use the version suggested by Parallels, download the Home version of Windows 11 ARM.

Notes:

To download Windows ARM, you need to log in with a Microsoft account and be a member of the Windows Insider program (free). After downloading, install with Parallels pointing to that image.
An Insider version of Windows 11 ARM can be downloaded.
Even though GeneXus is an x86 32-bit app, Windows 11 ARM can emulate x86 and x64 apps.

3. Install Microsoft SQL Express LocalDB

Install SQL Server Express LocalDB. It works fine on Windows ARM and is suitable for storing KBs.

You must install LocalDB and not any other edition of SQL Server because none is compatible with Windows ARM.

4. Install GeneXus

Follow the GeneXus Installation Steps described in the GeneXus 18 Installation Manual

5. Install requirements for Application Prototyping

Since SQL Server is not suitable for Windows ARM, you need to find alternative DBMSes to prototype your applications

For this scenario, the options are:

Use GeneXus Prototyping Cloud
To use it, create an environment and choose 'GeneXus Prototyping Cloud', or select Deploy to cloud on an existing environment.
This avoids the need to have the DBMS installed locally.
Use Docker container with SQL Server
To use SQL Server with GeneXus .NET Generator locally, you must install the latest Docker version. Then, run a Docker SQL instance, as shown below:
```
docker run -e "ACCEPT_EULA=1" -e "MSSQL_SA_PASSWORD=MyPass@word" -e "MSSQL_PID=Desarrollador" -e "MSSQL_USER=SA" -p 1433:1433 -d --name=sql mcr.microsoft.com/ azure-sql-borde
```
Finally, install Azure Data Studio and set 127.0.0.1 as the server. Take into account that the Docker container is hosted on port 1433, the default port for SQL. Also, set the user to sa and the password to MyPass@word or whatever values you have chosen.
Use another DBMS that is not SQL Server. For example, MySQL has an ARM version for Mac. You can install MySQL Server on the Mac and then point the GeneXus data store to the Mac hostname or IP in the data store properties

Check GeneXus 18 hardware and software requirements for other requirements for prototyping applications. On each, take into account that you need a specific setup for Windows ARM.

Considerations

Android applications cannot be compiled on the M1 from GeneXus. You can do it externally from Android Studio on the MAC.