Previous / Next

Tutorial 2 - Launching Maqetta

When going through Maqetta's tutorials, it is suggested that you have two side-by-side browser windows open, one showing the tutorial, and the other where you run the application and perform the steps listed in the tutorial.

Topics covered:

Different ways to launch the Maqetta application

You can launch the Maqetta application in the following ways:

The sections below walk you through the getting start process for each of the above options.

Run the Maqetta application at Maqetta.org

You can run the Maqetta application by simply going to Maqetta.org and then clicking on the "Launch Maqetta" button.

This will take you to the login screen.

New users will need to click on the Register button (at the bottom of the previous snapshot), which will take you to the Register screen. Enter your email address and click "Sign up".

It is VERY IMPORTANT that you enter a valid email address and make sure that you typed the email address correctly. You will not be able to complete registration if you enter an incorrect or invalid email address.

An activation email will be sent to your email address. Clicking on the hyperlink in the email will take you back to Maqetta.org, to the create account screen, where you can enter your Maqetta.org password:

After clicking on "Sign up", you will enter the Maqetta application.

Run the Maqetta application locally (i.e., local install)

With this option, you perform these steps:

  1. Download a ZIP file that contains the Maqetta application (see notes below)
  2. Unzip onto your local filesystem
  3. Double-click on a launch script to start up the Maqetta application (running as a local web server, with default port of 50000)
  4. Enter an appropriate URL (such as http://localhost:50000/maqetta) into the browser's address bar.

If you want to download the public release of Maqetta from Maqetta.org, you have two options:

If your company has installed Maqetta on its own servers, they might also provide a ZIP file that you can download, where that downloadable Maqetta might include your company's widgets and themes.

After expanding (unzipping) the ZIP file, there will be a readme.html file that contains detailed descriptions of system pre-requisites and launch instructions. Many users, however, can simply:

If you downloaded the ZIP from Maqetta.org, you will be presented with the following screen:

The first time you run a local install download from Maqetta.org, you will need to click on the "Register" button (see the bottom of the above picture) to create a user account and password. After you click "Register", you should see this screen:

In the above picture, you need to enter a valid email address and your password.

Once you have created a user account, in the future you can just enter that user account and password onto the login screen - you only need to "Register" once.

Be sure to remember your login and password. There is no way to retrieve or reset your logins or passwords for a local install.

Install on a server (e.g., intranet server)

The Maqetta team provides detailed instructions for setting up Maqetta to run on a Unix server. Maqetta will probably run on other servers (e.g., Windows or Mac), but you might have to figure some things out on your own.

This option follows many of the same steps as the local install option.

  1. Download a ZIP file that contains the Maqetta application (see notes below)
  2. Unzip onto your server's filesystem
  3. Customize the configuration files to match your requirements
  4. Set up your server to launch Maqetta (and relaunch at server start time)

After setting up the configuration settings and starting the Maqetta server, users will be able to run Maqetta by entering http://yourserver:port/path-to-maqetta into the browser address bar.


Previous / Next