docs: update README with install instructions
This commit is contained in:
parent
63d37d2955
commit
599da9c3e6
1 changed files with 31 additions and 10 deletions
41
README.md
41
README.md
|
|
@ -1,11 +1,32 @@
|
||||||
Learning golang, writing a simple app to interface with an HTTP API and generate emailable reports from an actualbudget instance
|
A simple Go service to generate and email reports on a schedule.
|
||||||
|
|
||||||
# TODO
|
# Installation (NixOS)
|
||||||
- [x] Fetch the desired budget file
|
If you're using NixOS we provide a simple flake module:
|
||||||
- [x] Change path to route in API caller
|
|
||||||
- [x] Trigger a bank sync and see if we can wait for it to finish (looks like it's a blocking call so we can safely sync before reports)
|
```nix
|
||||||
- [x] Fetch the category information for each category as well as the overall groups
|
inputs.actualbudget-report.url = "git+https://git.wanderingcrow.net/TheWanderingCrow/actualbudget-report";
|
||||||
- [x] Compile a email-friendly report of the information
|
```
|
||||||
- [x] Send the email to the desired parties via SMTP
|
|
||||||
- [x] Write flake derivation
|
Then in your configuration (using sops-nix, you will need to adjust it if you use agenix or alternatives):
|
||||||
- [ ] Write flake module and systemd service
|
```nix
|
||||||
|
imports = [
|
||||||
|
inputs.actualbudget-report.nixosModules.default;
|
||||||
|
];
|
||||||
|
|
||||||
|
# Fill out all the following environment variables for the service
|
||||||
|
sops.templates."actualbudget-report-env".content = ''
|
||||||
|
BASE_URL=
|
||||||
|
API_KEY=
|
||||||
|
SYNC_ID=
|
||||||
|
SMTP_USERNAME=
|
||||||
|
SMTP_PASSWORD=
|
||||||
|
SMTP_HOST=
|
||||||
|
SMTP_RECIPIENTS=
|
||||||
|
'';
|
||||||
|
|
||||||
|
services.actualbudget-report = {
|
||||||
|
enable = true;
|
||||||
|
interval = "Mon-Fri 12:00:00";
|
||||||
|
environmentFile = config.sops.templates."actualbudget-report-env".path;
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue