README.md

FreeNAS 11 WebUI

This is the project for the new angular.io (5.x) WebUI for FreeNAS 11. It is meant to coexist with current FreeNAS 11 Django/Dojo WebUI.

Development requirements

• npm >= 5
• Node.js >= 5
• Running FreeNAS 11 Nightly Machine (VM is fine)

Getting started

Install the development requirements (FreeBSD 11 or later):

# pkg install node6
# pkg install npm

On some Operating Systems it is quickest to install npm > 3 first then install npm:

# npm install -g npm5

Checkout FreeNAS git repository:

$ git clone https://github.com/freenas/webui.git
$ cd webui

Install npm packages:

$ npm install

Run the environment configuration script (if your ip address changes later you may repeat this step)

$ ./setup_env.js -i <ip address>

To start run npm start

This should open the browser with the WebUI, by default http://localhost:4200.

To test AOT in dev mode run

npm run start:dev:aot

To run the production build, run

npm run build:prod:aot

Locale Translations

To extract all of the strings from the project to be translated run: npm run extract

This will update all of the PO files located in the directory src/assets/i18n then you can use your favorite PO editor to translate.