Getting Started with the Mako Server

To fast track your Mako Server development, follow these simple steps:

  1. Read this page and watch the video below
  2. Download the Mako Server
  3. Download the manual and tutorial
  4. Complete the tutorial downloaded in step 3 (the Lua and LSP tutorial)

Prerequisites (What You Need To Know)

Although the server can be installed as a background process (aka daemon), you'll find it a whole lot more convenient to start and stop the server using the command line during web application development. We assume you have sufficient experience in running command line programs. We also assume that you have experience in using text editors such as Notepad on Windows and some experience in HTML and CSS design.

You do not need to know how to design or create server side Lua web applications. All you need to learn in order to get started with Lua and LSP is included in the Lua and LSP tutorial.

Command Line

You can start the Mako Server from the command line as soon as you have unpacked the server. The image slideshow below shows how to start the Mako Server on Windows and Linux. Mac users should use the Linux commands.

The server will automatically use alternative port numbers if the server is unable to open the default HTTP port number 80 and HTTPS port number 443. The center image above shows the server using alternative port numbers.

You can navigate to the server using a browser as soon as the server is running.

Enter http://your-server-address:port in your browser, where "your-server-address" is the domain or IP address to the computer running BarracudaDrive and "port" is the port number the server is listening on. You do not need to enter the port number if the server is listening on the default port 80.

Don't be alarmed when you see a "404 page not found" message in your browser. The reason you received this “not found” message is that you have not yet configured the server to load any applications. Therefore you must load at least one application.

Command Line Tutorial

To load an application, create a new directory such as "example" and start the server as follows:

mako -l::example

The above command tells the Mako Server to load the directory "example" as a root application. (See also the command line documentation for a detailed explanation of the above command.)

Note: you will still get a “404 page not found” message when navigating to the server since you do not yet have any web pages in your newly created directory. You should now go ahead and create a new file in this directory. This can be done by simply performing a copy and paste of the LSP example (shown on the right here) into the file by using your favorite editor.

Save the file as "example/index.lsp" and press the browser's refresh button. You should now see a page that is dynamically created by the server. Note that the page you have created will change dynamically every time you press the refresh button.

Command Line Video Tutorial

The following three minute video gives an introduction in how to use the Mako Server from the command line: