Skip to content
This repository was archived by the owner on May 20, 2025. It is now read-only.
/ stork Public archive
forked from isc-projects/stork

Stork is a dashboard for BIND 9 and Kea DHCP. It is under active development, with monthly releases. The initial priority is to provide monitoring and troubleshooting support.

License

Notifications You must be signed in to change notification settings

HariComputes/stork

 
 

Repository files navigation

Why is this forked?

I've forked it to make this work on ARM64 systems like the raspberry pi4. Things i've tested:

  • rake build
  • rake install:agent
  • rake install:server
  • Agent communication
  • server operation

There seems to be an issue where stork-agent isn't created always created. If it is ignore this bit. To manually create the user, run useradd --system --home-dir "/var/lib/stork-agent" stork-agent The home directory needs to have it's ownership changed aswell. so run: chown -R stork-agent /var/lib/stork-agent

This will only work on Arm64 systems. Arm7/6, etc, etc won't work. This should still work with the systems it originally made to work with.

This will also not work on a 1gb raspberry pi. i used a 4gb raspberry pi. also the SD Card speed will determine how long building will take. i found with a v30 sdcard it'll take 15-45 minutes. with a generic card. it'll take a few hours.

Here is a repository with the agent and server dpkg files as they will be quicker and easier then building from source. -> https://github.com/TheDeadGuy/Stork-DPKG-for-ARM64

Pre-Req/Dependencies:

  • Rake

  • Git

  • Python3-venv

  • java/jdk (default-jdk)

    If you're installing server you'll need postgresql

  • postgresql

  • postgresql-contrib

Stork

Stork is an open source ISC project providing a monitoring application and dashboard for ISC Kea DHCP and (eventually) ISC BIND 9. A limited configuration management for Kea is available and is expected to grow substantially in the near future.

The project is currently in rapid development, with monthly releases rolling out new features. See wiki pages for useful links to download page, release notes, self-guided demo, screenshots and much more.

For details, please see the Stork Administrator Reference Manual or the Stork wiki.

Build Instructions

The easiest way to run Stork is to install it using RPM and deb packages. The second easiest way is to use Docker (rake demo:up or ./stork-demo.sh). However, it is possible to run Stork without Docker. See the Installation section of the Stork ARM.

Reporting Issues

Please use the issue tracker on ISC's GitLab to report issues and submit feature requests.

Getting Involved

We have monthly development releases. If you'd like to get involved, feel free to subscribe to the stork-dev mailing list or look at the Stork project page. We're also on GitHub.

If you have a patch to send, by far the best way is to submit a merge request (MR) on GitLab. Stork developers use this system daily and you may expect a reasonably quick response. The second alternative is to submit a pull request (PR) on GitHub. This will also work, but this system is not monitored, so expect a delayed response.

Screenshots

An example front page of the dashboard looks like this: Stork dashboard

Many more Stork screenshots are available on the Screenshots gallery.

Prometheus and Grafana

Stork provides support for statistics export in Prometheus format, which can then easily be shown in Grafana.

An example of Kea dashboard in Grafana, displaying data exported with Stork: grafana-kea4

BIND9 dashboard in Grafana, displaying data exported with Stork: grafana-bind2

About

Stork is a dashboard for BIND 9 and Kea DHCP. It is under active development, with monthly releases. The initial priority is to provide monitoring and troubleshooting support.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 60.6%
  • TypeScript 25.8%
  • HTML 5.5%
  • Python 4.3%
  • Ruby 2.6%
  • Sass 0.5%
  • Other 0.7%