actualbudget / docs

Main website and documentation for Actual Budget
https://actualbudget.org
96 stars 144 forks source link

[Feature] Add Podman quadlet option to run Actual Budget to docs #476

Open artur-sannikov opened 1 month ago

artur-sannikov commented 1 month ago

Verified feature request does not already exist?

💻

Pitch: what problem are you trying to solve?

There is no documentation on how to run Actual Budget with Podman.

Describe your ideal solution to this problem

I'm using Podman Quadlets to run my containers. Here is an example for Actual Budget.

Create file named actual-budget.container

# actual-budget.container
[Container]
Image=docker.io/actualbudget/actual-server:latest
PublishPort=5006:5006
Volume=./actual-data:/data

# Uncomment if you want updates with `podman auto-update`
AutoUpdate=registry

# Hardening
NoNewPrivileges=true

# If not used, can be commented out
Environment=ACTUAL_HTTPS_KEY=/data/selfhost.key
Environment=ACTUAL_HTTPS_CERT=/data/selfhost.crt
Environment=ACTUAL_PORT=5006
Environment=ACTUAL_UPLOAD_FILE_SYNC_SIZE_LIMIT_MB=20 Environment=ACTUAL_UPLOAD_SYNC_ENCRYPTED_FILE_SYNC_SIZE_LIMIT_MB=50
Environment=ACTUAL_UPLOAD_FILE_SIZE_LIMIT_MB=20

[Service]
Restart=always

[Install]
WantedBy=default.target
  1. Place this file in ~/.config/containers/systemd
  2. Run systemctl --user daemon-reload
  3. Run systemctl --user start actual-budget.service

If you have SELinux, the volume should be labeled with either Z or z flag (read more under "Labeling Volume Mounts" in docs.

I can open a PR and add more details if that's useful.

Teaching and learning

No response

RubenOlsen commented 1 month ago

hi @artur-sannikov.

Would you mind creating a writeup somewhere on this, like medium.com or even just a readme.md file in a git-repository.

When you have this in place we will be happy to link to it from https://actualbudget.org/docs/install/#additional-installation-options

Someone did this for Google Platform already last week, so it can be used for inspiration - https://github.com/eatonc/actual-gcp