HowTo: Prototyping My iOS Application on My Mac

Official Content
This documentation is valid for:

To prototype your iPhone or iPad application on your Mac, you must follow these steps.

Install requirements

Check Mac requirements on Apple Requirements

Enable ssh

Go to System preferences.


Then, go to the Sharing option.


Check Remote Login.


You'll need to allow access to the user you will use to connect from your Windows computer. 

Change the default shell to bash

The latest versions of macOS use zsh as the default shell, but it is not supported by GeneXus. You must change it to bash.

To do that, open and execute the following command:

chsh -s /bin/bash

The next time you open it will be using bash, and also it will be used when you connect via SSH (as GeneXus does).

Set GeneXus properties

Set  Mac Host, Mac User and Mac Password properties on GeneXus.

iOS Specific properties


Mac Host Your Mac computer name (computer name property on the "Remote Login" settings).
Mac User User to connect the Windows computer to the Mac computer (allowed previously on the "Remote Login" settings).
Mac Password  Mac user password.

Run the application

You can use the Mac computer for prototyping the application with all the benefits provided by Apple.



  • You can get a paid or free version from Apple. A benefit of getting the paid one is that it allows you to test the application on the device, not just using the emulator.
    Anyway, to test with the device exists Knowledge Base Navigator option, quick and simple.
  • This error message could appear during the transfer from GeneXus when the Sharing option is not enabled: No connection could be made because the target machine actively refused it
  • You have to use Bash as default shell or you will have an error similar to this: Error 1 reading target directory. error: zsh:1: parse error near `}'


Start Video Prototyping features and Deployment of applications