On Tolkien's Middle-Earth, Anar is the sun. A vessel piloted through the heavens by the Maia Arien after the fall of the Two Trees.
Anar monitors my own solar system [heh] by gathering data on my inverters and uploading it an InfluxDB v2 database. This project was geared towards creating a .NET project the could be configured and run in a docker swarm.
Like most .NET apps, you can specify all configuration settings using a
combination of config files appsettings.json, environment variables, or
command line options.
In addition, this project supports using Docker configs and secrets as follows.
An environment variable APP_SETTINGS_DOCKER can be set to identify an
additional location for an appsettings style config file. This can be
/config-name to load from a docker config, or /run/secrets/secret-name to
load from a docker secret.
This section controls settings for communicating with an Enphase IQ gateway. Enphase does not make direct access easy. See the following This Technical Brief for information on how to generate your token.
"Gateway": {
// Should not need to be changed. Path for gateway request.
"RequestPath": "api/v1/production/inverters",
// The SHA-1 thumbprint of the enphase gateway self signed certificate.
"Thumbprint": "<THUMBPRINT>",
// The authentication token enphase requires for gateway requests.
"Token": "<TOKEN>",
// The IP address or host name of the enphase gateway
"Uri": "https://192.168.1.10"
}These options control how the app will connect to an InfluxDB database.
"Influx": {
// The InfluxDB bucket to write data to.
"Bucket": "testing",
// The InfluxDB organization for the token owner.
"Organization": "home",
// The InfluxDB token to use for authentication.
"Token": "<TOKEN>",
// The InfluxDB URI.
"Uri": "http://influxdb:8086"
}This setting is optional, and allows you to provide additional data that can be joined with inverter data from the gateway.
"Locator": {
// Optional path to file containing location data for system.
// Instead of embedding location information directly, view your system on
// the [Enlighten Website](https://enlighten.enphaseenergy.com/)
// Open browser tools and then go to the Arrays tab. You will want to find
// and copy teh array_layout_x.json file. Save that and put the path
// here.
"LayoutFile": ""
}This section is optional. If present, any authentication or certificate errors will be published to the supplied NTFY host and topic. NOTE: Remove the entire section if you do not want notifications.
// This section is optional. Remove the entire section if you do not want
// notifications.
"Notify": {
// The full URL and path to your NTFY server and topic.
"Uri": "https://ntfy.sh/your-topic-name",
// The token to use for authenticating you NTFY request.
// It must have write access to the topic.
"Token": "<TOKEN>",
// How often to check for and send notifications. Default is 5 minutes
"PollInterval": "0.00:05:00",
// How much time before repeating a notification. Default is 1 day.
"SpamInterval": "1.00:00:00"
}
These settings control how often the worker will capture and upload data.
"Worker": {
// How often to poll the enphase gateway for data. Default is 5 minutes.
"Interval": "0.00:05:00"
}Most of the ways you can build .NET apps will work. In addition a compose.yaml file in the folder can be done to build a docker container
dotnet build
dotnet test
# Test with coverage
dotnet test --verbosity normal /p:CollectCoverage=true /p:CoverletOutputFormat=opencover /p:CoverletOutput=../.coverage/
# Generate a coverage report
dotnet reportgenerator -reports:.coverage/coverage.opencover.xml -targetdir:.coverage/report
# Run the project - Make sure appsettings.json has been properly filled out.
dotnet run --project Anar# Make sure all your settings have been configured.
docker compose build
docker compose up -d