Installing Corona — Windows

This guide will help you get up and running with Corona for Windows.

Installing Corona

You do not need to install the Android SDK to use Corona. However, to create device builds to test on actual Android devices, you will need the Java Development Kit. The installation process is described below.

We'll assume you've already downloaded Corona. Now, double click the .msi installer file and follow the steps in the installation wizard.


There are two ways to stay current with releases/builds of Corona:

  • Public Release — The latest stable release of Corona, providing maximum reliability for your projects. This is updated several times a year.

  • Daily Builds — The bleeding edge. Daily builds contain the latest features as they are integrated into Corona.

Product Activation

In order to use Corona, you must be connected to the Internet and perform a simple one-time authorization process.

  1. Open the Corona Simulator from the folder where you installed it. The first time you launch, you will be presented with a License Agreement (EULA). Read the license terms and click Agree.

  2. If you've already registered for a Corona account, simply enter your account e-mail and password to activate the product. Otherwise, click Register to create an account.

  1. Upon successful login, you will receive a confirmation dialog. You're ready to get started!

Java Development Kit

Installing Corona lets you create and test apps locally on your PC. If you intend to build apps for testing on Android devices, you will need to install the Java Development Kit (JDK). We suggest that you follow these instructions:

  1. Go to the JDK download page.
  2. Click the JDK download link to obtain the current Java Platform (JDK).
  3. On the next page, read the license agreement and click the option to accept it if you agree.
  4. Locate the Windows x86 link and click it to download the file. This file will be named approximately jdk-8u131-windows-i586.exe.
  5. When the download is complete, run the installer. Be sure to install the Java Runtime Environment (JRE) as part of the installation.

Text Editors

You'll need a text editor or IDE to write code for your Corona projects. If you don't already have a favorite text editor, the following options are recommended:

Development Environment

The Corona development environment consists of two aspects: the Corona Simulator and the Corona Simulator Console window.

Simulator Options

The Corona Simulator for Windows features the following basic menu items:

Getting Started

If you're new to Corona, the most fun way to learn is to create a simple game. Don't worry if you've never created a mobile app or programmed before — the chapters in the guide will walk you through the entire process from start to finish!

Command Line Usage

To start a particular app in the Corona Simulator without double-clicking it, use a command like this:

"C:\Program Files\Corona Labs\Corona\Corona Simulator.exe" "C:\Documents and Settings\MyAccount\My Documents\Corona Apps\My App\main.lua"

If you don't want the Corona Simulator Console window to automatically appear, use the /no-console option:

"C:\Program Files\Corona Labs\Corona\Corona Simulator.exe" /no-console

After using the /no-console option above, all Lua print() functions and Corona log messages can be received via the standard output stream (stdout).

One additional flag is allowed (/debug) which allows an IDE to connect a debugger to the Simulator session. It should come immediately after the .exe.