mirror of
https://github.com/actualbudget/actual.git
synced 2026-07-16 07:04:23 -05:00
[Bug]: Native Install Dependency Issues #1500
Closed
opened 2026-02-28 19:45:30 -06:00 by GiteaMirror
·
2 comments
No Branch/Tag Specified
master
dependabot/npm_and_yarn/npm_and_yarn-cd62b4b37a
api-browser-custom-data-dir
tabedzki/feat/replacing-month-picker-with-day-picker
delay-initial-sync-until-loaded
jfdoming/mobile-app-build
cross-version-sync-compat
jfdoming/api-tokens-part-1
jfdoming/api-tokens-part-2
jfdoming/api-tokens-part-3
jfdoming/mobile-app-updates
claude/budget-version-migration-compat-151jlr
claude/worker-error-serialization-9iqtl7
claude/react-table-library-research-afx83z
claude/issue-8401-regression-test-9nw9l3
jfdoming/mobile-app-foundation-part-1
jfdoming/mobile-app-scaffold
release
ai-fix-cleanup-def-8290
claude/relaxed-shannon-jusywa
claude/fervent-keller-s6f2fq
claude/determined-feynman-st1y9z
claude/wizardly-einstein-vi2wce
claude/sweet-albattani-7nseio
feat/bank-sync-per-budget-file
claude/affectionate-cannon-y0kc82
claude/dependabot-findings-m9pgmb
claude/mac-app-ios-publish-zjs1lz
claude/vigilant-tesla-aiiyos
depot-migrate-secrets-1781296330308
claude/quirky-cerf-v5qck7
claude/animation-removal-alternative-2etfh1
claude/netlify-preview-comments-consolidate-9XPYa
osc/7391-error-boundaries-reports
claude/pensive-dijkstra-7DYui
claude/server-app-version-mismatch-HTCGv
claude/pr-8027-review-feedback-mELuO
claude/zealous-wozniak-e5pO0
claude/intelligent-heisenberg-BSHJq
claude/translation-download-refactor-jFRsO
claude/mobile-performance-ideas-G9PAO
claude/github-issue-7988-5A5ly
blacksmith-migration-ff70d2d
claude/great-mayer-KRvOk
claude/react-native-ios-compilation-fcJh5
claude/serene-goldberg-58xv0
claude/kind-euler-LVG3K
release-automation/edge-nightly
7710-bundle-migrations
claude/fix-docker-build-error-WMfed
claude/llm-compatible-release-notes-t20Nr
7710-tests-tdd
cursor/transaction-table-rewrite-f077
claude/plan-ci-secure-context-OtEe1
claude/fix-issue-7667-DPXi3
cursor/resolve-pr-7449-ee11
claude/fix-typescript-build-error-JPtZ5
copilot/add-repository-configs-to-packages
worktree-compressed-drifting-ritchie
claude/api-consumer-verification-kfz1K
pr-7454
claude/fix-issue-7410-LLLQ4
revert-7281-generate-icons
react-query-useSchedules
copilot/sub-pr-6140
package-upgrades
v26.7.0
v26.6.0
v26.5.2
v26.5.1
v26.5.0
v26.4.0
v26.3.0
v26.2.1
v26.2.0
v26.1.0
v25.12.0
v25.11.0
v25.10.0
v25.9.0
v25.8.0
v25.7.1
v25.7.0
v25.6.1
v25.6.0
v25.5.0
v25.4.0
v25.3.1
v25.3.0
v25.2.1
v25.2.0
v25.1.0
v24.12.0
v24.11.0
v24.10.1
v24.10.0
v24.9.0
v24.8.0
v24.7.0
v24.6.0
v24.5.0
v24.4.0
v24.3.0
v24.2.0
v24.1.0
v23.12.0
v23.11.0
v23.10.0
v23.9.0
v23.8.1
v23.8.0
v23.7.2
v23.7.1
v23.7.0
v23.6.0
v23.5.0
v23.4.2
v23.4.1
v23.4.0
v23.3.2
v23.3.0
v23.2.9
v23.2.5
v23.1.12
v22.12.9
Labels
Clear labels
AI generated
API
bank sync
budgeting
bug
can’t replicate
dependencies
docker
documentation
electron
experimental feature
feature
feedback
goal templates
good first issue
help wanted
importers
maintenance
needs info
needs testing
needs triage
needs votes
openid
payees
pull-request
regression
reports
responsive
rules
schedules
server
✨ merged
split transactions
tech debt
tech-support
theme
transaction import
transaction reconciliation
transactions
translations
upstream
user interface
✅ approved
wontfix
Mirrored from GitHub Pull Request
No Label
bug
Milestone
No items
No Milestone
Projects
Clear projects
No project
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: github-starred/actual#1500
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
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?
Originally created by @weswitt on GitHub (Oct 11, 2024).
Verified issue does not already exist?
What happened?
I'm running AB in docker but thought I'd try to get a native install up and running. I'm seeing the following:
yarn start
Checking if there are any migrations to run for direction "up"...
Rejection: Error: The module '/root/actual-server/node_modules/better-sqlite3/build/Release/better_sqlite3.node'
was compiled against a different Node.js version using
NODE_MODULE_VERSION 108. This version of Node.js requires
NODE_MODULE_VERSION 109. Please try re-compiling or re-installing
the module (for instance, using
npm rebuildornpm install).at Module._extensions..node (node:internal/modules/cjs/loader:1452:18)
at Module.load (node:internal/modules/cjs/loader:1197:32)
at Module._load (node:internal/modules/cjs/loader:1013:12)
at Module.require (node:internal/modules/cjs/loader:1225:19)
at require (node:internal/modules/helpers:177:18)
at bindings (/root/actual-server/node_modules/bindings/bindings.js:112:48)
at new Database (/root/actual-server/node_modules/better-sqlite3/lib/database.js:48:64)
at openDatabase (file:///root/actual-server/src/db.js:57:30)
at getAccountDb (file:///root/actual-server/src/account-db.js:12:18)
at Migration.up (file:///root/actual-server/migrations/1694360479680-create-account-db.js:4:9) {
code: 'ERR_DLOPEN_FAILED'
}
node -v
v18.19.1
npm -v
9.2.0
OS: Ubuntu 22.04
I followed the instructions at https://actualbudget.org/docs/install/local
How can I resolve the better_sqlite3 version problem?
Where are you hosting Actual?
Locally via Yarn
What browsers are you seeing the problem on?
Chrome
Operating System
Linux
@youngcw commented on GitHub (Oct 18, 2024):
Im not sure what would cause this. Maybe reach out on discord for tech support there.
@S3NTYN3L commented on GitHub (May 3, 2025):
Fixing
better-sqlite3Node.js Version Mismatch for Actual Budget on LinuxHi @weswitt, I saw your issue with the
better-sqlite3Node.js mismatch error (Error: The module '.../better_sqlite3.node' was compiled against a different Node.js version) and hit the same problem setting up Actual Budget on my mother’s Linux Mint 22.1 laptop.This guide, based on the official instructions (https://actualbudget.org/docs/install/build-from-source), fixes it with a simple rebuild and includes a
systemdservice and update script for easy maintenance.I’ve attached a
.zipwith all files—tested on Mint, but should work on any Linux distro.Prerequisites
Install
nvm,git, andyarnas needed:nvmin the current session:\. "$HOME/.nvm/nvm.sh". Alternatively, reload the shell (source ~/.bashrc) or restart the terminal.better-sqlite3fix:Build Steps
Follow the guide’s steps, with a fix for
better-sqlite3:actualdirectory toactual-serverfor clarity (mv actual actual-server). Adjust paths if you keepactual.better-sqlite3: Rebuild native modules for your Node.js version (this guide uses v22, but v18, v19, v20, or v21 should work):http://localhost:5006.Systemd Service
To run the server automatically, use the
actual-server.servicefile from the attachedactual-budget-files.zipor create it manually:Using the zipped file:
actual-budget-files.zip(attached below).actual-server.serviceto the system directory:%hwith your home directory (e.g.,/home/john) and%uwith your username (e.g.,john):Creating manually:
Paste:
Note:
%hand%uare systemd specifiers for the user’s home directory and username.If they don’t work (e.g., older distros), replace with your home path and username (e.g.,
/home/johnandjohn).Enable and start the service:
Verify it’s running:
Update Script
To handle updates when Actual Budget prompts, use the
update-actual-server.shfile from the attachedactual-budget-files.zipor create it manually:Using the zipped file:
actual-budget-files.zip(attached below).update-actual-server.shin~/actual-server:Creating manually:
Paste:
Make it executable:
Test it:
Desktop File
For easy updates, use the
Update-Actual-Budget.desktopfile from the attachedactual-budget-files.zipor create it manually:Using the zipped file:
actual-budget-files.zip(attached below).Update-Actual-Budget.desktopon the desktop:Creating manually:
Paste:
Make it executable:
Note:
gnome-terminalis Mint’s default. For other distros, check your desktop environment (echo $XDG_CURRENT_DESKTOP) and replace withxfce4-terminal,konsole,xterm, etc., as needed.Sudoers Setup
The update script uses
sudo systemctl, which requires a password unless configured. Add asudoersrule:Add (replace
YOUR_USERNAMEwith the actual username):Test it:
Instructions for Updates
When Actual Budget prompts for an update:
http://localhost:5006.Troubleshooting
If
better-sqlite3errors persist:If the service or UI fails:
node -v(should be v18 or greater).sudo journalctl -u actual-server.service --since=today -r -n 50 --no-pager.curl http://localhost:5006.This setup assumes a single-user system. For multi-user systems, adjust permissions or run the service as a specific user.
Note to Devs
Feel free to use, adapt, or incorporate this guide into the Actual Budget documentation or troubleshooting resources.
I hope it helps other users avoid the
better-sqlite3issue!actual-budget-files.zip