Skip to content

Windows Installation Instructions

Martin Hecher edited this page Nov 11, 2015 · 9 revisions
  1. Install Docker Toolbox as a prerequisite

  2. Open Kitematic (which should be available on your Desktop after installing Docker Toolbox in step 1). When Kitematic is successfully started you have the base setup done and can continue with the next steps. If Kitematic is not starting the next steps will NOT work.

  3. Download the latest version of the installer here (it is a ZIP file)

  4. Extract the ZIP file and run the duraark-install executable. Wait until the installer finishes, which may take several minutes to download the system, depending on the internet connection. Don't get confused by weird console windows, everything will be fine.

  5. After the duraark-installer is finished run the duraark-start executable.

  6. Start Kitematic again if it is not open. You should see something similar to this screenshot:

DURAARK System started

Click on the duraarkinstaller_web_1 item (see marker '1') and wait until you see the the DURAARK system in the preview windows. It can take a few minutes until the preview window is loaded, as DURAARK is starting in the background, which may take some minutes.

After that click on the cog symbol (see marker '2'). This opens a window where you click on the URL (marked in the screenshot below). As web browser we strongly suggest Chrome or Thunderbird (opening the URL with Microsoft Edge on Windows 10 is not working for some reason).

DURAARK System started

The DURAARK System opens up in your browser:

DURAARK System started

(Optional) Make the system available at the URL 'http://localhost'

Depending on your setup the URL of the DURAARK System the URL may differ on other systems. To have the system always accessible at the default URL http://localhost do the following (this step is mandatory if are plan to use the windows integration script).

  1. Open "Oracle VM VirtualBox" from the start menu. You should see something similar to this screenshot:

VirtualBox default screenshot

  1. To make the system available at http://localhost you have to add a port forward rule. This screenshot shows you how to do that:

VirtualBox port forwarding steps

First select the "default" entry on the left and click the settings symbol (mark 1). This opens up the settings (mark 2). Here click the "Network" icon (mark 3) and then the "Port forward" button (mark 4). Add a new rule with the "+" icon (mark 5) and enter the following values (mark 6):

  • Name: web (this is arbitrary)
  • Protocol: TCP
  • Host IP: leave empty
  • Host port: 80
  • Guest IP: leave empty
  • Guest port: 80

After a click on "OK" (mark 7) open a browser an enter http://localhost in the address bar. DURAARK will show up at this address then.

You only have to do this setup once, it will persist on restarts of the system.

Restarting the system

When your computer is restarted the DURAARK System will not be started automatically. To start it again execute the duraark-start executable in the downloaded and unzipped duraark-installer-vx.x.x folder ('x.x.x' stands for the version number).

Troubleshooting

If you are experiencing problems with the DURAARK System (e.g. the landing page does not show up after an update of the system or after a computer restart) there are two possible actions to repair the system:

  1. From the duraark-installer folder execute the duraark-stop script first, followed by executing the duraark-startexecutable. This will restart the system and keeps the data that you added to the system (e.g. new building sessions).

  2. From the duraark-installer folder execute the duraark-reset script. This will start a fresh instance of the DURAARK System, but will also remove all building sessions that you added before.

The first action is save to execute, you will not loose data. The second one destroys existing data, but will also resolve almost every issue.