trail-ledger

TrailLedger keeps track of invoices. Providing an overview page one can filter based on many aspects to only see specific entries. It also offers import / export functionalities, user handling, RBAC and more. Export works based on what is shown in the list page - it creates a combined report per expense type for each month. Further improvements are on the way.

URL

Once the application is running it is reachable on https://<hostname>

Mockup

Setup

Docker image

• Create docker image
  • Select target platform: in makefile replace build-arm with build-amd for amd based platform(s).
  • Run make build
• Run application in docker container
  • Run make run
• Export docker image
  • docker save -o trail-ledger.tar trail-ledger
• Import docker image
  • docker load -i trail-ledger.tar

Bindings

• Port(s)
  • Frontend:
    • 443 -> 443
    • 80 -> 80 (only in production)
  • Backend:
    • 8080 -> 8080 (optional due to nginx)
• Mount(s)
  • Database:
    • /app/database -> <dedicated folder on host>

SSL Certificates

If certificate(s) expire(s) they might be regenerated by running:

• openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 365 -nodes.

The generated pem files need to placed into certs directory.