Merge branch 'docs-1.x' into develop

docs/sources/project/building_from_source.md

@@ -0,0 +1,71 @@
+---
+page_title: Building from source
+page_description: Building from source Grafana.
+page_keywords: grafana, build, contribute, documentation
+---
+
+# Building Grafana from source
+
+Guide for creating packages from source, and for getting grafana up and running in
+dev environment.
+
+## Dependencies
+
+- Go 1.4
+- NodeJS
+
+
+## Get Code
+
+```
+go get github.com/grafana/grafana
+```
+
+The above will give an error saying there is no go code. That is because the new backend parts are in the develop branch.
+
+## Building the backend
+```
+cd $GOPATH/src/github.com/grafana/grafana
+git checkout -t origin/develop
+go run build.go setup            (only needed once to install godep)
+godep restore                    (will pull down all golang lib dependecies in your current GOPATH)
+go build .
+```
+
+## Building frontend assets
+
+To build less to css for the frontend you will need a recent version of of node (v0.12.0),
+npm (v2.5.0) and grunt (v0.4.5). Run the following:
+
+```
+npm install
+npm install -g grunt-cli
+grunt
+```
+
+## Recompile backend on source change
+To rebuild on source change (requires that you executed godep restore)
+```
+go get github.com/Unknwon/bra
+bra run
+```
+
+## Running
+```
+./bin/grafana web
+```
+
+Open grafana in your browser (default http://localhost:3000) and login with admin user (default user/pass = admin/admin).
+
+## Dev config
+
+Create a custom.ini in the conf directory to override default configuration options.
+You only need to add the options you want to override. Config files are applied in the order of:
+
+1. grafana.ini
+2. dev.ini (if found)
+3. custom.ini
+
+## Create a pull requests
+
+Before or after your create a pull requests, sign the [contributor license aggrement](/docs/contributing/cla.html).