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:

grafana.ini
dev.ini (if found)
custom.ini

Create a pull requests

Before or after your create a pull requests, sign the contributor license aggrement.

building_from_source.md 1.7 KB Historik Rå