Skip to content
Monitoring & Snapshot tool for Ark Core
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Monitoring & Snapshot tool for Ark Core

This tool is based on the monitoring and snapshot capabilities of Noah, but adjusted to work with v2 of Ark.

The reason for not going with a core plugin but a bash script instead, is because the script can still notify you if core goes down for whatever reason, while the plugin would go down with it. Nonetheless, it is possible that a core plugin with a subset of hermod features might be created sometime in the future.


git clone
cd ~/hermod
bash install
bash config # See Configuration for more details
bash start

That's it! Hermod is now monitoring your logs


After running bash install, there will be a .hermod file available where you can change the configuration to your preference. At a minimum, you should go over and fill in some of the following configuration:

# Notification settings, by default these should be fine, but you can decide to increase / reduce it to your liking
monitor_lines=10 # if you have debug logs enabled, 20 lines is better

# Delegate info to properly filter the log messages. Both should be filled in with your delegate details.

# Core settings, set the path to core (usually $HOME/core or $HOME/ark-core), and the network (devnet or mainnet).

# Snapshot settings, enabling the snapshot module will automatically take snapshots and append blocks to existing snapshots.

# How you would like to be notified. Don't forget to change this line to one (or more) ways in which you would like to be updated.
notification_drivers=(log slack discord)


When rounds are saved on core, hermod will take snapshots, or append to the most recent one. It is enabled by default and it will keep the 5 most recent snapshots. Older snapshots are deleted. Make sure that you have enough storage space.


There are a couple of services that you can use to get notified by the script. These are currently the following:


You can check whether you have confired your notifications correctly by running bash test notify MESSAGE. This will send MESSAGE to each of the notification drivers you've configured in the config.


Usage: [options]
    help                      Show this help.
    version                   Show the installed version.
    start                     Start the hermod process.
    stop                      Stop the hermod process.
    restart                   Restart the hermod process.
    reload                    Reload the hermod process.
    delete                    Delete the hermod process.
    monitor                   Temporarily monitor the log.
    install                   Setup hermod interactively.
    update                    Update the hermod installation.
    config                    Configure the hermod installation.
    log                       Show the hermod log.
    test [method] [params]    Test the specified method.
    alias                     Create a bash alias for hermod.
    snapshot                  Take a new snapshot, or append to the most recent one.
    rollback                  Roll back to the most recent snapshot.



MIT © ItsANameToo / vmunich / Brian Faust

You can’t perform that action at this time.