You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Edmundo Alvarez d521e40058 Make aggregation field clearable (#6945) 11 hours ago
config Remove 'plugins' dir to 'plugin' to retain consistency. 3 years ago
dev Add bash script to extecute linting in the same way like the CI (#6611) 1 month ago
docs Booststrap Abstraction (#6385) 2 months ago
flow-typed Migrate non-Reflux stores to Reflux (#6766) 1 week ago
manifests Bump to 3.2.0-SNAPSHOT 3 months ago
packages Scratchpad implemented (#6492) 12 hours ago
public Scratchpad implemented (#6492) 12 hours ago
src Make aggregation field clearable (#6945) 11 hours ago
templates Update to hi-res logo & favicon as well as optimize all image files (#5748) 9 months ago
test Removing disabling of ESLints `no-undef` due to flow utility classes. 1 week ago
travis Migrate from FindBugs to SpotBugs 2 years ago
webpack Updating vendor module ids (#6891) 3 days ago
.editorconfig move files to web-interface 4 years ago
.eslintrc.json Add jest as eslint env (#4196) 2 years ago
.flowconfig Adding test helpers to import scope. 5 months ago
.gitignore Add test/bin to .gitignore in graylog2-web-interface (#6614) 1 month ago
.jshintrc move files to web-interface 4 years ago
ContributorAgreement.pdf move files to web-interface 4 years ago
NASA_IMAGES.txt move files to web-interface 4 years ago Allow customization of dev server host (#4500) 1 year ago
babel.config.js Themed Buttons (#6440) 2 months ago
checkProductionBuild.js Changing default build directory for production web asset health check. (#5937) 6 months ago
config.js Update dev config.js to new default (#2651) 3 years ago
devServer.js Allow customization of dev server host (#4500) 1 year ago
package.json Scratchpad implemented (#6492) 12 hours ago
styleguide.config.js Tying themeable components into styleguide library 1 month ago
tsconfig.json Fix the way TypeScript loads type definitions. (#4642) 1 year ago
vendor.modules.js Updated vendor-modules from build (#6659) 1 month ago
webpack.bundled.js Combine vendor and app webpack builds. (#3576) 2 years ago
webpack.combined.config.js Reduce development startup time by improving globbing. (#4582) 1 year ago
webpack.config.js Allow bootstrap component style overwrite (#6594) 1 month ago
webpack.vendor.js Replacing uglify with Terser for better ES6 support (#6219) 4 months ago
yarn.lock Scratchpad implemented (#6492) 12 hours ago

Graylog Web Interface


Note: NPM v5 changed completely the way it builds local modules, breaking the Graylog web interface build. Please use Yarn instead of NPM v5.

Development Setup

  • Install the requirements listed above
  • Run yarn install
  • Run yarn start to build the project for development and start the development server. You can exclude any Graylog frontend plugins from the build by running disable_plugins=true npm start instead
  • Open http://localhost:8080 in your browser to access the Graylog web interface

The yarn start (or disable_plugins=true yarn start) command will run an Express web server which is configured to do a full page reload in your browser every time that you save a file. This ensures that you will always use the latest version of your code.

Run development server in a different host and port

You can start the development server in any other host and port that you like:

  • Use the --host=<hostname> option to change the default host the development server uses. The default host is
  • Use the --port=<port> option to change the default port number the development server uses. The default value is 8080. The server will pick a random port if the port you try to use is already in use

E.g. yarn start --host= --port=8000 will start the development server in all available network interfaces using the port 8000.

There’s an online version of the frontend documentation and component gallery at:

The online version is automatically deployed and reflects the current state of the master branch in this repository.

Run documentation locally

You may also run the documentation locally to contribute to it or see a different version than the current master:

  1. Run yarn install
  2. Run yarn run docs:server
  3. Go to http://localhost:6060 on your favourite browser to see the local documentation

Configure your editor

We mainly develop using IntelliJ or WebStorm. If you also decide to use them to work in Graylog, enable React JSX as Javascript language version to support the JSX language extension. This setting was called JSX harmony before, and it is available in one or the other form since IntelliJ 14 and WebStorm 9.

Update Javascript dependencies

  1. Update a single dependency

    • Run yarn upgrade <package>@<version>
    • Commit any changes in both package.json and yarn.lock files
    • Do any changes required to adapt the code to the upgraded modules
  2. Update many dependencies

    • It may be dangerous updating many dependencies at the same time, so be sure you checked the upgrade notes of all modules before getting started. Once you are ready to upgrade the modules, Yarn provides a few options to do it:
      • You can pass all packages you want to upgrade to Yarn: yarn upgrade <package1> <package2>...
      • Yarn also supports upgrading packages matching a pattern, so you can execute yarn upgrade --pattern <pattern>
      • You could execute yarn upgrade if you really want to upgrade all packages
    • After doing the upgrade, remember to commit both the package.json and yarn.lock files