@fredlackey/devutils 0.0.18 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (447) hide show
  1. package/README.md +214 -141
  2. package/package.json +8 -83
  3. package/src/api/loader.js +229 -0
  4. package/src/api/registry.json +62 -0
  5. package/src/cli.js +293 -60
  6. package/src/commands/ai/index.js +16 -0
  7. package/src/commands/ai/launch.js +112 -0
  8. package/src/commands/ai/list.js +54 -0
  9. package/src/commands/ai/resume.js +70 -0
  10. package/src/commands/ai/sessions.js +121 -0
  11. package/src/commands/ai/set.js +131 -0
  12. package/src/commands/ai/show.js +74 -0
  13. package/src/commands/ai/tools.js +46 -0
  14. package/src/commands/alias/add.js +93 -0
  15. package/src/commands/alias/helpers.js +107 -0
  16. package/src/commands/alias/index.js +14 -0
  17. package/src/commands/alias/list.js +55 -0
  18. package/src/commands/alias/remove.js +62 -0
  19. package/src/commands/alias/sync.js +109 -0
  20. package/src/commands/api/disable.js +73 -0
  21. package/src/commands/api/enable.js +148 -0
  22. package/src/commands/api/index.js +15 -0
  23. package/src/commands/api/list.js +66 -0
  24. package/src/commands/api/update.js +87 -0
  25. package/src/commands/auth/index.js +15 -0
  26. package/src/commands/auth/list.js +49 -0
  27. package/src/commands/auth/login.js +384 -0
  28. package/src/commands/auth/logout.js +111 -0
  29. package/src/commands/auth/refresh.js +184 -0
  30. package/src/commands/auth/services.js +169 -0
  31. package/src/commands/auth/status.js +104 -0
  32. package/src/commands/config/export.js +224 -0
  33. package/src/commands/config/get.js +52 -0
  34. package/src/commands/config/import.js +308 -0
  35. package/src/commands/config/index.js +17 -0
  36. package/src/commands/config/init.js +143 -0
  37. package/src/commands/config/reset.js +57 -0
  38. package/src/commands/config/set.js +93 -0
  39. package/src/commands/config/show.js +35 -0
  40. package/src/commands/help.js +338 -0
  41. package/src/commands/identity/add.js +133 -0
  42. package/src/commands/identity/index.js +17 -0
  43. package/src/commands/identity/link.js +76 -0
  44. package/src/commands/identity/list.js +48 -0
  45. package/src/commands/identity/remove.js +72 -0
  46. package/src/commands/identity/show.js +65 -0
  47. package/src/commands/identity/sync.js +172 -0
  48. package/src/commands/identity/unlink.js +57 -0
  49. package/src/commands/ignore/add.js +165 -0
  50. package/src/commands/ignore/index.js +14 -0
  51. package/src/commands/ignore/list.js +89 -0
  52. package/src/commands/ignore/markers.js +43 -0
  53. package/src/commands/ignore/remove.js +164 -0
  54. package/src/commands/ignore/show.js +169 -0
  55. package/src/commands/machine/detect.js +122 -0
  56. package/src/commands/machine/index.js +14 -0
  57. package/src/commands/machine/list.js +74 -0
  58. package/src/commands/machine/set.js +106 -0
  59. package/src/commands/machine/show.js +35 -0
  60. package/src/commands/schema.js +152 -0
  61. package/src/commands/search/collections.js +134 -0
  62. package/src/commands/search/get.js +71 -0
  63. package/src/commands/search/index-cmd.js +54 -0
  64. package/src/commands/search/index.js +21 -0
  65. package/src/commands/search/keyword.js +60 -0
  66. package/src/commands/search/qmd.js +70 -0
  67. package/src/commands/search/query.js +64 -0
  68. package/src/commands/search/semantic.js +62 -0
  69. package/src/commands/search/status.js +46 -0
  70. package/src/commands/status.js +224 -171
  71. package/src/commands/tools/check.js +79 -0
  72. package/src/commands/tools/index.js +14 -0
  73. package/src/commands/tools/install.js +110 -0
  74. package/src/commands/tools/list.js +91 -0
  75. package/src/commands/tools/search.js +60 -0
  76. package/src/commands/update.js +83 -112
  77. package/src/commands/util/add.js +151 -0
  78. package/src/commands/util/index.js +15 -0
  79. package/src/commands/util/list.js +97 -0
  80. package/src/commands/util/remove.js +76 -0
  81. package/src/commands/util/run.js +79 -0
  82. package/src/commands/util/show.js +67 -0
  83. package/src/commands/version.js +21 -88
  84. package/src/installers/_template.js +104 -0
  85. package/src/installers/git.js +150 -0
  86. package/src/installers/homebrew.js +190 -0
  87. package/src/installers/node.js +223 -0
  88. package/src/installers/registry.json +29 -0
  89. package/src/lib/config.js +125 -0
  90. package/src/lib/detect.js +74 -0
  91. package/src/lib/errors.js +114 -0
  92. package/src/lib/github.js +315 -0
  93. package/src/lib/installer.js +225 -0
  94. package/src/lib/output.js +239 -0
  95. package/src/lib/platform.js +112 -0
  96. package/src/lib/platforms/amazon-linux.js +41 -0
  97. package/src/lib/platforms/gitbash.js +46 -0
  98. package/src/lib/platforms/macos.js +45 -0
  99. package/src/lib/platforms/raspbian.js +41 -0
  100. package/src/lib/platforms/ubuntu.js +39 -0
  101. package/src/lib/platforms/windows.js +45 -0
  102. package/src/lib/prompt.js +161 -0
  103. package/src/lib/schema.js +211 -0
  104. package/src/lib/shell.js +75 -0
  105. package/src/patterns/gitignore/claude-code.txt +25 -0
  106. package/src/patterns/gitignore/docker.txt +15 -0
  107. package/src/patterns/gitignore/go.txt +24 -0
  108. package/src/patterns/gitignore/java.txt +38 -0
  109. package/src/patterns/gitignore/jetbrains.txt +26 -0
  110. package/src/patterns/gitignore/linux.txt +18 -0
  111. package/src/patterns/gitignore/macos.txt +27 -0
  112. package/src/patterns/gitignore/node.txt +51 -0
  113. package/src/patterns/gitignore/python.txt +55 -0
  114. package/src/patterns/gitignore/rust.txt +14 -0
  115. package/src/patterns/gitignore/terraform.txt +30 -0
  116. package/src/patterns/gitignore/vscode.txt +15 -0
  117. package/src/patterns/gitignore/windows.txt +25 -0
  118. package/src/utils/clone/index.js +165 -0
  119. package/src/utils/git-push/index.js +230 -0
  120. package/src/utils/git-status/index.js +116 -0
  121. package/src/utils/git-status/unix.sh +75 -0
  122. package/src/utils/registry.json +41 -0
  123. package/bin/dev.js +0 -16
  124. package/files/README.md +0 -0
  125. package/files/claude/.claude/commands/setup-context.md +0 -3
  126. package/files/monorepos/_archive/README.md +0 -36
  127. package/files/monorepos/_legacy/README.md +0 -36
  128. package/files/monorepos/ai-docs/README.md +0 -33
  129. package/files/monorepos/apps/README.md +0 -24
  130. package/files/monorepos/docs/README.md +0 -40
  131. package/files/monorepos/packages/README.md +0 -25
  132. package/files/monorepos/research/README.md +0 -29
  133. package/files/monorepos/scripts/README.md +0 -24
  134. package/src/commands/README.md +0 -41
  135. package/src/commands/configure.js +0 -199
  136. package/src/commands/identity.js +0 -1630
  137. package/src/commands/ignore.js +0 -247
  138. package/src/commands/install.js +0 -526
  139. package/src/commands/setup.js +0 -246
  140. package/src/completion.js +0 -284
  141. package/src/constants.js +0 -45
  142. package/src/ignore/claude-code.txt +0 -10
  143. package/src/ignore/docker.txt +0 -18
  144. package/src/ignore/linux.txt +0 -23
  145. package/src/ignore/macos.txt +0 -36
  146. package/src/ignore/node.txt +0 -55
  147. package/src/ignore/terraform.txt +0 -37
  148. package/src/ignore/vscode.txt +0 -18
  149. package/src/ignore/windows.txt +0 -35
  150. package/src/index.js +0 -0
  151. package/src/installs/README.md +0 -399
  152. package/src/installs/adobe-creative-cloud.js +0 -546
  153. package/src/installs/adobe-creative-cloud.md +0 -605
  154. package/src/installs/appcleaner.js +0 -321
  155. package/src/installs/appcleaner.md +0 -699
  156. package/src/installs/apt-transport-https.js +0 -390
  157. package/src/installs/apt-transport-https.md +0 -678
  158. package/src/installs/atomicparsley.js +0 -642
  159. package/src/installs/atomicparsley.md +0 -795
  160. package/src/installs/aws-cli.js +0 -797
  161. package/src/installs/aws-cli.md +0 -727
  162. package/src/installs/balena-etcher.js +0 -710
  163. package/src/installs/balena-etcher.md +0 -761
  164. package/src/installs/bambu-studio.js +0 -1143
  165. package/src/installs/bambu-studio.md +0 -780
  166. package/src/installs/bash-completion.js +0 -575
  167. package/src/installs/bash-completion.md +0 -833
  168. package/src/installs/bash.js +0 -417
  169. package/src/installs/bash.md +0 -993
  170. package/src/installs/beyond-compare.js +0 -603
  171. package/src/installs/beyond-compare.md +0 -813
  172. package/src/installs/brave-browser.js +0 -968
  173. package/src/installs/brave-browser.md +0 -650
  174. package/src/installs/build-essential.js +0 -529
  175. package/src/installs/build-essential.md +0 -977
  176. package/src/installs/ca-certificates.js +0 -618
  177. package/src/installs/ca-certificates.md +0 -937
  178. package/src/installs/caffeine.js +0 -508
  179. package/src/installs/caffeine.md +0 -839
  180. package/src/installs/camtasia.js +0 -596
  181. package/src/installs/camtasia.md +0 -762
  182. package/src/installs/chatgpt.js +0 -476
  183. package/src/installs/chatgpt.md +0 -814
  184. package/src/installs/chocolatey.js +0 -456
  185. package/src/installs/chocolatey.md +0 -661
  186. package/src/installs/chrome-canary.js +0 -419
  187. package/src/installs/chrome-canary.md +0 -641
  188. package/src/installs/chromium.js +0 -667
  189. package/src/installs/chromium.md +0 -838
  190. package/src/installs/claude-code.js +0 -576
  191. package/src/installs/claude-code.md +0 -1173
  192. package/src/installs/cloudflare-warp.js +0 -900
  193. package/src/installs/cloudflare-warp.md +0 -1047
  194. package/src/installs/comet-browser.js +0 -588
  195. package/src/installs/comet-browser.md +0 -731
  196. package/src/installs/curl.js +0 -379
  197. package/src/installs/curl.md +0 -714
  198. package/src/installs/cursor.js +0 -579
  199. package/src/installs/cursor.md +0 -970
  200. package/src/installs/dbeaver.js +0 -924
  201. package/src/installs/dbeaver.md +0 -939
  202. package/src/installs/dbschema.js +0 -692
  203. package/src/installs/dbschema.md +0 -925
  204. package/src/installs/dependencies.md +0 -453
  205. package/src/installs/development-tools.js +0 -600
  206. package/src/installs/development-tools.md +0 -977
  207. package/src/installs/docker.js +0 -1029
  208. package/src/installs/docker.md +0 -1109
  209. package/src/installs/drawio.js +0 -1019
  210. package/src/installs/drawio.md +0 -795
  211. package/src/installs/elmedia-player.js +0 -347
  212. package/src/installs/elmedia-player.md +0 -556
  213. package/src/installs/ffmpeg.js +0 -889
  214. package/src/installs/ffmpeg.md +0 -852
  215. package/src/installs/file.js +0 -464
  216. package/src/installs/file.md +0 -987
  217. package/src/installs/gemini-cli.js +0 -811
  218. package/src/installs/gemini-cli.md +0 -1153
  219. package/src/installs/git.js +0 -400
  220. package/src/installs/git.md +0 -907
  221. package/src/installs/gitego.js +0 -949
  222. package/src/installs/gitego.md +0 -1172
  223. package/src/installs/go.js +0 -931
  224. package/src/installs/go.md +0 -958
  225. package/src/installs/google-antigravity.js +0 -913
  226. package/src/installs/google-antigravity.md +0 -1075
  227. package/src/installs/google-chrome.js +0 -833
  228. package/src/installs/google-chrome.md +0 -862
  229. package/src/installs/gpg.js +0 -480
  230. package/src/installs/gpg.md +0 -1056
  231. package/src/installs/homebrew.js +0 -1028
  232. package/src/installs/homebrew.md +0 -988
  233. package/src/installs/imageoptim.js +0 -968
  234. package/src/installs/imageoptim.md +0 -1119
  235. package/src/installs/installers.json +0 -4032
  236. package/src/installs/installers.json.tmp +0 -3953
  237. package/src/installs/jq.js +0 -400
  238. package/src/installs/jq.md +0 -809
  239. package/src/installs/keyboard-maestro.js +0 -719
  240. package/src/installs/keyboard-maestro.md +0 -825
  241. package/src/installs/kiro.js +0 -864
  242. package/src/installs/kiro.md +0 -1015
  243. package/src/installs/latex.js +0 -789
  244. package/src/installs/latex.md +0 -1095
  245. package/src/installs/lftp.js +0 -356
  246. package/src/installs/lftp.md +0 -907
  247. package/src/installs/lsb-release.js +0 -346
  248. package/src/installs/lsb-release.md +0 -814
  249. package/src/installs/messenger.js +0 -847
  250. package/src/installs/messenger.md +0 -900
  251. package/src/installs/microsoft-office.js +0 -568
  252. package/src/installs/microsoft-office.md +0 -760
  253. package/src/installs/microsoft-teams.js +0 -801
  254. package/src/installs/microsoft-teams.md +0 -886
  255. package/src/installs/moom.js +0 -326
  256. package/src/installs/moom.md +0 -570
  257. package/src/installs/node.js +0 -904
  258. package/src/installs/node.md +0 -1153
  259. package/src/installs/nordpass.js +0 -716
  260. package/src/installs/nordpass.md +0 -921
  261. package/src/installs/nordvpn.js +0 -892
  262. package/src/installs/nordvpn.md +0 -1052
  263. package/src/installs/nvm.js +0 -995
  264. package/src/installs/nvm.md +0 -1057
  265. package/src/installs/ohmyzsh.js +0 -529
  266. package/src/installs/ohmyzsh.md +0 -1094
  267. package/src/installs/openssh.js +0 -804
  268. package/src/installs/openssh.md +0 -1056
  269. package/src/installs/pandoc.js +0 -662
  270. package/src/installs/pandoc.md +0 -1036
  271. package/src/installs/parallels-desktop.js +0 -431
  272. package/src/installs/parallels-desktop.md +0 -446
  273. package/src/installs/pinentry.js +0 -510
  274. package/src/installs/pinentry.md +0 -1142
  275. package/src/installs/pngyu.js +0 -869
  276. package/src/installs/pngyu.md +0 -896
  277. package/src/installs/postman.js +0 -799
  278. package/src/installs/postman.md +0 -940
  279. package/src/installs/procps.js +0 -425
  280. package/src/installs/procps.md +0 -851
  281. package/src/installs/safari-tech-preview.js +0 -374
  282. package/src/installs/safari-tech-preview.md +0 -533
  283. package/src/installs/sfnt2woff.js +0 -658
  284. package/src/installs/sfnt2woff.md +0 -795
  285. package/src/installs/shellcheck.js +0 -481
  286. package/src/installs/shellcheck.md +0 -1005
  287. package/src/installs/slack.js +0 -741
  288. package/src/installs/slack.md +0 -865
  289. package/src/installs/snagit.js +0 -585
  290. package/src/installs/snagit.md +0 -844
  291. package/src/installs/software-properties-common.js +0 -372
  292. package/src/installs/software-properties-common.md +0 -805
  293. package/src/installs/spotify.js +0 -877
  294. package/src/installs/spotify.md +0 -901
  295. package/src/installs/studio-3t.js +0 -823
  296. package/src/installs/studio-3t.md +0 -918
  297. package/src/installs/sublime-text.js +0 -804
  298. package/src/installs/sublime-text.md +0 -914
  299. package/src/installs/superwhisper.js +0 -706
  300. package/src/installs/superwhisper.md +0 -630
  301. package/src/installs/tailscale.js +0 -745
  302. package/src/installs/tailscale.md +0 -1100
  303. package/src/installs/tar.js +0 -389
  304. package/src/installs/tar.md +0 -946
  305. package/src/installs/termius.js +0 -798
  306. package/src/installs/termius.md +0 -844
  307. package/src/installs/terraform.js +0 -779
  308. package/src/installs/terraform.md +0 -899
  309. package/src/installs/tfenv.js +0 -778
  310. package/src/installs/tfenv.md +0 -1091
  311. package/src/installs/tidal.js +0 -771
  312. package/src/installs/tidal.md +0 -864
  313. package/src/installs/tmux.js +0 -346
  314. package/src/installs/tmux.md +0 -1030
  315. package/src/installs/tree.js +0 -411
  316. package/src/installs/tree.md +0 -833
  317. package/src/installs/unzip.js +0 -460
  318. package/src/installs/unzip.md +0 -879
  319. package/src/installs/vim.js +0 -421
  320. package/src/installs/vim.md +0 -1040
  321. package/src/installs/vlc.js +0 -821
  322. package/src/installs/vlc.md +0 -927
  323. package/src/installs/vscode.js +0 -843
  324. package/src/installs/vscode.md +0 -1002
  325. package/src/installs/wget.js +0 -420
  326. package/src/installs/wget.md +0 -791
  327. package/src/installs/whatsapp.js +0 -729
  328. package/src/installs/whatsapp.md +0 -854
  329. package/src/installs/winpty.js +0 -352
  330. package/src/installs/winpty.md +0 -620
  331. package/src/installs/woff2.js +0 -553
  332. package/src/installs/woff2.md +0 -977
  333. package/src/installs/wsl.js +0 -572
  334. package/src/installs/wsl.md +0 -699
  335. package/src/installs/xcode-clt.js +0 -520
  336. package/src/installs/xcode-clt.md +0 -351
  337. package/src/installs/xcode.js +0 -560
  338. package/src/installs/xcode.md +0 -573
  339. package/src/installs/yarn.js +0 -824
  340. package/src/installs/yarn.md +0 -1074
  341. package/src/installs/yq.js +0 -654
  342. package/src/installs/yq.md +0 -944
  343. package/src/installs/yt-dlp.js +0 -701
  344. package/src/installs/yt-dlp.md +0 -946
  345. package/src/installs/yum-utils.js +0 -297
  346. package/src/installs/yum-utils.md +0 -648
  347. package/src/installs/zoom.js +0 -759
  348. package/src/installs/zoom.md +0 -884
  349. package/src/installs/zsh.js +0 -455
  350. package/src/installs/zsh.md +0 -1008
  351. package/src/scripts/README.md +0 -617
  352. package/src/scripts/STATUS.md +0 -208
  353. package/src/scripts/afk.js +0 -411
  354. package/src/scripts/backup-all.js +0 -746
  355. package/src/scripts/backup-source.js +0 -727
  356. package/src/scripts/brewd.js +0 -389
  357. package/src/scripts/brewi.js +0 -520
  358. package/src/scripts/brewr.js +0 -527
  359. package/src/scripts/brews.js +0 -477
  360. package/src/scripts/brewu.js +0 -504
  361. package/src/scripts/c.js +0 -201
  362. package/src/scripts/ccurl.js +0 -341
  363. package/src/scripts/certbot-crontab-init.js +0 -504
  364. package/src/scripts/certbot-init.js +0 -657
  365. package/src/scripts/ch.js +0 -355
  366. package/src/scripts/claude-danger.js +0 -268
  367. package/src/scripts/clean-dev.js +0 -435
  368. package/src/scripts/clear-dns-cache.js +0 -541
  369. package/src/scripts/clone.js +0 -435
  370. package/src/scripts/code-all.js +0 -437
  371. package/src/scripts/count-files.js +0 -211
  372. package/src/scripts/count-folders.js +0 -211
  373. package/src/scripts/count.js +0 -264
  374. package/src/scripts/d.js +0 -219
  375. package/src/scripts/datauri.js +0 -389
  376. package/src/scripts/delete-files.js +0 -380
  377. package/src/scripts/docker-clean.js +0 -426
  378. package/src/scripts/dp.js +0 -442
  379. package/src/scripts/e.js +0 -390
  380. package/src/scripts/empty-trash.js +0 -513
  381. package/src/scripts/evm.js +0 -444
  382. package/src/scripts/fetch-github-repos.js +0 -456
  383. package/src/scripts/get-channel.js +0 -345
  384. package/src/scripts/get-course.js +0 -399
  385. package/src/scripts/get-dependencies.js +0 -306
  386. package/src/scripts/get-folder.js +0 -799
  387. package/src/scripts/get-tunes.js +0 -426
  388. package/src/scripts/get-video.js +0 -367
  389. package/src/scripts/git-backup.js +0 -577
  390. package/src/scripts/git-clone.js +0 -493
  391. package/src/scripts/git-pup.js +0 -319
  392. package/src/scripts/git-push.js +0 -396
  393. package/src/scripts/h.js +0 -622
  394. package/src/scripts/hide-desktop-icons.js +0 -499
  395. package/src/scripts/hide-hidden-files.js +0 -538
  396. package/src/scripts/install-dependencies-from.js +0 -456
  397. package/src/scripts/ips.js +0 -663
  398. package/src/scripts/iso.js +0 -370
  399. package/src/scripts/killni.js +0 -577
  400. package/src/scripts/ll.js +0 -467
  401. package/src/scripts/local-ip.js +0 -325
  402. package/src/scripts/m.js +0 -524
  403. package/src/scripts/map.js +0 -309
  404. package/src/scripts/mkd.js +0 -351
  405. package/src/scripts/ncu-update-all.js +0 -457
  406. package/src/scripts/nginx-init.js +0 -718
  407. package/src/scripts/npmi.js +0 -382
  408. package/src/scripts/o.js +0 -511
  409. package/src/scripts/org-by-date.js +0 -338
  410. package/src/scripts/p.js +0 -224
  411. package/src/scripts/packages.js +0 -330
  412. package/src/scripts/path.js +0 -225
  413. package/src/scripts/ports.js +0 -597
  414. package/src/scripts/q.js +0 -305
  415. package/src/scripts/refresh-files.js +0 -394
  416. package/src/scripts/remove-smaller-files.js +0 -516
  417. package/src/scripts/rename-files-with-date.js +0 -533
  418. package/src/scripts/resize-image.js +0 -539
  419. package/src/scripts/rm-safe.js +0 -669
  420. package/src/scripts/s.js +0 -540
  421. package/src/scripts/set-git-public.js +0 -365
  422. package/src/scripts/show-desktop-icons.js +0 -475
  423. package/src/scripts/show-hidden-files.js +0 -472
  424. package/src/scripts/tpa.js +0 -280
  425. package/src/scripts/tpo.js +0 -280
  426. package/src/scripts/u.js +0 -505
  427. package/src/scripts/vpush.js +0 -437
  428. package/src/scripts/y.js +0 -283
  429. package/src/utils/README.md +0 -95
  430. package/src/utils/common/apps.js +0 -143
  431. package/src/utils/common/display.js +0 -157
  432. package/src/utils/common/network.js +0 -185
  433. package/src/utils/common/os.js +0 -294
  434. package/src/utils/common/package-manager.js +0 -301
  435. package/src/utils/common/privileges.js +0 -138
  436. package/src/utils/common/shell.js +0 -261
  437. package/src/utils/macos/apps.js +0 -228
  438. package/src/utils/macos/brew.js +0 -315
  439. package/src/utils/ubuntu/apt.js +0 -307
  440. package/src/utils/ubuntu/desktop.js +0 -292
  441. package/src/utils/ubuntu/snap.js +0 -344
  442. package/src/utils/ubuntu/systemd.js +0 -286
  443. package/src/utils/windows/choco.js +0 -465
  444. package/src/utils/windows/env.js +0 -246
  445. package/src/utils/windows/registry.js +0 -269
  446. package/src/utils/windows/shell.js +0 -240
  447. package/src/utils/windows/winget.js +0 -489
