---
layout: default
title: Getting started
---
      <div class="row">
        <div class="col-md-12">
          <div class="page-header">
            <h1>Getting Started</h1>
          </div>
          <p>This page will help you to get started with EWF.
          We will first see how to install EWF and then how to compile and run the venerable <i>Hello World</i> example.</p>
          <h2>Installation</h2>
          <h3>EiffelStudio</h3>
          <p>Latest EiffelStudio release comes with latest EWF version: there is nothing to do in this case.</p>
          <p>If you are using an older version of EiffelStudio, we recommand to download the latest EWF version ({{ site.version }} as of this writing) instead of using the one that comes with EiffelStudio.</p>
          <h3>Download</h3>
          <p>Follow these steps to download and install EWF on your computer:</p>
          <ol>
            <li><a href="{{ site.download }}">Dowload the archive</a></li>
            <li>Create a directory where you will put your custom Eiffel libraries</li>
            <li>Extract EWF in the newly created directory</li>
            <li>Define the environment variable EIFFEL_LIBRARY to point to the newly created directory</li>
          </ol>
          <h3>Source code</h3>
          <p>The source code is available on Github.
          You can get it by running the command:</p>
          <pre><code>git clone git://github.com/EiffelWebFramework/EWF.git</code></pre>
          <h2>Hello World</h2>
          <p>The hello world example is located in the directory <i>$ISE_EIFFEL/contrib/examples/web/ewf/simple</i>.
          Just double click on the <i>simple.ecf</i> file and select the <i>simple</i> target or if you prefer the command line, run the command:</p>
          <pre><code>estudio -config simple.ecf -target simple</code></pre>
          <p>Once the project is compiled, you can launch the application and point your browser to <a href="http://localhost:9090">http://localhost:9090</a>.
          You should now see a simple page with <i>Hello World</i>.</p>
          <h2>Next steps</h2>
          <ul>
            <li>Take a look at the other examples</i></li>
            <ul>
              <li>located in <i>$ISE_EIFFEL/contrib/examples/web/ewf</i></li>
              <li><a href="https://github.com/EiffelWebFramework/ewf_examples">available on Github</a></li>
            </ul>
            <li>Read the <a href="{{ site.url }}/workbook/workbook">Overview</a></li>
          </ul>
        </div>
      </div>
