{"id":28431,"library":"umbraco-cloud-fetch-database","title":"Umbraco Cloud Fetch Database","description":"Wizard-based CLI that downloads a database from Umbraco Cloud and replaces the LocalDB .mdf/.ldf files in a local Umbraco ASP.NET Core project. Version 0.3.0, released as needed. Windows-only, auto-downloads sqlpackage, keeps 3 latest backups. Key differentiators: dedicated Umbraco Cloud integration, automatic sqlpackage management, backup safety.","status":"active","version":"0.3.0","language":"javascript","source_language":"en","source_url":"https://github.com/skttl/umbraco-cloud-fetch-database","tags":["javascript","umbraco","umbraco-cloud","localdb","sqlpackage","bacpac","cli"],"install":[{"cmd":"npm install umbraco-cloud-fetch-database","lang":"bash","label":"npm"},{"cmd":"yarn add umbraco-cloud-fetch-database","lang":"bash","label":"yarn"},{"cmd":"pnpm add umbraco-cloud-fetch-database","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Runtime requirement","package":"node","optional":true}],"imports":[{"note":"Use npx to run the CLI without installing globally. Global install works but is not recommended.","wrong":"npm install -g umbraco-cloud-fetch-database","symbol":"default","correct":"npx umbraco-cloud-fetch-database@latest"},{"note":"If installed globally, the command is available as 'umbraco-cloud-fetch-database'.","wrong":"umbraco-cloud-fetch-database (without npx, if not in PATH)","symbol":"(package.json bin)","correct":"npx umbraco-cloud-fetch-database"}],"quickstart":{"code":"cd /path/to/your/umbraco/web/project\nnpx umbraco-cloud-fetch-database@latest","lang":"javascript","description":"Run the CLI inside an Umbraco web project folder to start the interactive wizard."},"warnings":[{"fix":"Use a Windows machine or Windows VM.","message":"Windows-only tool will refuse to run on other operating systems.","severity":"breaking","affected_versions":">=0.1.0"},{"fix":"Start the Umbraco project once to let it create the database files.","message":"Requires that the project already has a working LocalDB database (the .mdf/.ldf files must exist).","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Ensure internet access for automatic download or install sqlpackage manually.","message":"sqlpackage is auto-downloaded only if not already in PATH. Use of GitHub releases may require internet access.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Use a secure terminal and avoid screen recording.","message":"Cloud database password is entered interactively and is never stored. Ensure the terminal is secure.","severity":"gotcha","affected_versions":">=0.1.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Upgrade Node.js to >=20","cause":"Node.js version <20","error":"Cannot find module '...'"},{"fix":"Install SQL Server Express LocalDB from Microsoft","cause":"LocalDB is not installed or sqllocaldb.exe not in PATH","error":"LocalDB not detected"},{"fix":"Install sqlpackage manually or check internet connection","cause":"sqlpackage not in PATH and auto-download failed","error":"sqlpackage: command not found"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}