> ## Content Index > Fetch the complete content index at: https://techbookshelf.com/llms.txt > Use this file to discover other available public pages before exploring further. # How to Install Deno on Mac: A Complete Step-by-Step Guide - URL: https://techbookshelf.com/install-deno-mac/ - Published: 2026-10-25T02:07:00.000Z - Updated: 2026-10-28T16:40:32.000Z - Description: Discover easy steps to install Deno on your Mac using Homebrew or manual methods for a seamless setup and management experience. - Author: Md Astafar Hossain - Tags: Software Installation, MacOS, JavaScript, Development Tools You want to explore Deno as a runtime alternative to Node.js on your Mac, but the installation process seems unclear or complicated. Whether you’re setting it up for the first time or managing updates, navigating Deno’s installation on macOS can present specific challenges. This guide covers how to install Deno on Mac using both Homebrew and manual methods, explains Deno’s architecture briefly, and walks you through updating and uninstalling it cleanly. You’ll also find solutions to common issues Mac users encounter during installation. ## Key takeaways - Homebrew is the simplest way to install and update Deno on Mac. - You can manually install Deno using a shell script if you prefer not to use package managers. - Updating Deno requires running either Homebrew update commands or the manual installer again. - Uninstalling involves removing the Deno binary and related files from your system. - Common errors often relate to permissions or PATH configuration on macOS. ## Before you start: what you need to install Deno on Mac Deno is a secure runtime for JavaScript and TypeScript designed with built-in security features that sandbox file system and network access by default. Before installing Deno on your Mac, ensure your system meets the necessary requirements to avoid installation issues. Deno supports macOS versions 10.15 (Catalina) and later. You also need Apple's Command Line Tools installed, which provide essential utilities like Git and compilers. To check if these tools are present, open Terminal and run **git --version**. If not installed, the system will prompt you to install them. Installation requires administrator privileges because the runtime is typically installed in system directories. Make sure your user account has these rights. Additionally, network access is needed to download installation files from official sources. There are several ways to install Deno on Mac: via Homebrew for speed and convenience, using the shell script installer for a straightforward method, or manually downloading the binary for full control. Homebrew is generally faster and integrates well with macOS, while manual installation offers flexibility but requires more steps. ## How to install Deno on macOS using Homebrew 1. Open the Terminal app on your Mac. If you don't have Homebrew installed, check by typing **brew --version**. If you see a version number, Homebrew is ready; if not, proceed to the next step. 2. Install Homebrew by entering the following command: `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` You will see download progress and installation messages. Once complete, Homebrew will be ready to use. 3. Update Homebrew to ensure you have the latest package definitions: `brew update` You should see messages indicating the update process and its success. 4. Install Deno using Homebrew by typing: `brew install deno` The Terminal will display download and installation progress for Deno and its dependencies. 5. Verify the installation by running: `deno --version` This command outputs Deno's current version and confirms a successful install. Homebrew manages software installation by handling dependencies and placing executables in standard system locations, simplifying updates and removals. Using it for Deno ensures seamless integration with your macOS environment and easier maintenance. ## How to install Deno manually on Mac If you prefer not to use Homebrew, you can manually install Deno by downloading the official binary and configuring it yourself. This gives you direct control over the installation location and avoids dependencies on package managers. ![How to install Deno manually on Mac – how to install Deno on Mac](https://techbookshelf.com/content/images/2026/10/install-deno-mac-2.webp) 1. **Download the Deno binary:** Visit the official Deno GitHub releases page ([https://github.com/denoland/deno/releases](https://github.com/denoland/deno/releases?ref=techbookshelf.com)) and download the macOS binary (usually named `deno-x86_64-apple-darwin.zip` or similar). When the download completes, you should see the ZIP file in your Downloads folder. 2. **Extract the binary:** Double-click the ZIP file to extract the `deno` executable. Confirm the extracted file appears in the same folder. 3. **Move the binary to a directory in your PATH:** Open Terminal and move the `deno` file to a directory included in your PATH, such as `/usr/local/bin`. Use `sudo mv ~/Downloads/deno /usr/local/bin/` and enter your password when prompted. After this, `deno` should be accessible from any terminal session. 4. **Set executable permissions:** Run `sudo chmod +x /usr/local/bin/deno` to ensure the binary is executable. This step prevents permission-related errors when running Deno. 5. **Verify the installation:** Run `deno --version` in Terminal. You should see the installed Deno version and related information confirming a successful manual installation. This manual installation typically results in a smaller binary footprint and faster setup time compared to Homebrew, as it avoids additional dependencies and formula overhead. However, updating requires repeating these steps with the latest binary instead of a simple package manager command. ## How to update Deno on Mac Keeping Deno updated ensures you have access to the latest features, performance improvements, and security patches. The update process depends on how you installed Deno initially. ### Updating Deno installed via Homebrew 1. Open your Terminal and run **brew update** to refresh Homebrew’s package list. You should see a list of updated repositories or a message indicating everything is current. 2. Run **brew upgrade deno** to upgrade Deno to the latest version. The Terminal will show the progress and the new version installed. 3. Verify the update by running **deno --version**. The output should reflect the newer version number, for example, from 1.34.3 to 1.35.0. ### Updating a manual Deno installation 1. Open your Terminal and execute **deno upgrade**. This command downloads and installs the latest binary. 2. After completion, check the installed version with **deno --version** to confirm the update was successful. Major version updates, such as Deno 2.0, may introduce breaking changes affecting scripts and dependencies. For instance, Deno 2.0 removed support for certain legacy APIs, requiring code adjustments. Always review the official release notes before upgrading across major versions. ## How to uninstall Deno from your Mac Removing Deno completely depends on how you installed it. Follow the steps below to ensure all components are cleared from your system. ![How to uninstall Deno from your Mac – how to install Deno on Mac](https://techbookshelf.com/content/images/2026/10/install-deno-mac-3.webp) ### Uninstalling via Homebrew 1. Open Terminal and run **brew uninstall deno**. You should see a confirmation that Deno has been removed. 2. Verify removal by typing **deno --version**. The command should return *command not found* or similar, indicating Deno is no longer accessible. ### Removing manual binary and related files 1. Locate the Deno binary by running **which deno** in Terminal. This typically returns a path like `/usr/local/bin/deno`. 2. Remove the binary using **rm -f /usr/local/bin/deno**. Confirm no errors appear. 3. Delete Deno's configuration and cache directories, usually found at `~/.deno`, by running **rm -rf \~/.deno**. This frees up disk space and removes user data. ### Checking for leftovers and cleaning PATH 1. Ensure your shell PATH no longer includes any Deno-specific entries by inspecting `~/.zshrc`, `~/.bash_profile`, or equivalent shell config files. 2. If you find Deno-related PATH entries, remove them and reload your shell configuration with **source \~/.zshrc** or the relevant command. 3. Confirm Deno is fully uninstalled by running **deno --version** again, which should fail. Following these steps will reclaim the disk space used by Deno binaries and caches, typically a few tens of megabytes, and ensure your system is clean of any Deno components. ## Troubleshooting common installation issues on Mac During installation or update of Deno on Mac, you may encounter permission denied errors such as *"permission denied: /usr/local/bin/deno"*. This often means you need to run the command with **sudo** or adjust the file permissions with `chmod +x` on the Deno binary. If you see *"command not found: deno"*, it usually indicates an issue with your PATH environment variable. Confirm that the directory containing the Deno executable is included in your PATH by running `echo $PATH` in Terminal. Add missing paths by editing your shell profile (e.g., `~/.zshrc` or `~/.bash_profile`). Conflicts can arise if other software uses the same command name or if macOS is outdated below version 10.15\. Update macOS to a compatible version and check for conflicting binaries by running `which deno`. Some users mistakenly look for `deno.exe`, a Windows executable, which does not exist on Mac. Ensure you are using the correct Mac binary. Clarify that Deno installation issues are unrelated to casting from Mac to Denon audio devices; these are separate technologies. 1. Run `deno --version`. If you get a permission error, proceed to step 2. 2. Fix permissions: `sudo chmod +x /usr/local/bin/deno`. Then re-run `deno --version` and verify output shows the version. 3. If command not found appears, check PATH with `echo $PATH`. Ensure the Deno binary directory is listed. 4. Add to PATH if missing by editing `~/.zshrc` or `~/.bash_profile` with `export PATH=$PATH:/usr/local/bin`. 5. Restart Terminal and run `deno --version` again. You should see version info confirming installation. ## More on this topic - [How to Install.NET SDK on Mac: A Clear Step-by-Step Guide](https://techbookshelf.com/install-dotnet-sdk-mac/) - [How to Install OpenJDK on Mac: A Complete Step-by-Step Guide](https://techbookshelf.com/install-openjdk-mac/) - [How to Install Git on Mac: Step-by-Step Guide for Every Setup](https://rolloutready.com/install-git-mac/?ref=techbookshelf.com) - [How to Install Docker on Mac: A Clear Step-by-Step Guide](https://rolloutready.com/install-docker-mac/?ref=techbookshelf.com) ## Frequently asked questions ### How to install deno on windows? To install Deno on Windows, you can use the PowerShell command `iwr https://deno.land/install.ps1 -useb | iex`. Alternatively, use Chocolatey with `choco install deno` or Scoop with `scoop install deno`. After installation, verify by running `deno --version` in Command Prompt or PowerShell. ### How to install composer on mac? To install Composer on a Mac, first ensure PHP is installed. Then download the Composer installer via Terminal using `php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"`. Run `php composer-setup.php`, then move it to a directory in your PATH, such as `/usr/local/bin/composer`. Confirm installation with `composer --version`. ### Which software uses deno.exe? The file `deno.exe` is the executable for the Deno runtime on Windows systems. It is used by developers to run Deno scripts and applications as an alternative to Node.js. No other software typically uses `deno.exe` since it’s specific to the Deno runtime environment. ### How to cast from mac to denon? Casting audio from a Mac to a Denon receiver often involves using AirPlay if your Denon model supports it. On your Mac, open the Sound settings and select the Denon receiver from the output devices list. For models without AirPlay, use Bluetooth pairing or connect via HDMI or optical cable depending on your setup. ### How to uninstall deno To uninstall Deno, remove the executable by deleting `/usr/local/bin/deno` if installed via Homebrew or manual install. If you used Homebrew, run `brew uninstall deno` to cleanly remove it. Also, delete any related configuration or cache files in your home directory, such as `~/.deno`, for a complete removal. ## What this guide does not cover and who should look elsewhere This guide does not cover advanced Deno configuration or usage beyond installation, updating, and uninstallation on a Mac. If you require advice on production deployment, integration with CI/CD pipelines, or in-depth runtime optimization, you should consult the official Deno documentation or specialized resources. Additionally, users working on non-Mac platforms will need platform-specific instructions not addressed here. To get the most from Deno after installation, the single most useful next step is to familiarize yourself with its permissions model and key commands by running **deno help** in your terminal. This will help you understand how Deno handles security and modules, which is crucial for effective and safe usage.