IntenseWebs/grafana
3
0
Fork 0
mirror of https://github.com/grafana/grafana.git synced 2025-02-11 08:05:43 -06:00
Code Issues Packages Projects Releases Wiki Activity

Docs: Add Troubleshooting section to Developer guide (#19721)

Browse Source 
* Add Troubleshooting section to Developer guide

* Remove unintended newline
This commit is contained in:
Marcus Olsson 2019-10-09 10:01:05 +02:00 committed by GitHub
parent fbbf9cecac
commit 957b552dd1
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 30 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
contribute/developer-guide.md
View File

@ -57,6 +57,8 @@ Next, we'll build the web server that will serve the frontend assets we just bui
Build and run the backend, by running `make run` in the root directory of the repository. This command will compile the Go source code, and start a web server.
> Are you having problems with [too many open files](#troubleshooting)?
By default, you can access the web server at `http://localhost:3000/`.
Log in using the default credentials:
@ -163,6 +165,34 @@ The resulting image will be tagged as grafana/grafana:dev.
**Note:** If you are using Docker for macOS, be sure to set the memory limit to be larger than 2 GiB. Otherwise `grunt build` may fail. The memory limit settings are available under **Docker Desktop** -> **Preferences** -> **Advanced**.
## Troubleshooting
Are you having issues with setting up your environment? Here are some tips that might help.
### Too many open files when running `make run`
Depending on your environment, you may have to increase the maximum number of open files allowed.
To see how many open files are allowed, run:
```
ulimit -a
```
To change the number of open files allowed, run:
```
ulimit -S -n 2048
```
The number of files needed may be different on your environment. To determine the number of open files needed by `make run`, run:
```
find ./conf ./pkg ./public/views | wc -l
```
Another alternative is to limit the files being watched. The directories that are watched for changes are listed in the `.bra.toml` file in the root directory.
## Learn more
- Read our [style guides](/contribute/style-guides).