<page xmlns="http://projectmallard.org/1.0/"
      type="topic" style="task"
      id="create">
  <info>
    <revision pkgversion="3.8.0" date="2013-03-17" status="candidate"/>
    <revision pkgversion="3.14.0" date="2014-09-06" status="review"/>
    <revision pkgversion="3.24.0" date="2017-05-02" status="review"/>
    <link type="guide" xref="index#start"/>

    <credit type="author copyright">
      <name>Michael Hill</name>
      <email>mdhillca@gmail.com</email>
      <years>2013</years>
    </credit>

    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>

    <desc>Click <gui style="button">+</gui> to begin creating a box.</desc>
  </info>

  <title>Create a box</title>

  <p>When <app>Boxes</app> is launched, the collection view opens, displaying
  your existing boxes. If you haven't yet created a box, an introductory
  message is displayed.</p>

  <steps>
    <item><p>Click <gui style="button">New</gui> in the top left corner to launch
    the box creation wizard.</p></item>
    <item><p>At the wizard's <gui>Source Selection</gui> screen, choose a source
    to determine the type of box you want to create. A local virtual machine
    can be created from:</p>

      <list>
        <item><p>An ISO found by <app>Boxes</app>.</p></item>
        <item><p>Installation media on a CD/DVD/USB drive.</p></item>
        <item><p>A local ISO file (if not found automatically above).</p></item>
        <item><p>A URL to a <link xref="connect">remote</link> machine.</p></item>
      </list>

      <note style="important">
        <p>If your installation media supports <gui>Express Installation</gui>,
        the installation will proceed without further input.</p>
      </note>
    </item>

    <item><p>After making your selection, or providing the necessary
    information, click <gui style="button">Continue</gui>, which will take you to 
    the <gui>Review</gui> page.</p></item>
    <item><p>If the box is local, click <gui style="button">Customize</gui> to
    adjust memory or disk size, or to rename the box.</p></item>
    <item><p>Click <gui style="button">Create</gui>.</p></item>
  </steps>

  <p>The collection view returns, and the installation of the box begins.</p>

</page>
