mirror of
https://github.com/grafana/grafana.git
synced 2025-07-29 23:52:19 +08:00
96008c9738
commit 4113ed00782590187d19dd2f8cbae683f164142c
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Fri Oct 21 10:47:35 2016 +0200
docs(): minor fix for docs index page
commit 45478d120571519462fac905aadeab5954696690
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Thu Oct 20 14:28:21 2016 +0200
updated
commit c9c1c1d5a462f85e8001a45218f24102583d7aee
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Thu Oct 20 14:27:34 2016 +0200
docs(): updated image refs
commit 5fa0f27963968d77bbbbb7edd973847ea72135e3
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Wed Oct 19 14:33:04 2016 +0200
docs is almost done
commit 6b988c90cb08563e2c27212338c2947e69f6fcc3
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Tue Oct 18 20:45:28 2016 +0200
almost done
commit 17757c21ed813892ddb1f289f2e52613caf7bcef
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Tue Oct 18 16:45:48 2016 +0200
making progress on docs
commit f06c815991dd81b8893912a6da04a17b80b63fda
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Tue Oct 18 14:30:55 2016 +0200
progress on new docs
commit 5197237426252623de2d8b9cc22ddbbdbb240763
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Tue Oct 18 13:25:26 2016 +0200
making progress
commit 33e2b6b617f16f65878141cf11e54b2817a2ea96
Merge: de385e5 ecb4a99
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Tue Oct 18 12:17:58 2016 +0200
Merge branch 'new-docs' of github.com:grafana/grafana into new-docs
commit ecb4a99dd54aa39f17d9bf4d7e132a389812f8fd
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Tue Oct 18 10:39:59 2016 +0200
keep urls for now
commit de385e56d86b071cf2150ccf9f1aa06ec5187277
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Mon Oct 17 17:56:18 2016 +0200
more progress
commit 8469ebc239ab2316cbbc01862e5026737f272f00
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Mon Oct 17 17:08:06 2016 +0200
progress on new docs
commit e755f656b12534cfcb23bad11f1fa696e43f7428
Merge: 4644a35 35cce3b
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Mon Oct 17 12:21:27 2016 +0200
Merge branch 'new-docs' of github.com:grafana/grafana into new-docs
commit 4644a35102555204787e91041b50dcbfe0f7a213
Merge: 25c4bef 977cdd5
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Mon Oct 17 12:21:11 2016 +0200
Merge branch 'master' of github.com:grafana/grafana into new-docs
commit 35cce3bef802fac020a53693b02c112a91a096fc
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Mon Oct 17 09:31:17 2016 +0200
progress on #6170
commit 25c4bef629de7d77218ba95cc3bd25fb50bb19d6
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Sun Oct 16 15:05:30 2016 +0200
fix for osx
commit 6c6b52f975630be87da23dd51beafaecb820cec2
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Sun Oct 16 12:56:39 2016 +0200
progress on new docs
commit 6a09633981ab26191d5542dbe3a788846ac6b73d
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Sat Oct 15 11:39:49 2016 +0200
progress on new docs
commit 7d533fbc23e41b86fd1ba9c955dd17ae1ad977e5
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Mon Oct 10 09:25:12 2016 +0200
making progress on new docs site
commit 50392ce98edfa201977716e92e4a86f9d48ae386
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Sun Oct 9 20:02:28 2016 +0200
feat(new docs): progress on new docs site
commit 81a3d3d0952d3a5d790412e90d01ac5a247e0686
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Fri Oct 7 07:52:11 2016 +0200
new docs site experiment
commit 704adc98664665b3624087ab38ce29fc9da005f1
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Sat Oct 1 20:46:53 2016 +0200
new docs poc
97 lines
2.9 KiB
Markdown
97 lines
2.9 KiB
Markdown
+++
|
|
title = "Building from source"
|
|
type = "docs"
|
|
[menu.docs]
|
|
parent = "installation"
|
|
weight = 5
|
|
+++
|
|
|
|
# Building Grafana from source
|
|
|
|
This guide will help you create packages from source and get grafana up and running in
|
|
dev environment. Grafana ships with its own required backend server; also completely open-source. It's written in [Go](http://golang.org) and has a full [HTTP API](/v2.1/reference/http_api/).
|
|
|
|
## Dependencies
|
|
|
|
- [Go 1.7](https://golang.org/dl/)
|
|
- [NodeJS](https://nodejs.org/download/)
|
|
|
|
## Get Code
|
|
Create a directory for the project and set your path accordingly. Then download and install Grafana into your $GOPATH directory
|
|
```
|
|
export GOPATH=`pwd`
|
|
go get github.com/grafana/grafana
|
|
```
|
|
|
|
## Building the backend
|
|
```
|
|
cd $GOPATH/src/github.com/grafana/grafana
|
|
go run build.go setup
|
|
go run build.go build # (or 'go build ./pkg/cmd/grafana-server')
|
|
```
|
|
|
|
#### Building on Windows
|
|
The Grafana backend includes Sqlite3 which requires GCC to compile. So in order to compile Grafana on windows you need
|
|
to install GCC. We recommend [TDM-GCC](http://tdm-gcc.tdragon.net/download).
|
|
|
|
## Build the Front-end Assets
|
|
|
|
To build less to css for the frontend you will need a recent version 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
|
|
```
|
|
go get github.com/Unknwon/bra
|
|
bra run
|
|
```
|
|
|
|
## Running Grafana Locally
|
|
You can run a local instance of Grafana by running:
|
|
```
|
|
./bin/grafana-server
|
|
```
|
|
If you built the binary with `go run build.go build`, run `./bin/grafana-server`
|
|
|
|
If you built it with `go build .`, run `./grafana`
|
|
|
|
Open grafana in your browser (default [http://localhost:3000](http://localhost:3000)) and login with admin user (default user/pass = admin/admin).
|
|
|
|
## Developing for Grafana
|
|
To add features, customize your config, etc, you'll need to rebuild on source change.
|
|
```
|
|
go get github.com/Unknwon/bra
|
|
|
|
bra run
|
|
```
|
|
You'll also need to run `grunt watch` to watch for changes to the front-end.
|
|
|
|
## Creating optimized release packages
|
|
This step builds linux packages and requires that fpm is installed. Install fpm via `gem install fpm`.
|
|
|
|
```
|
|
go run build.go build package
|
|
```
|
|
|
|
## 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. custom.ini
|
|
|
|
Learn more about Grafana config options in the [Configuration section](/installation/configuration/)
|
|
|
|
## Create a pull requests
|
|
Please contribute to the Grafana project and submit a pull request! Build new features, write or update documentation, fix bugs and generally make Grafana even more awesome.
|
|
|
|
Before or after you create a pull request, sign the [contributor license agreement](/project/cla.html).
|
|
Together we can build amazing software faster.
|