https://workyoucanexplain.com/tags/software-installation/ Recent content in Software Installation on Work You Can Explain Hugo en-US Copyright © Work You Can Explain Mon, 24 Aug 2026 00:00:00 -0500 https://workyoucanexplain.com/posts/semester-start-readiness-audit-and-tool-check/ Mon, 24 Aug 2026 00:00:00 -0500 https://workyoucanexplain.com/posts/semester-start-readiness-audit-and-tool-check/ <p>Run a short readiness audit before the first day of a course. Check access, source materials, required tools and accounts, submission locations, and a recovery or support route. Record evidence and mark unknowns. Do not install everything that looks useful; install or configure only what the course evidence requires.</p> <h2 id="why-this-matters">Why this matters</h2> <p>The first deadline is a poor time to discover that a student cannot access the LMS, does not have a required compiler, has no writable course folder, or cannot recover an account. A readiness audit turns a vague feeling of preparedness into a starting-state record.</p> https://workyoucanexplain.com/posts/build-a-reproducible-macos-setup/ Thu, 30 Jul 2026 00:00:00 -0500 https://workyoucanexplain.com/posts/build-a-reproducible-macos-setup/ <p>A reproducible Mac setup is a small, tested description of required capability. It is not a copy of every installed app or a script that overwrites an unknown machine. Record one course environment with a reviewed Brewfile, documented configuration sources, cautious bootstrap steps, and read-only verification.</p> <p>Begin only after the current environment works and you can explain its parts. If it does not, first <a href="https://workyoucanexplain.com/posts/set-up-git-ssh-and-course-toolchains-on-macos/">complete one course-bounded Mac environment</a> rather than encoding an unverified setup.</p> https://workyoucanexplain.com/posts/choose-a-linux-distribution-for-college/ Thu, 30 Jul 2026 00:00:00 -0500 https://workyoucanexplain.com/posts/choose-a-linux-distribution-for-college/ <p>Choose a Linux distribution by constraints, not by popularity. Start with the distribution and version your course supports. Then check your hardware, the release&rsquo;s remaining support, the quality of official documentation, the package formats your course expects, and your recovery plan.</p> <p>If the course names a distribution, use that unless the instructor approves an alternative. Compatibility with grading scripts, lab instructions, and teaching-assistant support matters more than a small preference in desktop appearance.</p> https://workyoucanexplain.com/posts/install-and-update-linux-packages-deliberately/ Thu, 30 Jul 2026 00:00:00 -0500 https://workyoucanexplain.com/posts/install-and-update-linux-packages-deliberately/ <p>Use the package manager documented for your distribution. Inspect the package, repository, version, dependencies, and proposed transaction before approving a change. Then verify both the package database and the tool itself.</p> <p>There is no universal Linux install command. Debian and Ubuntu use APT for packages from configured Debian-style repositories. Fedora and current RHEL-family systems use DNF, with current Fedora releases using DNF5. Arch uses <code>pacman</code>; openSUSE uses Zypper; image-based systems can use a different model. Do not translate commands by replacing one program name.</p> https://workyoucanexplain.com/posts/install-and-verify-xcode-command-line-tools/ Thu, 30 Jul 2026 00:00:00 -0500 https://workyoucanexplain.com/posts/install-and-verify-xcode-command-line-tools/ <p>Install the smallest Apple developer environment that satisfies the course. The standalone Command Line Tools package is usually enough when a course needs UNIX tools, Git, Clang, or a Homebrew prerequisite but does not require the Xcode application, Apple-platform SDK workflows, simulators, or an Xcode project. Verify what is active instead of treating a successful installer dialog as the result.</p> <p>If you arrived here because Homebrew requested developer tools, preserve the installer message and first review the <a href="https://workyoucanexplain.com/posts/install-mac-apps-with-the-app-store-and-homebrew/">App Store and Homebrew responsibility boundary</a>. This article installs only Apple&rsquo;s developer base; it does not install Homebrew.</p> https://workyoucanexplain.com/posts/install-mac-apps-with-the-app-store-and-homebrew/ Thu, 30 Jul 2026 00:00:00 -0500 https://workyoucanexplain.com/posts/install-mac-apps-with-the-app-store-and-homebrew/ <p>Give each installed item one primary owner. Use the App Store for an app when its Apple Account purchase history and App Store updates fit the requirement. Use Homebrew for an approved command-line tool, formula, or cask when explicit package identity and terminal-based maintenance are useful. Do not manage the same app casually through both.</p> <p>The installer is part of the tool&rsquo;s future maintenance. Before installing, name the source, package identity, update path, removal path, required privileges, and course constraint.</p> https://workyoucanexplain.com/posts/set-up-git-ssh-and-course-toolchains-on-linux/ Thu, 30 Jul 2026 00:00:00 -0500 https://workyoucanexplain.com/posts/set-up-git-ssh-and-course-toolchains-on-linux/ <p>Set up only the environment one course requires. Record the supported Linux distribution, exact tools and versions, repository host, authentication method, project location, and verification command. Then install through the distribution&rsquo;s supported package path and prove the environment with a disposable practice project.</p> <p>Do not install every language, copy a classmate&rsquo;s dotfiles, or create an SSH key before checking whether the course uses SSH at all.</p> <h2 id="write-the-requirement-sheet">Write the requirement sheet</h2> <p>Ask the syllabus, instructor, or official course environment:</p> https://workyoucanexplain.com/posts/set-up-git-ssh-and-course-toolchains-on-macos/ Thu, 30 Jul 2026 00:00:00 -0500 https://workyoucanexplain.com/posts/set-up-git-ssh-and-course-toolchains-on-macos/ <p>Build one course environment, not a collection of every developer tool you may use in college. Start with current course instructions, verify the Apple developer base, configure Git identity deliberately, add SSH only when the remote service or course requires it, and isolate project dependencies through the course&rsquo;s documented method.</p> <p>Keep passwords, private SSH keys, access tokens, recovery codes, and private repository addresses out of setup notes and screenshots.</p> <p>If Apple&rsquo;s developer base has not been inspected, first <a href="https://workyoucanexplain.com/posts/install-and-verify-xcode-command-line-tools/">install or verify Xcode Command Line Tools</a>. Do not let an automatic developer-tools prompt become an unexplained side effect of the Git setup.</p> https://workyoucanexplain.com/posts/editor-language-runtime-compiler-and-package-manager-explained/ Fri, 24 Jul 2026 00:00:00 -0500 https://workyoucanexplain.com/posts/editor-language-runtime-compiler-and-package-manager-explained/ <p>A programming environment is a collection of parts, not one application. The editor changes source files. The language defines how source is written. A compiler or interpreter processes it. A runtime supports execution. A package manager handles external code. Linters, formatters, debuggers, and test runners check or inspect different aspects of the work.</p> <p>When you name the parts, an error becomes easier to locate.</p> <h2 id="the-editor-changes-files">The editor changes files</h2> <p>An editor lets you create and modify source code. It may also show project files, open a terminal, run extensions, and call other tools.</p> https://workyoucanexplain.com/posts/install-only-what-the-course-requires/ Fri, 24 Jul 2026 00:00:00 -0500 https://workyoucanexplain.com/posts/install-only-what-the-course-requires/ <p>Install the smallest environment that satisfies the course&rsquo;s documented requirements. Match required versions, keep project dependencies isolated when the ecosystem supports it, retain dependency records, and document how you verified the installation.</p> <p>More tools do not create a more capable beginner environment. They create more possible sources of version and path conflicts.</p> <h2 id="start-with-course-evidence">Start with course evidence</h2> <p>Before downloading anything, collect:</p> <ul> <li>the syllabus and current assignment instructions;</li> <li>an instructor-provided setup guide;</li> <li>the starter project&rsquo;s README and configuration files;</li> <li>required language and tool versions;</li> <li>supported operating systems;</li> <li>required editor or IDE, if any;</li> <li>dependency installation commands; and</li> <li>the exact command used to run or test the first exercise.</li> </ul> <p>Treat a classmate&rsquo;s setup, an old video, and an AI-generated list as leads, not authority. They may describe another semester or operating system.</p> https://workyoucanexplain.com/posts/install-your-first-developer-tools-with-winget/ Fri, 24 Jul 2026 00:00:00 -0500 https://workyoucanexplain.com/posts/install-your-first-developer-tools-with-winget/ <p>Use WinGet as an inspectable installer, not a shortcut around course or device policy. Search for a tool, inspect the exact package ID, publisher, source, and version, install one approved package, then verify both WinGet&rsquo;s record and the tool itself.</p> <h2 id="check-availability-and-constraints">Check availability and constraints</h2> <p>In a standard PowerShell session:</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>winget --version </span></span><span style="display:flex;"><span>winget --help </span></span></code></pre></div><p>WinGet availability depends on Windows, App Installer, organization policy, and device management. A school may block sources, installations, Store access, or administrator elevation. Do not bypass those controls. Ask institutional IT or the instructor when a required tool is unavailable.</p> https://workyoucanexplain.com/posts/the-small-cli-toolkit-worth-learning/ Fri, 24 Jul 2026 00:00:00 -0500 https://workyoucanexplain.com/posts/the-small-cli-toolkit-worth-learning/ <p>You do not need dozens of command-line tools. Recognize a small set, then learn each one when a real course or project creates the need.</p> <p>Git, SSH, curl, ripgrep, <code>find</code>, jq, and GitHub CLI cover seven useful roles: version history, remote access, data transfer, content search, file search, JSON processing, and GitHub workflows. They are a learning queue, not an installation checklist.</p> <h2 id="choose-a-problem-before-a-tool">Choose a problem before a tool</h2> <p>For each proposed tool, answer:</p>