@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,886 +0,0 @@
1
- # Installing Microsoft Teams
2
-
3
- ## Dependencies
4
-
5
- ### macOS (Homebrew)
6
- - **Required:**
7
- - `Homebrew` - Install via `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` or run `dev install homebrew`
8
- - **Optional:** None
9
- - **Auto-installed:** None
10
-
11
- ### Ubuntu (APT/Snap)
12
- - **Required:**
13
- - `wget` - Install via `sudo apt-get install -y wget`
14
- - `ca-certificates` - Install via `sudo apt-get install -y ca-certificates`
15
- - **Optional:**
16
- - `snapd` - Install via `sudo apt-get install -y snapd` (if using Snap instead of APT repository)
17
- - **Auto-installed:** None
18
-
19
- ### Raspberry Pi OS (APT/Snap)
20
- - **Required:**
21
- - `snapd` - Install via `sudo apt-get install -y snapd` (required for ARM architecture support)
22
- - **Optional:** None
23
- - **Auto-installed:** None
24
-
25
- ### Amazon Linux (DNF/YUM)
26
- - **Required:**
27
- - `curl` - Install via `sudo dnf install -y curl` (Amazon Linux 2023/RHEL 8+) or `sudo yum install -y curl` (Amazon Linux 2)
28
- - Either `dnf` or `yum` package manager (pre-installed on supported distributions)
29
- - **Optional:** None
30
- - **Auto-installed:** None
31
-
32
- ### Windows (Chocolatey/winget)
33
- - **Required:**
34
- - `Chocolatey` - Install via PowerShell: `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'))`
35
- - **Optional:**
36
- - `winget` - Pre-installed on Windows 11 and Windows 10 (version 1809+), can be used as alternative to Chocolatey
37
- - **Auto-installed:**
38
- - `App Installer (MSIX)` - Required by Teams bootstrapper, typically pre-installed on Windows 10/11
39
-
40
- ### Git Bash (Manual/Portable)
41
- - **Required:**
42
- - `Chocolatey` (on Windows host) - Install via Administrator PowerShell: `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'))`
43
- - `PowerShell` - Pre-installed on Windows
44
- - **Optional:** None
45
- - **Auto-installed:** None
46
-
47
- ## Overview
48
-
49
- Microsoft Teams is a collaboration and communication platform developed by Microsoft. It provides chat, video meetings, file storage, and application integration for teams and organizations. Teams is widely used for remote work, virtual meetings, and team collaboration in business, education, and personal contexts.
50
-
51
- **Important Platform Availability Note**: Microsoft discontinued native Linux desktop applications for Teams at the end of 2022. Linux users must use either the unofficial "Teams for Linux" Electron-based client (which wraps the web application) or access Teams through a web browser. This document provides the recommended installation method for each platform.
52
-
53
- ## Prerequisites
54
-
55
- Before installing Microsoft Teams on any platform, ensure:
56
-
57
- 1. **Internet connectivity** - Required to download installation packages and use Teams services
58
- 2. **Microsoft account** - Required to sign in and use Teams (personal, work, or school account)
59
- 3. **Administrative privileges** - Required for system-wide installation on most platforms
60
- 4. **Supported browser** - For web-based access, Chrome, Edge, Firefox, or Safari
61
-
62
- ## Platform-Specific Installation
63
-
64
- ### macOS (Homebrew)
65
-
66
- #### Prerequisites
67
-
68
- - macOS 11 (Big Sur) or later
69
- - Homebrew package manager installed
70
- - At least 2 GB free disk space
71
- - Apple Silicon (M1/M2/M3/M4) or Intel processor
72
-
73
- If Homebrew is not installed, install it first:
74
-
75
- ```bash
76
- NONINTERACTIVE=1 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
77
- ```
78
-
79
- #### Installation Steps
80
-
81
- Run the following command to install Microsoft Teams:
82
-
83
- ```bash
84
- brew install --quiet --cask microsoft-teams
85
- ```
86
-
87
- The `--quiet` flag suppresses non-essential output, and `--cask` specifies the graphical application version.
88
-
89
- After installation, launch Microsoft Teams from the Applications folder or via command line:
90
-
91
- ```bash
92
- open -a "Microsoft Teams"
93
- ```
94
-
95
- **Note**: On first launch, Teams will prompt you to sign in with your Microsoft account.
96
-
97
- #### Verification
98
-
99
- Confirm the installation succeeded by checking if the application exists:
100
-
101
- ```bash
102
- ls /Applications/ | grep -i "microsoft teams"
103
- ```
104
-
105
- Expected output:
106
-
107
- ```
108
- Microsoft Teams.app
109
- ```
110
-
111
- Verify Teams can launch:
112
-
113
- ```bash
114
- open -a "Microsoft Teams"
115
- ```
116
-
117
- #### Troubleshooting
118
-
119
- **Problem**: `Error: Cask microsoft-teams requires macOS >= 11`
120
-
121
- **Solution**: Your macOS version is too old. Microsoft Teams requires macOS 11 (Big Sur) or later. Upgrade your operating system before installing.
122
-
123
- **Problem**: "Microsoft Teams is damaged and can't be opened" error
124
-
125
- **Solution**: Clear the quarantine attribute:
126
-
127
- ```bash
128
- xattr -cr "/Applications/Microsoft Teams.app"
129
- ```
130
-
131
- **Problem**: Classic Teams version needed
132
-
133
- **Solution**: If you need the older classic version of Teams (version 1.x), install it with:
134
-
135
- ```bash
136
- brew install --quiet --cask microsoft-teams@classic
137
- ```
138
-
139
- **Problem**: Teams fails to start after macOS Sequoia upgrade
140
-
141
- **Solution**: Reinstall Teams:
142
-
143
- ```bash
144
- brew uninstall --cask microsoft-teams
145
- brew install --quiet --cask microsoft-teams
146
- ```
147
-
148
- ---
149
-
150
- ### Ubuntu/Debian (APT)
151
-
152
- #### Platform Limitation
153
-
154
- **Microsoft Teams is not available natively on Linux.** Microsoft discontinued the official Linux desktop client at the end of 2022. The recommended solution is the unofficial "Teams for Linux" Electron-based client, which wraps the Teams web application in a desktop wrapper with system integration.
155
-
156
- #### Prerequisites
157
-
158
- - Ubuntu 20.04, 22.04, 24.04 or later, or Debian 11, 12 or later (64-bit)
159
- - sudo privileges
160
- - At least 1 GB free disk space
161
-
162
- #### Installation Steps
163
-
164
- **Step 1: Add the Teams for Linux repository**
165
-
166
- ```bash
167
- sudo mkdir -p /etc/apt/keyrings
168
- sudo wget -qO /etc/apt/keyrings/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc
169
- ```
170
-
171
- **Step 2: Add the repository source**
172
-
173
- ```bash
174
- echo "Types: deb
175
- URIs: https://repo.teamsforlinux.de/debian/
176
- Suites: stable
177
- Components: main
178
- Signed-By: /etc/apt/keyrings/teams-for-linux.asc
179
- Architectures: amd64" | sudo tee /etc/apt/sources.list.d/teams-for-linux-packages.sources > /dev/null
180
- ```
181
-
182
- **Step 3: Update package lists and install**
183
-
184
- ```bash
185
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
186
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y teams-for-linux
187
- ```
188
-
189
- **Alternative: Install via Snap**
190
-
191
- If you prefer Snap packages or need ARM architecture support:
192
-
193
- ```bash
194
- sudo snap install teams-for-linux
195
- ```
196
-
197
- The Snap version supports amd64, arm64, and armhf architectures.
198
-
199
- #### Verification
200
-
201
- Confirm the installation succeeded:
202
-
203
- ```bash
204
- teams-for-linux --version
205
- ```
206
-
207
- Or check if the package is installed:
208
-
209
- ```bash
210
- dpkg -l | grep teams-for-linux
211
- ```
212
-
213
- Launch Teams:
214
-
215
- ```bash
216
- teams-for-linux &
217
- ```
218
-
219
- #### Troubleshooting
220
-
221
- **Problem**: GPG key import fails
222
-
223
- **Solution**: Ensure wget is installed and try again:
224
-
225
- ```bash
226
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wget ca-certificates
227
- sudo wget -qO /etc/apt/keyrings/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc
228
- ```
229
-
230
- **Problem**: Package not found after adding repository
231
-
232
- **Solution**: Verify the repository file was created correctly:
233
-
234
- ```bash
235
- cat /etc/apt/sources.list.d/teams-for-linux-packages.sources
236
- ```
237
-
238
- If empty or malformed, recreate it using the commands in Step 2.
239
-
240
- **Problem**: Application crashes or white screen
241
-
242
- **Solution**: Try running with GPU acceleration disabled:
243
-
244
- ```bash
245
- teams-for-linux --disable-gpu
246
- ```
247
-
248
- **Problem**: Screen sharing does not work
249
-
250
- **Solution**: On Wayland sessions, screen sharing may be limited. Switch to X11 session for full screen sharing support, or use Pipewire for Wayland screen sharing.
251
-
252
- ---
253
-
254
- ### Raspberry Pi OS (APT)
255
-
256
- #### Platform Limitation
257
-
258
- **Microsoft Teams does not have an official ARM client.** The unofficial "Teams for Linux" Snap package supports ARM architectures (arm64 and armhf). The APT repository only provides amd64 packages.
259
-
260
- #### Prerequisites
261
-
262
- - Raspberry Pi OS (64-bit recommended) - Bookworm or Bullseye
263
- - Raspberry Pi 3B+ or later (arm64 or armhf architecture)
264
- - At least 2 GB RAM (4 GB recommended for video calls)
265
- - sudo privileges
266
- - snapd installed
267
-
268
- #### Installation Steps
269
-
270
- **Step 1: Ensure snapd is installed**
271
-
272
- ```bash
273
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
274
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
275
- ```
276
-
277
- **Step 2: Reboot to complete snapd installation (if newly installed)**
278
-
279
- ```bash
280
- sudo reboot
281
- ```
282
-
283
- **Step 3: Install Teams for Linux via Snap**
284
-
285
- ```bash
286
- sudo snap install teams-for-linux
287
- ```
288
-
289
- The Snap package includes arm64 and armhf support, making it suitable for Raspberry Pi.
290
-
291
- **Alternative: Use the Web Application**
292
-
293
- For better performance on lower-spec Raspberry Pi models, use Microsoft Teams in a browser:
294
-
295
- ```bash
296
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y chromium-browser
297
- chromium-browser --app=https://teams.microsoft.com &
298
- ```
299
-
300
- #### Verification
301
-
302
- Confirm the installation succeeded:
303
-
304
- ```bash
305
- snap list | grep teams-for-linux
306
- ```
307
-
308
- Expected output (version may vary):
309
-
310
- ```
311
- teams-for-linux 2.6.18 234 latest/stable nicoh88 -
312
- ```
313
-
314
- Launch Teams:
315
-
316
- ```bash
317
- teams-for-linux &
318
- ```
319
-
320
- #### Troubleshooting
321
-
322
- **Problem**: Snap installation fails with "snap not found"
323
-
324
- **Solution**: Install and configure snapd:
325
-
326
- ```bash
327
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
328
- sudo systemctl enable --now snapd.socket
329
- sudo ln -sf /snap /var/lib/snapd/snap
330
- sudo reboot
331
- ```
332
-
333
- After reboot, retry the installation.
334
-
335
- **Problem**: Teams is very slow or video calls lag
336
-
337
- **Solution**: Raspberry Pi has limited resources. For better performance:
338
- - Use a Raspberry Pi 4 or 5 with at least 4 GB RAM
339
- - Close other applications during video calls
340
- - Use the web version in Chromium with hardware acceleration:
341
-
342
- ```bash
343
- chromium-browser --enable-features=VaapiVideoDecoder --app=https://teams.microsoft.com
344
- ```
345
-
346
- **Problem**: Camera or microphone not detected
347
-
348
- **Solution**: Ensure your user is in the video and audio groups:
349
-
350
- ```bash
351
- sudo usermod -aG video,audio $USER
352
- ```
353
-
354
- Log out and log back in for changes to take effect.
355
-
356
- **Problem**: Screen sharing not available
357
-
358
- **Solution**: Screen sharing on ARM devices has limited support. Use the web version in Chromium for better screen sharing compatibility.
359
-
360
- ---
361
-
362
- ### Amazon Linux/RHEL (DNF/YUM)
363
-
364
- #### Platform Limitation
365
-
366
- **Microsoft Teams is not available natively on Linux.** Use the unofficial "Teams for Linux" Electron-based client via the dedicated RPM repository.
367
-
368
- #### Prerequisites
369
-
370
- - Amazon Linux 2023, Amazon Linux 2, RHEL 8, RHEL 9, or Fedora
371
- - sudo privileges
372
- - At least 1 GB free disk space
373
-
374
- #### Installation Steps
375
-
376
- **For Amazon Linux 2023, RHEL 8/9, and Fedora:**
377
-
378
- **Step 1: Import the GPG key**
379
-
380
- ```bash
381
- curl -1sLf -o /tmp/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc
382
- sudo rpm --import /tmp/teams-for-linux.asc
383
- ```
384
-
385
- **Step 2: Add the repository**
386
-
387
- ```bash
388
- sudo curl -1sLf -o /etc/yum.repos.d/teams-for-linux.repo https://repo.teamsforlinux.de/rpm/teams-for-linux.repo
389
- ```
390
-
391
- **Step 3: Install Teams for Linux**
392
-
393
- ```bash
394
- sudo dnf install -y teams-for-linux
395
- ```
396
-
397
- **For Amazon Linux 2 (uses yum):**
398
-
399
- ```bash
400
- curl -1sLf -o /tmp/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc
401
- sudo rpm --import /tmp/teams-for-linux.asc
402
- sudo curl -1sLf -o /etc/yum.repos.d/teams-for-linux.repo https://repo.teamsforlinux.de/rpm/teams-for-linux.repo
403
- sudo yum install -y teams-for-linux
404
- ```
405
-
406
- **Note for EC2 Instances**: If running on a headless EC2 instance without a GUI, Microsoft Teams cannot be used directly. Consider:
407
- - Using the Microsoft Graph API for automated Teams operations
408
- - Accessing Teams via a browser on a workstation that connects to the EC2 instance
409
-
410
- #### Verification
411
-
412
- Confirm the installation succeeded:
413
-
414
- ```bash
415
- teams-for-linux --version
416
- ```
417
-
418
- Or check if the package is installed:
419
-
420
- ```bash
421
- rpm -qa | grep teams-for-linux
422
- ```
423
-
424
- Launch Teams:
425
-
426
- ```bash
427
- teams-for-linux &
428
- ```
429
-
430
- #### Troubleshooting
431
-
432
- **Problem**: GPG key import fails
433
-
434
- **Solution**: Ensure curl is installed:
435
-
436
- ```bash
437
- sudo dnf install -y curl
438
- ```
439
-
440
- Then retry the GPG key import.
441
-
442
- **Problem**: Repository not found
443
-
444
- **Solution**: Verify the repository file exists and is correct:
445
-
446
- ```bash
447
- cat /etc/yum.repos.d/teams-for-linux.repo
448
- ```
449
-
450
- If missing, recreate it using the commands in Step 2.
451
-
452
- **Problem**: Dependency conflicts
453
-
454
- **Solution**: Update system packages first:
455
-
456
- ```bash
457
- sudo dnf update -y
458
- sudo dnf install -y teams-for-linux
459
- ```
460
-
461
- **Problem**: Application won't start on headless server
462
-
463
- **Solution**: Teams requires a graphical environment. For headless servers, use the Microsoft Teams web application through a browser on a machine with GUI access, or use Microsoft Graph API for programmatic access.
464
-
465
- ---
466
-
467
- ### Windows (Chocolatey/winget)
468
-
469
- #### Prerequisites
470
-
471
- - Windows 10 version 20H1 (10.0.19041) or later, or Windows 11
472
- - At least 2 GB RAM and 3 GB free disk space
473
- - Administrator PowerShell or Command Prompt
474
- - Microsoft account (personal, work, or school)
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
- **Using Chocolatey (Recommended):**
485
-
486
- Run the following command in an Administrator PowerShell or Command Prompt:
487
-
488
- ```powershell
489
- choco install microsoft-teams-new-bootstrapper -y
490
- ```
491
-
492
- The `-y` flag automatically confirms all prompts, enabling fully non-interactive installation.
493
-
494
- This installs the new Microsoft Teams client (version 2.x) using the official Microsoft bootstrapper, which downloads and installs the latest Teams MSIX package. Teams is self-updating after installation.
495
-
496
- **Alternative Using winget:**
497
-
498
- ```powershell
499
- winget install --id Microsoft.Teams --silent --accept-package-agreements --accept-source-agreements
500
- ```
501
-
502
- The flags ensure non-interactive installation:
503
- - `--silent` suppresses the installer UI
504
- - `--accept-package-agreements` auto-accepts license agreements
505
- - `--accept-source-agreements` accepts source repository terms
506
-
507
- **Note**: After installation, launch Teams and sign in with your Microsoft account.
508
-
509
- #### Verification
510
-
511
- Open a new Command Prompt or PowerShell window, then verify the installation:
512
-
513
- ```powershell
514
- winget list --id Microsoft.Teams
515
- ```
516
-
517
- Or check for the Teams executable:
518
-
519
- ```powershell
520
- Get-Command ms-teams -ErrorAction SilentlyContinue
521
- ```
522
-
523
- Launch Teams:
524
-
525
- ```powershell
526
- Start-Process ms-teams:
527
- ```
528
-
529
- Or from the Start Menu, search for "Microsoft Teams" and launch it.
530
-
531
- #### Troubleshooting
532
-
533
- **Problem**: "Package not found" error with Chocolatey
534
-
535
- **Solution**: Update Chocolatey sources and retry:
536
-
537
- ```powershell
538
- choco upgrade chocolatey -y
539
- choco install microsoft-teams-new-bootstrapper -y
540
- ```
541
-
542
- **Problem**: Installation fails with "App Installer" error
543
-
544
- **Solution**: The Teams bootstrapper requires App Installer (MSIX). Update App Installer from the Microsoft Store or run:
545
-
546
- ```powershell
547
- winget install --id Microsoft.AppInstaller --silent --accept-package-agreements --accept-source-agreements
548
- ```
549
-
550
- **Problem**: Teams shows "classic" version instead of new client
551
-
552
- **Solution**: The new Teams client may need to be enabled by your IT administrator for work/school accounts. For personal use, ensure you installed the new bootstrapper, not the classic package.
553
-
554
- **Problem**: Cannot sign in with work/school account
555
-
556
- **Solution**: Your organization may have specific Teams deployment policies. Contact your IT administrator to verify Teams access.
557
-
558
- **Problem**: Teams does not start after installation
559
-
560
- **Solution**: Restart your computer and try launching Teams again:
561
-
562
- ```powershell
563
- Restart-Computer -Force
564
- ```
565
-
566
- ---
567
-
568
- ### WSL (Ubuntu)
569
-
570
- #### Platform Limitation
571
-
572
- **Microsoft Teams cannot be installed within WSL (Windows Subsystem for Linux).** WSL runs a Linux environment, and while Teams for Linux could theoretically run in WSL with WSLg (graphical support), the recommended approach is to install Teams on the Windows host.
573
-
574
- #### Prerequisites
575
-
576
- - Windows 10 version 2004 or higher, or Windows 11
577
- - WSL 2 enabled with Ubuntu distribution installed
578
- - Administrator access on Windows for installation
579
-
580
- #### Recommended Approach
581
-
582
- Install Microsoft Teams on the Windows host and access it from WSL by launching the Windows executable.
583
-
584
- **Step 1: Install Microsoft Teams on Windows**
585
-
586
- From a Windows Administrator PowerShell:
587
-
588
- ```powershell
589
- choco install microsoft-teams-new-bootstrapper -y
590
- ```
591
-
592
- **Step 2: Access Teams from WSL**
593
-
594
- From within your WSL terminal, you can launch Windows Teams:
595
-
596
- ```bash
597
- # Launch Microsoft Teams from WSL
598
- /mnt/c/Users/$(cmd.exe /c "echo %USERNAME%" 2>/dev/null | tr -d '\r')/AppData/Local/Microsoft/WindowsApps/ms-teams.exe &
599
- ```
600
-
601
- Or use the simpler approach with the PATH:
602
-
603
- ```bash
604
- cmd.exe /c start ms-teams:
605
- ```
606
-
607
- **Alternative: Install Teams for Linux in WSL with WSLg**
608
-
609
- If you have WSLg (Windows Subsystem for Linux GUI) enabled, you can install Teams for Linux:
610
-
611
- ```bash
612
- sudo snap install teams-for-linux
613
- teams-for-linux &
614
- ```
615
-
616
- Note: This requires WSL 2 with WSLg support (Windows 11 or Windows 10 with KB5020030).
617
-
618
- #### Verification
619
-
620
- From WSL, verify you can access Windows Teams:
621
-
622
- ```bash
623
- cmd.exe /c "where ms-teams" 2>/dev/null
624
- ```
625
-
626
- Or verify the Teams for Linux Snap (if installed in WSL):
627
-
628
- ```bash
629
- snap list | grep teams-for-linux
630
- ```
631
-
632
- #### Troubleshooting
633
-
634
- **Problem**: Cannot launch Windows Teams from WSL
635
-
636
- **Solution**: Ensure Teams is installed on Windows and try the direct command:
637
-
638
- ```bash
639
- cmd.exe /c start ms-teams:
640
- ```
641
-
642
- **Problem**: Teams for Linux Snap fails in WSL
643
-
644
- **Solution**: WSLg may not be enabled or working correctly. Check WSLg status:
645
-
646
- ```bash
647
- ls /mnt/wslg
648
- ```
649
-
650
- If the directory does not exist or is empty, WSLg is not available. Update to Windows 11 or a recent Windows 10 build with WSLg support.
651
-
652
- **Problem**: Audio/video not working in Teams for Linux on WSL
653
-
654
- **Solution**: WSLg audio support can be inconsistent. Use Windows Teams for meetings with audio/video.
655
-
656
- ---
657
-
658
- ### Git Bash (Windows Installation)
659
-
660
- #### Prerequisites
661
-
662
- - Windows 10 or Windows 11 (64-bit)
663
- - Git Bash installed (comes with Git for Windows)
664
- - Administrator access for installation
665
-
666
- #### Installation Steps
667
-
668
- Git Bash runs on Windows, so Microsoft Teams is installed on the Windows host and accessible from Git Bash.
669
-
670
- **Step 1: Install Microsoft Teams on Windows**
671
-
672
- From an Administrator Command Prompt or PowerShell (not Git Bash):
673
-
674
- ```powershell
675
- choco install microsoft-teams-new-bootstrapper -y
676
- ```
677
-
678
- **Step 2: Restart your computer if prompted**
679
-
680
- **Step 3: Access Teams from Git Bash**
681
-
682
- After installation, Teams can be launched from Git Bash:
683
-
684
- ```bash
685
- start ms-teams:
686
- ```
687
-
688
- Or use the explicit path:
689
-
690
- ```bash
691
- cmd //c "start ms-teams:"
692
- ```
693
-
694
- #### Verification
695
-
696
- From Git Bash, verify Teams can be launched:
697
-
698
- ```bash
699
- start ms-teams:
700
- ```
701
-
702
- Teams should open in a new window.
703
-
704
- #### Troubleshooting
705
-
706
- **Problem**: `start: command not found`
707
-
708
- **Solution**: Use the Windows-style command:
709
-
710
- ```bash
711
- cmd //c "start ms-teams:"
712
- ```
713
-
714
- **Problem**: Teams does not launch
715
-
716
- **Solution**: Ensure Teams is installed and restart your computer. Then try:
717
-
718
- ```bash
719
- "/c/Users/$USERNAME/AppData/Local/Microsoft/WindowsApps/ms-teams.exe" &
720
- ```
721
-
722
- **Problem**: Need to use Teams commands in scripts
723
-
724
- **Solution**: For scripting, use the Windows command wrapper:
725
-
726
- ```bash
727
- #!/bin/bash
728
- # Launch Teams silently
729
- cmd //c "start /min ms-teams:" 2>/dev/null
730
- ```
731
-
732
- ---
733
-
734
- ## Post-Installation Configuration
735
-
736
- After installing Microsoft Teams on any platform, consider these configuration steps.
737
-
738
- ### Signing In
739
-
740
- 1. Launch Microsoft Teams
741
- 2. Enter your email address (personal Microsoft account, or work/school account)
742
- 3. Follow the authentication prompts
743
- 4. Complete any organization-specific setup if using a work/school account
744
-
745
- ### Configuring Notifications
746
-
747
- Adjust notification settings to avoid interruptions:
748
-
749
- 1. Click on your profile picture in Teams
750
- 2. Go to Settings > Notifications
751
- 3. Configure notification preferences for messages, meetings, and mentions
752
-
753
- ### Setting Up Audio and Video
754
-
755
- Before your first meeting:
756
-
757
- 1. Click on your profile picture in Teams
758
- 2. Go to Settings > Devices
759
- 3. Test your speaker, microphone, and camera
760
- 4. Make a test call to verify everything works
761
-
762
- ### Enabling Dark Mode
763
-
764
- For reduced eye strain:
765
-
766
- 1. Click on your profile picture in Teams
767
- 2. Go to Settings > Appearance
768
- 3. Select "Dark" or "High contrast"
769
-
770
- ### Configuring Startup Behavior
771
-
772
- To control whether Teams starts automatically:
773
-
774
- **Windows:**
775
- 1. Go to Settings > General
776
- 2. Toggle "Auto-start application" on or off
777
-
778
- **macOS:**
779
- 1. Go to Settings > General
780
- 2. Toggle "Auto-start application" on or off
781
-
782
- **Linux (Teams for Linux):**
783
- ```bash
784
- # Disable autostart
785
- rm ~/.config/autostart/teams-for-linux.desktop 2>/dev/null || true
786
- ```
787
-
788
- ---
789
-
790
- ## Common Issues
791
-
792
- ### Issue: "Sign in loop" - Cannot Complete Sign In
793
-
794
- **Symptoms**: Teams asks you to sign in repeatedly without completing authentication
795
-
796
- **Solutions**:
797
-
798
- - Clear Teams cache:
799
-
800
- **Windows:**
801
- ```powershell
802
- Remove-Item -Path "$env:APPDATA\Microsoft\Teams\*" -Recurse -Force -ErrorAction SilentlyContinue
803
- ```
804
-
805
- **macOS:**
806
- ```bash
807
- rm -rf ~/Library/Application\ Support/Microsoft/Teams/*
808
- rm -rf ~/Library/Caches/com.microsoft.teams/*
809
- ```
810
-
811
- **Linux:**
812
- ```bash
813
- rm -rf ~/.config/teams-for-linux/*
814
- rm -rf ~/.cache/teams-for-linux/*
815
- ```
816
-
817
- ### Issue: Audio or Video Not Working in Meetings
818
-
819
- **Symptoms**: Others cannot hear you or see your video
820
-
821
- **Solutions**:
822
-
823
- - Check device permissions in your operating system settings
824
- - Verify the correct devices are selected in Teams Settings > Devices
825
- - Close other applications that might be using the camera or microphone
826
- - Restart Teams
827
-
828
- ### Issue: Screen Sharing Not Available
829
-
830
- **Symptoms**: Screen sharing option is grayed out or not working
831
-
832
- **Solutions**:
833
-
834
- - **macOS**: Grant screen recording permission in System Preferences > Security & Privacy > Privacy > Screen Recording
835
- - **Linux**: On Wayland, screen sharing may be limited. Use X11 session or ensure Pipewire is configured
836
- - **Windows**: Run Teams as administrator if sharing specific applications
837
-
838
- ### Issue: High CPU or Memory Usage
839
-
840
- **Symptoms**: Teams consumes excessive system resources
841
-
842
- **Solutions**:
843
-
844
- - Disable GPU hardware acceleration in Settings > General (if experiencing issues)
845
- - Close unused chats and channels
846
- - Restart Teams periodically
847
- - Update to the latest version
848
-
849
- ### Issue: Notifications Not Working
850
-
851
- **Symptoms**: Missing notifications for messages or calls
852
-
853
- **Solutions**:
854
-
855
- - Check notification settings in Teams and operating system
856
- - Ensure "Do Not Disturb" mode is not enabled
857
- - Verify Teams is allowed to send notifications in OS settings
858
-
859
- ---
860
-
861
- ## Summary Table
862
-
863
- | Platform | Native Support | Installation Method | Notes |
864
- |----------|---------------|---------------------|-------|
865
- | macOS | Yes | `brew install --quiet --cask microsoft-teams` | Requires macOS 11+ |
866
- | Windows | Yes | `choco install microsoft-teams-new-bootstrapper -y` | Primary supported platform |
867
- | Ubuntu/Debian | No (unofficial) | APT repo or `sudo snap install teams-for-linux` | Teams for Linux (Electron wrapper) |
868
- | Raspberry Pi | No (unofficial) | `sudo snap install teams-for-linux` | Snap supports ARM64/armhf |
869
- | Amazon Linux/RHEL | No (unofficial) | RPM repository + `dnf install teams-for-linux` | Teams for Linux |
870
- | WSL | N/A | Install on Windows host | Uses Windows installation |
871
- | Git Bash | N/A | Uses Windows installation | Inherits Windows Teams |
872
-
873
- ---
874
-
875
- ## References
876
-
877
- - [Microsoft Teams Official Website](https://www.microsoft.com/en-us/microsoft-teams/group-chat-software/)
878
- - [Microsoft Teams Web Application](https://teams.microsoft.com)
879
- - [Microsoft Teams Homebrew Cask](https://formulae.brew.sh/cask/microsoft-teams)
880
- - [Microsoft Teams Classic Homebrew Cask](https://formulae.brew.sh/cask/microsoft-teams@classic)
881
- - [Microsoft Teams Chocolatey Package (New Client)](https://community.chocolatey.org/packages/microsoft-teams-new-bootstrapper)
882
- - [Microsoft Teams winget Package](https://winget.run/pkg/Microsoft/Teams)
883
- - [Teams for Linux (Unofficial Client)](https://github.com/IsmaelMartinez/teams-for-linux)
884
- - [Teams for Linux Snap Package](https://snapcraft.io/teams-for-linux)
885
- - [Teams for Linux Repository](https://repo.teamsforlinux.de/)
886
- - [winget install Command Documentation](https://learn.microsoft.com/en-us/windows/package-manager/winget/install)