@@ -1,921 +0,0 @@
1
- # Installing NordPass
2
-
3
- ## Overview
4
-
5
- NordPass is a password manager developed by Nord Security, the company behind NordVPN. It provides secure storage for passwords, credit card information, secure notes, and other sensitive data. NordPass uses XChaCha20 encryption (a modern, highly secure encryption algorithm) and operates on a zero-knowledge architecture, meaning only you can access your vault contents.
6
-
7
- Key features include:
8
- - **Password generation** - Create strong, unique passwords
9
- - **Autofill and autosave** - Automatically fill login forms and save new credentials
10
- - **Data breach scanner** - Check if your credentials have been exposed in known breaches
11
- - **Password health checker** - Identify weak, reused, or old passwords
12
- - **Cross-platform sync** - Access your vault from any device
13
- - **Browser extensions** - Direct integration with major browsers
14
-
15
- **Important Platform Notes**:
16
- - Nord Security provides official desktop applications for **macOS**, **Windows**, and **Linux** (x86_64/amd64 only)
17
- - **Raspberry Pi OS and Amazon Linux** do not have native NordPass desktop applications due to ARM architecture limitations (Raspberry Pi) and lack of Snap/Flatpak support (Amazon Linux)
18
- - For unsupported platforms, the NordPass **browser extension** or **web vault** (https://app.nordpass.com) can be used as alternatives
19
-
20
- ## Dependencies
21
-
22
- ### macOS (Homebrew)
23
- - **Required:**
24
- - Homebrew package manager - Install via `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`
25
- - **Optional:** None
26
- - **Auto-installed:** None (Homebrew handles all application dependencies automatically)
27
-
28
- ### Ubuntu (APT/Snap)
29
- - **Required:**
30
- - `snapd` - Install via `sudo apt-get install -y snapd` (auto-installed by the script if missing)
31
- - x86_64/amd64 architecture (ARM architectures like aarch64/armv7l are not supported)
32
- - **Optional:** None
33
- - **Auto-installed:** All Snap package dependencies are handled automatically by snapd
34
-
35
- ### Raspberry Pi OS (APT/Snap)
36
- - **Required:** None
37
- - **Optional:** None
38
- - **Auto-installed:** None
39
- - **Note:** Installation not supported on this platform. NordPass desktop application does not support ARM architecture (aarch64, armv7l). Use the browser extension or web vault instead.
40
-
41
- ### Amazon Linux (DNF/YUM)
42
- - **Required:** None
43
- - **Optional:** None
44
- - **Auto-installed:** None
45
- - **Note:** Installation not supported on this platform. Amazon Linux does not natively support Snap or Flatpak. Use the browser extension or web vault instead.
46
-
47
- ### Windows (Chocolatey/winget)
48
- - **Required:**
49
- - Chocolatey package manager - Install via PowerShell (Administrator): `Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))`
50
- - **Optional:** None
51
- - **Auto-installed:** All application dependencies are handled automatically by Chocolatey
52
-
53
- ### Git Bash (Manual/Portable)
54
- - **Required:**
55
- - Chocolatey on the Windows host system - Install via PowerShell (Administrator): `Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))`
56
- - Windows 10 or later (64-bit)
57
- - **Optional:** None
58
- - **Auto-installed:** Same as Windows platform (Chocolatey handles all application dependencies)
59
-
60
- ## Prerequisites
61
-
62
- Before installing NordPass on any platform, ensure:
63
-
64
- 1. **NordPass account** - A free or paid NordPass account is required (create at https://nordpass.com)
65
- 2. **Internet connectivity** - Required for sync, authentication, and updates
66
- 3. **Administrative privileges** - Required for installation on most platforms
67
- 4. **64-bit operating system** - NordPass requires a 64-bit system on all platforms
68
-
69
- ## Platform-Specific Installation
70
-
71
- ### macOS (Homebrew)
72
-
73
- #### Prerequisites
74
-
75
- - macOS 11 (Big Sur) or later
76
- - Homebrew package manager installed
77
- - Apple Silicon (M1/M2/M3/M4) or Intel processor
78
- - At least 200 MB free disk space
79
-
80
- If Homebrew is not installed, install it first:
81
-
82
- ```bash
83
- NONINTERACTIVE=1 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
84
- ```
85
-
86
- #### Installation Steps
87
-
88
- Run the following command to install NordPass:
89
-
90
- ```bash
91
- brew install --cask --quiet nordpass
92
- ```
93
-
94
- The `--quiet` flag suppresses non-essential output, making the command suitable for automation scripts. The `--cask` flag specifies this is a macOS application (GUI app) rather than a command-line tool.
95
-
96
- After installation, launch NordPass:
97
-
98
- ```bash
99
- open -a NordPass
100
- ```
101
-
102
- #### Verification
103
-
104
- Confirm the installation succeeded by checking the application exists:
105
-
106
- ```bash
107
- ls /Applications/NordPass.app
108
- ```
109
-
110
- Expected output:
111
-
112
- ```
113
- /Applications/NordPass.app
114
- ```
115
-
116
- Alternatively, launch the application to verify it opens correctly:
117
-
118
- ```bash
119
- open -a NordPass
120
- ```
121
-
122
- #### Troubleshooting
123
-
124
- **Problem**: Installation fails with "Cask 'nordpass' is unavailable"
125
-
126
- **Solution**: Update Homebrew to get the latest cask definitions:
127
-
128
- ```bash
129
- brew update
130
- brew install --cask --quiet nordpass
131
- ```
132
-
133
- **Problem**: App shows "NordPass can't be opened because Apple cannot check it for malicious software"
134
-
135
- **Solution**: This can occur on first launch. Right-click the app in Applications and select "Open", then click "Open" in the dialog. Alternatively, clear the quarantine flag:
136
-
137
- ```bash
138
- xattr -cr /Applications/NordPass.app
139
- ```
140
-
141
- **Problem**: `brew: command not found`
142
-
143
- **Solution**: Homebrew is not installed or not in PATH. For Apple Silicon Macs, add Homebrew to your PATH:
144
-
145
- ```bash
146
- eval "$(/opt/homebrew/bin/brew shellenv)"
147
- ```
148
-
149
- For Intel Macs:
150
-
151
- ```bash
152
- eval "$(/usr/local/bin/brew shellenv)"
153
- ```
154
-
155
- **Problem**: NordPass browser extension not connecting to desktop app
156
-
157
- **Solution**: Ensure both the desktop app and browser extension are installed. Restart the browser after installing the desktop app. The extension should automatically detect the desktop app.
158
-
159
- ---
160
-
161
- ### Ubuntu/Debian (Snap)
162
-
163
- #### Prerequisites
164
-
165
- - Ubuntu 18.04 or later, or Debian 10 or later (64-bit x86_64/amd64)
166
- - snapd service installed and running (pre-installed on Ubuntu 16.04+)
167
- - sudo privileges
168
- - Active internet connection
169
-
170
- **Important**: NordPass for Linux is officially distributed via Snap. The Snap package is maintained by NordPass and provides automatic updates. Do not use unofficial .deb packages.
171
-
172
- #### Installation Steps
173
-
174
- **Step 1: Ensure snapd is installed**
175
-
176
- On Ubuntu 16.04 and later, snapd is pre-installed. On Debian or other distributions, install it first:
177
-
178
- ```bash
179
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
180
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
181
- ```
182
-
183
- After installing snapd, log out and log back in, or restart your system to ensure snap paths are updated correctly.
184
-
185
- **Step 2: Install NordPass**
186
-
187
- ```bash
188
- sudo snap install nordpass
189
- ```
190
-
191
- The snap package handles all dependencies automatically and will auto-update in the background.
192
-
193
- #### Verification
194
-
195
- Confirm the installation succeeded:
196
-
197
- ```bash
198
- snap list nordpass
199
- ```
200
-
201
- Expected output (version may vary):
202
-
203
- ```
204
- Name Version Rev Tracking Publisher Notes
205
- nordpass 5.25.19 xxx latest/stable nordsec** -
206
- ```
207
-
208
- Launch NordPass:
209
-
210
- ```bash
211
- nordpass &
212
- ```
213
-
214
- Or find "NordPass" in your application menu.
215
-
216
- #### Troubleshooting
217
-
218
- **Problem**: `snap: command not found`
219
-
220
- **Solution**: Install snapd:
221
-
222
- ```bash
223
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
224
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
225
- ```
226
-
227
- Then log out and log back in, or reboot.
228
-
229
- **Problem**: "error: cannot communicate with server"
230
-
231
- **Solution**: The snapd service may not be running. Start and enable it:
232
-
233
- ```bash
234
- sudo systemctl enable --now snapd.socket
235
- sudo systemctl enable --now snapd.service
236
- ```
237
-
238
- **Problem**: NordPass window does not appear
239
-
240
- **Solution**: Snap applications may have issues with certain display servers. Try running with explicit display settings:
241
-
242
- ```bash
243
- DISPLAY=:0 nordpass &
244
- ```
245
-
246
- **Problem**: Cannot find NordPass in application menu
247
-
248
- **Solution**: The snap bin directory may not be in PATH. Add it to your shell configuration:
249
-
250
- ```bash
251
- echo 'export PATH=$PATH:/snap/bin' >> ~/.bashrc
252
- source ~/.bashrc
253
- ```
254
-
255
- **Problem**: "Architecture not supported" error
256
-
257
- **Solution**: NordPass Snap only supports amd64 (x86_64) architecture. Check your architecture:
258
-
259
- ```bash
260
- uname -m
261
- ```
262
-
263
- If it shows `aarch64` or `armv7l`, your system uses ARM architecture which is not supported. Use the NordPass browser extension instead.
264
-
265
- ---
266
-
267
- ### Raspberry Pi OS (Browser Extension)
268
-
269
- #### Prerequisites
270
-
271
- - Raspberry Pi OS (32-bit or 64-bit)
272
- - Raspberry Pi 3B+ or later recommended
273
- - Web browser installed (Chromium comes pre-installed)
274
- - Active internet connection
275
-
276
- **Important**: NordPass does **not** provide a native desktop application for ARM architecture (Raspberry Pi). The NordPass Snap package only supports amd64 (x86_64) processors. For Raspberry Pi users, the recommended solution is to use the NordPass browser extension or web vault.
277
-
278
- Verify your architecture:
279
-
280
- ```bash
281
- uname -m
282
- ```
283
-
284
- - `aarch64` = 64-bit ARM
285
- - `armv7l` = 32-bit ARM
286
-
287
- Neither architecture is supported by the NordPass desktop application.
288
-
289
- #### Installation Steps
290
-
291
- **Install the NordPass browser extension in Chromium:**
292
-
293
- Chromium is pre-installed on Raspberry Pi OS. Launch it and install the NordPass extension:
294
-
295
- ```bash
296
- chromium-browser https://chrome.google.com/webstore/detail/nordpass-password-manager/fooolghllnmhmmndgjiamiiodkpenpbb &
297
- ```
298
-
299
- Click "Add to Chrome" and confirm the installation.
300
-
301
- **Alternative: Use the NordPass Web Vault**
302
-
303
- Access NordPass directly through the web vault without any installation:
304
-
305
- ```bash
306
- chromium-browser https://app.nordpass.com &
307
- ```
308
-
309
- The web vault provides full access to your passwords and secure items without requiring a desktop application.
310
-
311
- **Alternative: Install Firefox and use the Firefox extension**
312
-
313
- If you prefer Firefox:
314
-
315
- ```bash
316
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
317
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y firefox-esr
318
- firefox-esr https://addons.mozilla.org/en-US/firefox/addon/nordpass-password-manager-b2b/ &
319
- ```
320
-
321
- #### Verification
322
-
323
- Verify the browser extension is installed by checking the browser toolbar for the NordPass icon (a green/dark shield logo).
324
-
325
- Test the web vault access:
326
-
327
- ```bash
328
- chromium-browser https://app.nordpass.com &
329
- ```
330
-
331
- You should be able to log in and access your vault.
332
-
333
- #### Troubleshooting
334
-
335
- **Problem**: Browser extension not syncing or slow
336
-
337
- **Solution**: Raspberry Pi has limited resources. Close other applications and browser tabs:
338
-
339
- ```bash
340
- # Check memory usage
341
- free -h
342
- ```
343
-
344
- If memory is low, consider using a swap file or using the lightweight web vault instead of the full extension.
345
-
346
- **Problem**: Cannot install extensions in Chromium
347
-
348
- **Solution**: Ensure you are using the latest version of Chromium:
349
-
350
- ```bash
351
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
352
- sudo DEBIAN_FRONTEND=noninteractive apt-get upgrade -y chromium-browser
353
- ```
354
-
355
- **Problem**: Web vault loads slowly
356
-
357
- **Solution**: The web interface may be resource-intensive for Raspberry Pi. Try using Firefox ESR which may perform better on low-resource systems:
358
-
359
- ```bash
360
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y firefox-esr
361
- firefox-esr https://app.nordpass.com &
362
- ```
363
-
364
- ---
365
-
366
- ### Amazon Linux (Browser Extension / Web Vault)
367
-
368
- #### Prerequisites
369
-
370
- - Amazon Linux 2023 (AL2023) or Amazon Linux 2 (AL2)
371
- - Desktop environment installed (if using graphical browser)
372
- - sudo privileges
373
-
374
- **Important**: NordPass does not provide a native desktop application for Amazon Linux. Amazon Linux does not natively support Snap or Flatpak, which are the primary distribution methods for NordPass on Linux. For Amazon Linux environments, use the NordPass web vault or browser extension.
375
-
376
- #### Installation Steps
377
-
378
- **For Desktop Environments with Browser:**
379
-
380
- If you have a graphical desktop environment, install a browser and use the NordPass web vault or browser extension:
381
-
382
- ```bash
383
- # Install Firefox on Amazon Linux 2023
384
- sudo dnf install -y firefox
385
-
386
- # Or on Amazon Linux 2
387
- sudo amazon-linux-extras install -y firefox
388
- ```
389
-
390
- Then access the web vault:
391
-
392
- ```bash
393
- firefox https://app.nordpass.com &
394
- ```
395
-
396
- Or install the NordPass extension from:
397
- - Firefox: https://addons.mozilla.org/en-US/firefox/addon/nordpass-password-manager-b2b/
398
- - Chrome: https://chrome.google.com/webstore/detail/nordpass-password-manager/fooolghllnmhmmndgjiamiiodkpenpbb
399
-
400
- **For Headless Server Environments:**
401
-
402
- On headless servers (most Amazon Linux use cases), you cannot use NordPass directly. Consider these alternatives:
403
-
404
- 1. **Use the NordPass web vault** from a workstation with browser access
405
- 2. **Export passwords** to a secure local password store for server use
406
- 3. **Use AWS Secrets Manager** or **AWS Parameter Store** for server-side credential management (recommended for automation)
407
-
408
- **Alternative: Install Snap (Experimental)**
409
-
410
- Snap can be installed on Amazon Linux with additional configuration, but this is not officially supported:
411
-
412
- ```bash
413
- # For Amazon Linux 2023 - Experimental, not officially supported
414
- sudo dnf install -y epel-release
415
- sudo dnf install -y snapd
416
- sudo systemctl enable --now snapd.socket
417
- sudo ln -s /var/lib/snapd/snap /snap
418
-
419
- # Log out and log back in, then:
420
- sudo snap install nordpass
421
- ```
422
-
423
- **Warning**: This approach is experimental and may not work reliably on all Amazon Linux configurations.
424
-
425
- #### Verification
426
-
427
- For browser-based access, verify the web vault loads:
428
-
429
- ```bash
430
- firefox https://app.nordpass.com &
431
- ```
432
-
433
- Log in with your NordPass credentials to confirm access.
434
-
435
- #### Troubleshooting
436
-
437
- **Problem**: Firefox not available in package manager
438
-
439
- **Solution**: On Amazon Linux 2, use amazon-linux-extras:
440
-
441
- ```bash
442
- sudo amazon-linux-extras install -y firefox
443
- ```
444
-
445
- On Amazon Linux 2023:
446
-
447
- ```bash
448
- sudo dnf install -y firefox
449
- ```
450
-
451
- **Problem**: No graphical display available
452
-
453
- **Solution**: Amazon Linux is typically a server OS. For headless environments, access NordPass from a workstation with a browser, or use X11 forwarding:
454
-
455
- ```bash
456
- # From your local machine, connect with X11 forwarding
457
- ssh -X ec2-user@your-instance
458
- firefox https://app.nordpass.com &
459
- ```
460
-
461
- **Problem**: Snap installation fails
462
-
463
- **Solution**: Snap on Amazon Linux is not officially supported. Use the web vault or browser extension method instead.
464
-
465
- ---
466
-
467
- ### Windows (Chocolatey)
468
-
469
- #### Prerequisites
470
-
471
- - Windows 10 or later, or Windows Server 2016 or later
472
- - Administrator PowerShell or Command Prompt
473
- - Chocolatey package manager installed
474
- - Active internet connection
475
-
476
- If Chocolatey is not installed, install it first by running this command in an Administrator PowerShell:
477
-
478
- ```powershell
479
- Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
480
- ```
481
-
482
- #### Installation Steps
483
-
484
- Run the following command in an Administrator PowerShell or Command Prompt:
485
-
486
- ```powershell
487
- choco install nordpass -y
488
- ```
489
-
490
- The `-y` flag automatically confirms all prompts, enabling fully non-interactive installation. The installer uses silent installation arguments (`/S`) automatically.
491
-
492
- After installation, NordPass will be available in the Start Menu.
493
-
494
- #### Verification
495
-
496
- Verify the installation:
497
-
498
- ```powershell
499
- choco list nordpass
500
- ```
501
-
502
- Expected output (version may vary):
503
-
504
- ```
505
- Chocolatey v2.x.x
506
- nordpass 5.9.25
507
- 1 packages installed.
508
- ```
509
-
510
- Launch NordPass from the Start Menu, or via command line:
511
-
512
- ```powershell
513
- start "" "C:\Program Files\NordPass\NordPass.exe"
514
- ```
515
-
516
- #### Troubleshooting
517
-
518
- **Problem**: Installation fails with "Checksum validation failed"
519
-
520
- **Solution**: The package checksum may have changed. Try forcing reinstallation with checksum skip (use with caution):
521
-
522
- ```powershell
523
- choco install nordpass -y --ignore-checksums
524
- ```
525
-
526
- **Problem**: `choco: command not found`
527
-
528
- **Solution**: Chocolatey is not installed or not in PATH. Close and reopen your terminal as Administrator, then verify:
529
-
530
- ```powershell
531
- refreshenv
532
- choco --version
533
- ```
534
-
535
- If still not found, reinstall Chocolatey using the command in the Prerequisites section.
536
-
537
- **Problem**: NordPass does not appear in Start Menu after installation
538
-
539
- **Solution**: Refresh the Windows shell:
540
-
541
- ```powershell
542
- refreshenv
543
- ```
544
-
545
- Or restart Windows Explorer:
546
-
547
- ```powershell
548
- Stop-Process -Name explorer -Force
549
- Start-Process explorer
550
- ```
551
-
552
- **Problem**: Browser extension not connecting to desktop app
553
-
554
- **Solution**: Ensure both are installed. Restart your browser after installing the desktop app. If issues persist, reinstall the browser extension from the browser's extension store.
555
-
556
- ---
557
-
558
- ### WSL (Ubuntu)
559
-
560
- #### Prerequisites
561
-
562
- - Windows 10 version 2004 or higher, or Windows 11
563
- - WSL 2 enabled with Ubuntu distribution installed
564
- - sudo privileges within WSL
565
- - WSLg (Windows 11) for GUI support, or X server configured (Windows 10)
566
-
567
- **Recommended Approach**: Install NordPass on Windows (see Windows section) and access your passwords through the browser. The Windows app and browser extensions work seamlessly alongside WSL.
568
-
569
- **Alternative Approach**: Install NordPass via Snap within WSL (requires WSL 2 with systemd and WSLg for GUI).
570
-
571
- #### Installation Steps
572
-
573
- **Option A: Use Windows NordPass Installation (Recommended)**
574
-
575
- Install NordPass on Windows using Chocolatey (see Windows section), then access it from WSL:
576
-
577
- 1. Install NordPass on Windows
578
- 2. Use the NordPass browser extension in your Windows browser
579
- 3. For browser-based access from WSL, use `wslview`:
580
-
581
- ```bash
582
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
583
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wslu
584
- wslview https://app.nordpass.com
585
- ```
586
-
587
- This opens the NordPass web vault in your default Windows browser.
588
-
589
- **Option B: Install NordPass Snap in WSL (WSL 2 + WSLg)**
590
-
591
- For WSL 2 on Windows 11 with WSLg, you can run Linux GUI applications natively.
592
-
593
- First, enable systemd in WSL. Edit `/etc/wsl.conf`:
594
-
595
- ```bash
596
- sudo tee /etc/wsl.conf > /dev/null << 'EOF'
597
- [boot]
598
- systemd=true
599
- EOF
600
- ```
601
-
602
- Restart WSL from PowerShell:
603
-
604
- ```powershell
605
- wsl --shutdown
606
- ```
607
-
608
- Reopen WSL and install snapd:
609
-
610
- ```bash
611
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
612
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
613
- sudo snap install nordpass
614
- ```
615
-
616
- #### Verification
617
-
618
- For Option A (web vault access):
619
-
620
- ```bash
621
- wslview https://app.nordpass.com
622
- ```
623
-
624
- This should open the NordPass web vault in your Windows browser.
625
-
626
- For Option B (Snap installation):
627
-
628
- ```bash
629
- snap list nordpass
630
- ```
631
-
632
- Launch NordPass:
633
-
634
- ```bash
635
- nordpass &
636
- ```
637
-
638
- #### Troubleshooting
639
-
640
- **Problem**: GUI applications do not display
641
-
642
- **Solution**: WSLg requires Windows 11. For Windows 10, install an X server like VcXsrv:
643
-
644
- 1. Install VcXsrv on Windows from https://sourceforge.net/projects/vcxsrv/
645
- 2. Launch XLaunch with "Multiple windows" and "Disable access control"
646
- 3. In WSL, set the display:
647
-
648
- ```bash
649
- export DISPLAY=$(grep nameserver /etc/resolv.conf | awk '{print $2}'):0.0
650
- ```
651
-
652
- **Problem**: systemctl commands fail in WSL
653
-
654
- **Solution**: systemd may not be enabled. Edit `/etc/wsl.conf` as shown above and restart WSL with `wsl --shutdown`.
655
-
656
- **Problem**: Snap installation fails or hangs
657
-
658
- **Solution**: Snap may have issues in WSL. Use the Windows NordPass installation (Option A) or the web vault:
659
-
660
- ```bash
661
- wslview https://app.nordpass.com
662
- ```
663
-
664
- **Problem**: `wslview: command not found`
665
-
666
- **Solution**: Install wslu utilities:
667
-
668
- ```bash
669
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
670
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wslu
671
- ```
672
-
673
- ---
674
-
675
- ### Git Bash (Windows Installation)
676
-
677
- #### Prerequisites
678
-
679
- - Windows 10 or later
680
- - Git Bash installed (comes with Git for Windows)
681
- - NordPass installed on Windows (see Windows section)
682
-
683
- **Note**: Git Bash on Windows runs within the Windows environment and inherits the Windows PATH. Once NordPass is installed on Windows, you can launch it from Git Bash. Git Bash itself cannot run the NordPass Linux application.
684
-
685
- #### Installation Steps
686
-
687
- Git Bash can execute Windows commands directly. Install NordPass using Chocolatey:
688
-
689
- **Method 1: Use choco.exe directly from Git Bash**
690
-
691
- Run Git Bash as Administrator, then:
692
-
693
- ```bash
694
- choco.exe install nordpass -y
695
- ```
696
-
697
- **Method 2: Use PowerShell from Git Bash**
698
-
699
- ```bash
700
- powershell.exe -Command "choco install nordpass -y"
701
- ```
702
-
703
- **Method 3: Use winget from Git Bash**
704
-
705
- If you prefer winget over Chocolatey:
706
-
707
- ```bash
708
- winget.exe install --id NordSecurity.NordPass --silent --accept-package-agreements --accept-source-agreements
709
- ```
710
-
711
- After installation, close and reopen Git Bash for PATH updates to take effect.
712
-
713
- #### Verification
714
-
715
- Verify NordPass is installed:
716
-
717
- ```bash
718
- choco.exe list nordpass
719
- ```
720
-
721
- Or check if the executable exists:
722
-
723
- ```bash
724
- ls "/c/Program Files/NordPass/NordPass.exe"
725
- ```
726
-
727
- Launch NordPass from Git Bash:
728
-
729
- ```bash
730
- start "" "/c/Program Files/NordPass/NordPass.exe"
731
- ```
732
-
733
- Or open the web vault:
734
-
735
- ```bash
736
- start https://app.nordpass.com
737
- ```
738
-
739
- #### Troubleshooting
740
-
741
- **Problem**: `choco.exe: command not found`
742
-
743
- **Solution**: Chocolatey may not be in the Git Bash PATH. Use the full path:
744
-
745
- ```bash
746
- /c/ProgramData/chocolatey/bin/choco.exe install nordpass -y
747
- ```
748
-
749
- **Problem**: `start: command not found`
750
-
751
- **Solution**: In Git Bash, use `cmd.exe` to run Windows commands:
752
-
753
- ```bash
754
- cmd.exe /c start "" "C:\Program Files\NordPass\NordPass.exe"
755
- ```
756
-
757
- **Problem**: Installation fails with permission errors
758
-
759
- **Solution**: Git Bash must be run as Administrator for Chocolatey installations. Right-click Git Bash and select "Run as administrator", then retry the installation.
760
-
761
- **Problem**: NordPass installed but cannot launch from Git Bash
762
-
763
- **Solution**: Use the Windows `start` command through cmd:
764
-
765
- ```bash
766
- cmd.exe /c start "" "C:\Program Files\NordPass\NordPass.exe"
767
- ```
768
-
769
- Or access the web vault:
770
-
771
- ```bash
772
- cmd.exe /c start https://app.nordpass.com
773
- ```
774
-
775
- ---
776
-
777
- ## Post-Installation Configuration
778
-
779
- ### First-Time Setup
780
-
781
- After installing and launching NordPass on any platform:
782
-
783
- 1. **Sign in or create account** - Log in with your NordPass account or create a new one
784
- 2. **Set master password** - Create a strong master password (this is the only password you need to remember)
785
- 3. **Install browser extension** - NordPass prompts you to install the browser extension for autofill functionality
786
- 4. **Import existing passwords** - Import from browsers, CSV files, or other password managers via Settings > Import
787
-
788
- ### Browser Extension Installation
789
-
790
- For the best experience, install the NordPass browser extension:
791
-
792
- - **Chrome/Chromium**: https://chrome.google.com/webstore/detail/nordpass-password-manager/fooolghllnmhmmndgjiamiiodkpenpbb
793
- - **Firefox**: https://addons.mozilla.org/en-US/firefox/addon/nordpass-password-manager-b2b/
794
- - **Edge**: https://microsoftedge.microsoft.com/addons/detail/nordpass-password-manage/njgnlkhcjgmjfnfahjgppcefghdkflml
795
- - **Safari**: Available in the Mac App Store
796
- - **Brave/Opera**: Use the Chrome Web Store link
797
-
798
- The browser extension can work **with or without** the desktop application. The standalone extension provides full functionality.
799
-
800
- ### Enabling Autofill
801
-
802
- To enable autofill in the browser extension:
803
-
804
- 1. Click the NordPass extension icon in your browser
805
- 2. Log in to your account
806
- 3. Navigate to Settings > Autofill
807
- 4. Enable "Autofill passwords" and "Autosave passwords"
808
-
809
- ### Configuring Two-Factor Authentication
810
-
811
- For enhanced security, enable 2FA on your NordPass account:
812
-
813
- 1. Log in to NordPass
814
- 2. Go to Settings > Security
815
- 3. Enable Two-Factor Authentication
816
- 4. Choose your 2FA method (authenticator app recommended)
817
-
818
- ---
819
-
820
- ## Common Issues
821
-
822
- ### Issue: Cannot Connect to NordPass Servers
823
-
824
- **Symptoms**: Login fails, sync does not work, or "Unable to connect" errors appear.
825
-
826
- **Solutions**:
827
-
828
- 1. Check your internet connection
829
- 2. Verify NordPass services are operational (check https://nordpass.com/status/ if available)
830
- 3. Check if a firewall or proxy is blocking the connection
831
- 4. Try accessing https://app.nordpass.com in a browser to isolate the issue
832
- 5. Restart the NordPass application
833
-
834
- ### Issue: Browser Extension Not Detecting Desktop App
835
-
836
- **Symptoms**: The browser extension shows "Desktop app not found" or autofill does not work.
837
-
838
- **Solutions**:
839
-
840
- 1. Ensure the desktop app is running
841
- 2. Restart your browser after installing the desktop app
842
- 3. Reinstall the browser extension
843
- 4. Check that both the extension and app are logged into the same account
844
-
845
- ### Issue: Passwords Not Syncing Across Devices
846
-
847
- **Symptoms**: Passwords saved on one device do not appear on another.
848
-
849
- **Solutions**:
850
-
851
- 1. Ensure you are logged into the same NordPass account on all devices
852
- 2. Check internet connectivity on both devices
853
- 3. Force sync: Go to Settings > Sync and trigger a manual sync
854
- 4. Log out and log back in to refresh the vault
855
-
856
- ### Issue: Master Password Forgotten
857
-
858
- **Symptoms**: Cannot access the vault due to forgotten master password.
859
-
860
- **Solutions**:
861
-
862
- 1. Use the NordPass recovery key if you set one up during account creation
863
- 2. Contact NordPass support at https://support.nordpass.com/
864
- 3. **Note**: Due to zero-knowledge architecture, NordPass cannot recover your master password. If you have no recovery key, vault data may be lost.
865
-
866
- ### Issue: High CPU or Memory Usage
867
-
868
- **Symptoms**: NordPass consumes excessive system resources.
869
-
870
- **Solutions**:
871
-
872
- On Linux:
873
- ```bash
874
- # Restart NordPass
875
- snap restart nordpass
876
- ```
877
-
878
- On macOS:
879
- ```bash
880
- killall NordPass
881
- open -a NordPass
882
- ```
883
-
884
- On Windows:
885
- ```powershell
886
- taskkill /IM NordPass.exe /F
887
- start "" "C:\Program Files\NordPass\NordPass.exe"
888
- ```
889
-
890
- ### Issue: Import Fails or Data Missing After Import
891
-
892
- **Symptoms**: Importing passwords from CSV or other sources fails or results in missing data.
893
-
894
- **Solutions**:
895
-
896
- 1. Ensure the CSV format matches NordPass requirements (check the import template)
897
- 2. For Flatpak installations on Linux, there may be sandbox restrictions affecting file access
898
- 3. Try importing via the web vault at https://app.nordpass.com instead
899
- 4. Export/import one password manager at a time to identify compatibility issues
900
-
901
- ---
902
-
903
- ## References
904
-
905
- - [NordPass Official Website](https://nordpass.com/)
906
- - [NordPass Download Page](https://nordpass.com/download/)
907
- - [NordPass for macOS](https://nordpass.com/download/macos/)
908
- - [NordPass for Windows](https://nordpass.com/download/windows/)
909
- - [NordPass for Linux](https://nordpass.com/download/linux/)
910
- - [NordPass Support Center](https://support.nordpass.com/)
911
- - [Installing NordPass on macOS (Official Guide)](https://support.nordpass.com/hc/en-us/articles/40177058357265-Installing-NordPass-desktop-application-on-macOS)
912
- - [Installing NordPass on Windows (Official Guide)](https://support.nordpass.com/hc/en-us/articles/360004799257-Installing-NordPass-desktop-application-on-Windows)
913
- - [Installing NordPass on Linux (Official Guide)](https://support.nordpass.com/hc/en-us/articles/40176839614225-Installing-NordPass-desktop-application-on-Linux)
914
- - [NordPass Homebrew Cask](https://formulae.brew.sh/cask/nordpass)
915
- - [NordPass Chocolatey Package](https://community.chocolatey.org/packages/nordpass)
916
- - [NordPass Snap Package](https://snapcraft.io/nordpass)
917
- - [NordPass Flatpak Package](https://flathub.org/apps/com.nordpass.NordPass)
918
- - [NordPass Chrome Extension](https://chrome.google.com/webstore/detail/nordpass-password-manager/fooolghllnmhmmndgjiamiiodkpenpbb)
919
- - [NordPass Firefox Extension](https://addons.mozilla.org/en-US/firefox/addon/nordpass-password-manager-b2b/)
920
- - [NordPass Web Vault](https://app.nordpass.com/)
921
- - [NordPass Standalone Extension FAQ](https://support.nordpass.com/hc/en-us/articles/18185360038289-NordPass-standalone-extension-FAQ)