SVI/ProxmoxVE
1
0
Fork 0
mirror of https://github.com/community-scripts/ProxmoxVE.git synced 2026-05-17 05:32:10 -04:00
Code Issues 2.6k Packages Projects Releases 10 Wiki Activity

[PR #2496] [MERGED] Breaking: Actual Budget Script (HTTPS / DB Migration / New Structure) - Read Description #3693

New Issue
Closed
opened 2025-11-20 06:06:13 -05:00 by saavagebueno · 0 comments
saavagebueno commented 2025-11-20 06:06:13 -05:00
Owner
Copy Link

📋 Pull Request Information

Original PR: https://github.com/community-scripts/ProxmoxVE/pull/2496
Author: @MickLesk
Created: 2/19/2025
Status: ✅ Merged
Merged: 2/20/2025
Merged by: @michelroegl-brunner

Base: main ← Head: redesign_actual_budget

📝 Commits (6)

📊 Changes

2 files changed (+55 additions, -32 deletions)

View changed files

📝 ct/actualbudget.sh (+29 -20)
📝 install/actualbudget-install.sh (+26 -12)

📄 Description

ActualBudget Update & Migration Guide

📌 Important: Backup Your Data First

Before updating, export your Actual Budget data to avoid data loss. Follow these steps:

  1. Login to your budget and go to More > Settings.
  2. Scroll down to Export and click Export Data.
  3. Save the file to your computer.

For detailed instructions, see the Backup & Restore Guide.

🚀 Key Changes in the New Version

1️⃣ Database Changes

  • New database structure, including a password column in auth.
  • Migrations are now stored in /opt/actualbudget-data/migrate/.

2️⃣ File Structure Overhaul

  • Data moved to /opt/actualbudget-data/.
  • Key directories:
    • /opt/actualbudget-data/server-files/
    • /opt/actualbudget-data/user-files/
    • /opt/actualbudget-data/migrations/
    • /opt/actualbudget-data/migrate/
    • /opt/actualbudget-data/config/
  • .env is now stored in /opt/actualbudget-data/.

3️⃣ New HTTPS Support

  • Supports self-signed certificates.
  • Certificates must be renewed manually.

4️⃣ If Issues Persist, Reinstall in a New LXC

  • open your Proxmox Main Node and enter:
bash -c "$(wget -qLO - https://github.com/community-scripts/ProxmoxVE/raw/main/ct/actualbudget.sh)"

🔐 Enabling HTTPS

Generate a Self-Signed Certificate

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /opt/actualbudget/selfhost.key -out /opt/actualbudget/selfhost.crt

Configure HTTPS

Update .env:

ACTUAL_HTTPS_KEY=/opt/actualbudget/selfhost.key
ACTUAL_HTTPS_CERT=/opt/actualbudget/selfhost.crt

Restart service:

systemctl restart actualbudget

Renew Certificate Manually

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /opt/actualbudget/selfhost.key -out /opt/actualbudget/selfhost.crt
systemctl restart actualbudget

🎯 Summary

✅ Backup before updating (see Backup Guide)
✅ HTTPS supported but needs manual renewal
✅ If update fails, migrate manually or reinstall LXC

🔗 Related PR / Discussion / Issue

Link: #74 #1623 #807 #1707 #1354 #2490

✅ Prerequisites

Before this PR can be reviewed, the following must be completed:

  • Self-review performed – Code follows established patterns and conventions.
  • Testing performed – Changes have been thoroughly tested and verified.

🛠️ Type of Change

Select all that apply:

  • 🐞 Bug fix – Resolves an issue without breaking functionality.
  • ✨ New feature – Adds new, non-breaking functionality.
  • 💥 Breaking change – Alters existing functionality in a way that may require updates.

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/community-scripts/ProxmoxVE/pull/2496 **Author:** [@MickLesk](https://github.com/MickLesk) **Created:** 2/19/2025 **Status:** ✅ Merged **Merged:** 2/20/2025 **Merged by:** [@michelroegl-brunner](https://github.com/michelroegl-brunner) **Base:** `main` ← **Head:** `redesign_actual_budget` --- ### 📝 Commits (6) - [`5142eee`](https://github.com/community-scripts/ProxmoxVE/commit/5142eee995a1f49cbebbb5ee288dc4b5fb845b47) Redesign: Actual Budget Script - [`1b0e699`](https://github.com/community-scripts/ProxmoxVE/commit/1b0e699e8508c13da24717782a3a288ef1f7709d) harmonize port - [`1f6d5b3`](https://github.com/community-scripts/ProxmoxVE/commit/1f6d5b33d104cecac1e67656c9728c25e991c6a6) Update actualbudget.sh - [`61171c6`](https://github.com/community-scripts/ProxmoxVE/commit/61171c65063505637cd861bfbbcb8594a36cf49f) Update actualbudget-install.sh - [`7e4af9c`](https://github.com/community-scripts/ProxmoxVE/commit/7e4af9cf1a7d1f398479ffe06f2c4f5f88d343a5) remove dev silents - [`7df5dde`](https://github.com/community-scripts/ProxmoxVE/commit/7df5ddeb110dc0a503ad65c3d15ab7af612cf72b) Update actualbudget.sh ### 📊 Changes **2 files changed** (+55 additions, -32 deletions) <details> <summary>View changed files</summary> 📝 `ct/actualbudget.sh` (+29 -20) 📝 `install/actualbudget-install.sh` (+26 -12) </details> ### 📄 Description # ActualBudget Update & Migration Guide ## 📌 Important: Backup Your Data First Before updating, **export your Actual Budget data** to avoid data loss. Follow these steps: 1. **Login** to your budget and go to **More > Settings**. 2. Scroll down to **Export** and click **Export Data**. 3. **Save the file** to your computer. For detailed instructions, see the [Backup & Restore Guide](https://actualbudget.org/docs/backup-restore/backup/). --- ## 🚀 Key Changes in the New Version ### 1️⃣ **Database Changes** - New database structure, including a `password` column in `auth`. - Migrations are now stored in `/opt/actualbudget-data/migrate/`. ### 2️⃣ **File Structure Overhaul** - Data moved to `/opt/actualbudget-data/`. - Key directories: - `/opt/actualbudget-data/server-files/` - `/opt/actualbudget-data/user-files/` - `/opt/actualbudget-data/migrations/` - `/opt/actualbudget-data/migrate/` - `/opt/actualbudget-data/config/` - `.env` is now stored in `/opt/actualbudget-data/`. ### 3️⃣ **New HTTPS Support** - Supports **self-signed certificates**. - Certificates **must be renewed manually**. ### **4️⃣ If Issues Persist, Reinstall in a New LXC** - open your Proxmox Main Node and enter: ```bash bash -c "$(wget -qLO - https://github.com/community-scripts/ProxmoxVE/raw/main/ct/actualbudget.sh)" ``` --- ## 🔐 Enabling HTTPS ### **Generate a Self-Signed Certificate** ```bash openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /opt/actualbudget/selfhost.key -out /opt/actualbudget/selfhost.crt ``` ### **Configure HTTPS** Update `.env`: ```bash ACTUAL_HTTPS_KEY=/opt/actualbudget/selfhost.key ACTUAL_HTTPS_CERT=/opt/actualbudget/selfhost.crt ``` Restart service: ```bash systemctl restart actualbudget ``` ### **Renew Certificate Manually** ```bash openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /opt/actualbudget/selfhost.key -out /opt/actualbudget/selfhost.crt systemctl restart actualbudget ``` --- ## 🎯 Summary ✅ **Backup before updating** (see [Backup Guide](https://actualbudget.org/docs/backup-restore/backup/)) ✅ **HTTPS supported but needs manual renewal** ✅ **If update fails, migrate manually or reinstall LXC** ## 🔗 Related PR / Discussion / Issue Link: #74 #1623 #807 #1707 #1354 #2490 ## ✅ Prerequisites Before this PR can be reviewed, the following must be completed: - [x] **Self-review performed** – Code follows established patterns and conventions. - [x] **Testing performed** – Changes have been thoroughly tested and verified. ## 🛠️ Type of Change Select all that apply: - [x] 🐞 **Bug fix** – Resolves an issue without breaking functionality. - [x] ✨ **New feature** – Adds new, non-breaking functionality. - [x] 💥 **Breaking change** – Alters existing functionality in a way that may require updates. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
saavagebueno added the pull-request label 2025-11-20 06:06:13 -05:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
🛑 Failure to comply with the guidelines
breaking change
bug
bug
bugfix
deferred
delete script
dependencies
enhancement
external
feature
github
help wanted
Implemented in VED waiting push to Main
in project pipeline
invalid
investigation
json
maintenance
new script
new script
nice to have
not a script issue
not planned
organization
pull-request
Mirrored from GitHub Pull Request
 question
refactor
rename script
security
update script
website
wontdo
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
saavagebueno
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: SVI/ProxmoxVE#3693
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?