- Install Homebrew Mac Mojave Download
- Install Homebrew Mac Mojave Safari
- Install Homebrew Mac Mojave Patcher
In this article, you'll learn how to install .NET on macOS. .NET is made up of the runtime and the SDK. The runtime is used to run a .NET app and may or may not be included with the app. The SDK is used to create .NET apps and libraries. The .NET runtime is always installed with the SDK.
Install Go Lang on MacOS with Homebrew! I've started learning Go lang. It seems to be built by the right people with the right expectations. So, the first thing I did was install go on Mac with Homebrew. 👨💻 I'm teaching thousands of devs how to become VSCode Power Users → This site is super fast?! I want to install pip for python 2.7 on my Mac. I think this is the python located in /usr/bin/python. Unfortunately I have already installed Anaconda, which installs python 3.6.3, and changes things so that the command python xxx.py automatically runs xxx.py using python 3.6.3.
The latest version of .NET is 5.0.
Apt-get install sshpass Installing on OS X. Installing on OS X is tricky, since there is no official build for it. Before you get started, you need install xcode and command line tools. Installing with Homebrew. Homebrew does not allow you to install sshpass by default. But you can use the following unofficial brew package for that. Jul 18, 2018 Restoring Telnet to MacOS Mojave & High Sierra by Compiling Telnet from Source. If you don't want to use Homebrew for whatever reason, you can also compile Telnet yourself from inetutils source. As a prerequisite you'll still need to install the Mac OS command line tools to be able to accomplish this, however. Do not install if you have the current macOS Mojave 10.14 or later. MacOS Mojave 10.14 (released in October 2018) includes a CH34x driver by Apple. If both Apple's and the OEM driver are installed, they will create conflicting non-functional serial ports.
Supported releases
The following table is a list of currently supported .NET releases and the versions of macOS they're supported on. These versions remain supported either the version of .NET reaches end-of-support.
- A ✔️ indicates that the version of .NET Core is still supported.
- A ❌ indicates that the version of .NET Core isn't supported.
Operating System | .NET Core 2.1 | .NET Core 3.1 | .NET 5.0 |
---|---|---|---|
macOS 11.0 'Big Sur' | ✔️ 2.1 (Release notes) | ✔️ 3.1 (Release notes) | ✔️ 5.0 (Release notes) |
macOS 10.15 'Catalina' | ✔️ 2.1 (Release notes) | ✔️ 3.1 (Release notes) | ✔️ 5.0 (Release notes) |
macOS 10.14 'Mojave' | ✔️ 2.1 (Release notes) | ✔️ 3.1 (Release notes) | ✔️ 5.0 (Release notes) |
macOS 10.13 'High Sierra' | ✔️ 2.1 (Release notes) | ✔️ 3.1 (Release notes) | ✔️ 5.0 (Release notes) |
macOS 10.12 'Sierra' | ✔️ 2.1 (Release notes) | ❌ 3.1 (Release notes) | ❌ 5.0 (Release notes) |
Unsupported releases
The following versions of .NET are ❌ no longer supported. The downloads for these still remain published:
- 3.0 (Release notes)
- 2.2 (Release notes)
- 2.0 (Release notes)
Runtime information
The runtime is used to run apps created with .NET. When an app author publishes an app, they can include the runtime with their app. If they don't include the runtime, it's up to the user to install the runtime.
There are two different runtimes you can install on macOS:
ASP.NET Core runtime
Runs ASP.NET Core apps. Includes the .NET runtime..NET runtime
This runtime is the simplest runtime and doesn't include any other runtime. It's highly recommended that you install ASP.NET Core runtime for the best compatibility with .NET apps.
SDK information
The SDK is used to build and publish .NET apps and libraries. Installing the SDK includes both runtimes: ASP.NET Core and .NET.
Dependencies
.NET is supported on the following macOS releases:
.NET Core Version | macOS | Architectures | More information |
---|---|---|---|
5.0 | High Sierra (10.13+) | x64 | More information |
3.1 | High Sierra (10.13+) | x64 | More information |
3.0 | High Sierra (10.13+) | x64 | More information |
2.2 | Sierra (10.12+) | x64 | More information |
2.1 | Sierra (10.12+) | x64 | More information |
Beginning with macOS Catalina (version 10.15), all software built after June 1, 2019 that is distributed with Developer ID, must be notarized. This requirement applies to the .NET runtime, .NET SDK, and software created with .NET.
The runtime and SDK installers for .NET 5.0 and .NET Core 3.1, 3.0, and 2.1, have been notarized since February 18, 2020. Prior released versions aren't notarized. If you run a non-notarized app, you'll see an error similar to the following image:
For more information about how enforced-notarization affects .NET (and your .NET apps), see Working with macOS Catalina Notarization.
libgdiplus
.NET applications that use the System.Drawing.Common assembly require libgdiplus to be installed.
An easy way to obtain libgdiplus is by using the Homebrew ('brew') package manager for macOS. After installing brew, install libgdiplus by executing the following commands at a Terminal (command) prompt:
Install with an installer
macOS has standalone installers that can be used to install the .NET 5.0 SDK:
Download and manually install
As an alternative to the macOS installers for .NET, you can download and manually install the SDK and runtime. Manual install is usually performed as part of continuous integration testing. For a developer or user, it's generally better to use an installer.
If you install .NET SDK, you don't need to install the corresponding runtime. First, download a binary release for either the SDK or the runtime from one of the following sites:
- ✔️ .NET 5.0 downloads
- ✔️ .NET Core 3.1 downloads
- ✔️ .NET Core 2.1 downloads
Next, extract the downloaded file and use the export
command to set variables used by .NET and then ensure .NET is in PATH.
To extract the runtime and make the .NET CLI commands available at the terminal, first download a .NET binary release. Then, open a terminal and run the following commands from the directory where the file was saved. The archive file name may be different depending on what you downloaded.
Use the following commands to extract the runtime or SDK that you downloaded. Remember to change the DOTNET_FILE
value to your file name:
Tip
The preceding export
commands only make the .NET CLI commands available for the terminal session in which it was run.
You can edit your shell profile to permanently add the commands. There are a number of different shells available for Linux and each has a different profile. For example:
- Bash Shell: ~/.bash_profile, ~/.bashrc
- Korn Shell: ~/.kshrc or .profile
- Z Shell: ~/.zshrc or .zprofile
Edit the appropriate source file for your shell and add :$HOME/dotnet
to the end of the existing PATH
statement. If no PATH
statement is included, add a new line with export PATH=$PATH:$HOME/dotnet
.
Also, add export DOTNET_ROOT=$HOME/dotnet
to the end of the file.
This approach lets you install different versions into separate locations and choose explicitly which one to use by which application.
Install with Visual Studio for Mac
Visual Studio for Mac installs the .NET SDK when the .NET workload is selected. To get started with .NET development on macOS, see Install Visual Studio 2019 for Mac.
.NET SDK version | Visual Studio version |
---|---|
5.0 | Visual Studio 2019 for Mac version 8.8 or higher. |
3.1 | Visual Studio 2019 for Mac version 8.4 or higher. |
2.1 | Visual Studio 2019 for Mac version 8.0 or higher. |
Install alongside Visual Studio Code
Visual Studio Code is a powerful and lightweight source code editor that runs on your desktop. Visual Studio Code is available for Windows, macOS, and Linux.
While Visual Studio Code doesn't come with an automated .NET installer like Visual Studio does, adding .NET support is simple.
- Download and install Visual Studio Code.
- Download and install the .NET SDK.
- Install the C# extension from the Visual Studio Code marketplace.
Install with bash automation
The dotnet-install scripts are used for automation and non-admin installs of the runtime. You can download the script from the dotnet-install script reference page.
The script defaults to installing the latest long term support (LTS) version, which is .NET Core 3.1. You can choose a specific release by specifying the current
switch. Include the runtime
switch to install a runtime. Otherwise, the script installs the SDK.
Note
The previous command installs the ASP.NET Core runtime for maximum compatability. The ASP.NET Core runtime also includes the standard .NET runtime.
Docker
Containers provide a lightweight way to isolate your application from the rest of the host system. Containers on the same machine share just the kernel and use resources given to your application.
.NET can run in a Docker container. Official .NET Docker images are published to the Microsoft Container Registry (MCR) and are discoverable at the Microsoft .NET Core Docker Hub repository. Each repository contains images for different combinations of the .NET (SDK or Runtime) and OS that you can use.
Microsoft provides images that are tailored for specific scenarios. For example, the ASP.NET Core repository provides images that are built for running ASP.NET Core apps in production.
For more information about using .NET Core in a Docker container, see Introduction to .NET and Docker and Samples.
Next steps
- How to check if .NET Core is already installed.
- Working with macOS Catalina notarization.
- Tutorial: Get started on macOS.
- Tutorial: Create a new app with Visual Studio Code.
- Tutorial: Containerize a .NET Core app.
DDEV is an open source tool that makes it dead simple to get local PHP development environments up and running within minutes. It's powerful and flexible as a result of its per-project environment configurations, which can be extended, version controlled, and shared. In short, DDEV aims to allow development teams to use Docker in their workflow without the complexities of bespoke configuration.
System Requirements¶
- Docker version 18.06 or higher. Linux users make sure you upgrade docker-compose and do the post-install steps
- docker-compose 1.21.0 and higher (bundled with Docker in Docker Desktop for Mac and Docker Desktop for Windows)
- OS Support
* macOS Mojave and higher (macOS 10.14 and higher; it should run anywhere Docker Desktop for Mac runs (Current Docker Desktop has deprecated macOS 10.13 High Sierra, but Docker Desktop versions prior to can still work with DDEV-Local on High Sierra.)
* Linux: Most Linux distributions which can run Docker-ce are fine. This includes at least Ubuntu 16.04+, Debian Jessie+, Fedora 25+. Make sure to follow the docker-ce post-install steps
* Windows 10 (all editions) with WSL2 (version 1903.1049, 1909.1049, 2004 or later)
* (Non-WSL2) Windows 10 Home, Pro, or Enterprise with Docker Desktop for Windows - Architecture Support
* AMD64 is supported on Windows 10 (with either traditional Windows or WSL2), macOS, and Linux.
* ARM64 machines are currently supported on Linux and in WSL2 in Windows ARM64 computers.
* Apple Silicon M1 (ARM64) is supported in v1.17-alpha1+ (edge versions).
Using DDEV alongside other development environments¶
DDEV by default uses ports 80 and 443 on your system when projects are running. If you are using another local development environment you can either stop the other environment or configure DDEV to use different ports. See troubleshooting for more detailed problem solving.
Installation¶
When upgrading, please run ddev poweroff
and check the release notes for actions you might need to take on each project.
Docker Installation¶
Docker and docker-compose are required before anything will work with DDEV. This is pretty easy on most environments; see the docker_installation page to help sort out the details, especially on Windows and Linux.
Homebrew - macOS/Linux¶
For macOS (both amd64 and arm64) and Linux users, we recommend installing and upgrading via Homebrew (macOS) or Homebrew on Linux (Linux):
If you would like more frequent 'edge' releases then use brew install drud/ddev-edge/ddev
instead.)
As a one-time initialization, run mkcert -install
. Linux users may have to take additional actions as discussed below in 'Linux mkcert -install
additional instructions'.
Later, to upgrade to a newer version of DDEV-Local, run:
Installation or Upgrade - Windows (WSL2)¶
This is the recommended installation method for all Windows users that are on Windows 10 1903.1049, 1909.1049, 2004 or higher If you don't have this version yet, or if you don't want to use WSL2, please follow the legacy instructions for Windows below.
All Windows 10 editions (including Windows 10 Home) support WSL2. Docker Toolbox support for DDEV has been removed. If you're already familiar with DDEV on Windows, you might have been using NFS for better filesystem performance. You won't need NFS anymore once you switch to WSL2, since it provides awesome filesystem performance out of the box.
The WSL2 install process involves:
- Installing Chocolatey package manager (optional).
- One time initialization of mkcert.
- Installing WSL2, setting version 2 as the default version, and installing a distro like Ubuntu.
- Installing or upgrading to the latest Docker Desktop for Windows with WSL2 enabled.
- Installing DDEV inside your distro.
libgdiplus
.NET applications that use the System.Drawing.Common assembly require libgdiplus to be installed.
An easy way to obtain libgdiplus is by using the Homebrew ('brew') package manager for macOS. After installing brew, install libgdiplus by executing the following commands at a Terminal (command) prompt:
Install with an installer
macOS has standalone installers that can be used to install the .NET 5.0 SDK:
Download and manually install
As an alternative to the macOS installers for .NET, you can download and manually install the SDK and runtime. Manual install is usually performed as part of continuous integration testing. For a developer or user, it's generally better to use an installer.
If you install .NET SDK, you don't need to install the corresponding runtime. First, download a binary release for either the SDK or the runtime from one of the following sites:
- ✔️ .NET 5.0 downloads
- ✔️ .NET Core 3.1 downloads
- ✔️ .NET Core 2.1 downloads
Next, extract the downloaded file and use the export
command to set variables used by .NET and then ensure .NET is in PATH.
To extract the runtime and make the .NET CLI commands available at the terminal, first download a .NET binary release. Then, open a terminal and run the following commands from the directory where the file was saved. The archive file name may be different depending on what you downloaded.
Use the following commands to extract the runtime or SDK that you downloaded. Remember to change the DOTNET_FILE
value to your file name:
Tip
The preceding export
commands only make the .NET CLI commands available for the terminal session in which it was run.
You can edit your shell profile to permanently add the commands. There are a number of different shells available for Linux and each has a different profile. For example:
- Bash Shell: ~/.bash_profile, ~/.bashrc
- Korn Shell: ~/.kshrc or .profile
- Z Shell: ~/.zshrc or .zprofile
Edit the appropriate source file for your shell and add :$HOME/dotnet
to the end of the existing PATH
statement. If no PATH
statement is included, add a new line with export PATH=$PATH:$HOME/dotnet
.
Also, add export DOTNET_ROOT=$HOME/dotnet
to the end of the file.
This approach lets you install different versions into separate locations and choose explicitly which one to use by which application.
Install with Visual Studio for Mac
Visual Studio for Mac installs the .NET SDK when the .NET workload is selected. To get started with .NET development on macOS, see Install Visual Studio 2019 for Mac.
.NET SDK version | Visual Studio version |
---|---|
5.0 | Visual Studio 2019 for Mac version 8.8 or higher. |
3.1 | Visual Studio 2019 for Mac version 8.4 or higher. |
2.1 | Visual Studio 2019 for Mac version 8.0 or higher. |
Install alongside Visual Studio Code
Visual Studio Code is a powerful and lightweight source code editor that runs on your desktop. Visual Studio Code is available for Windows, macOS, and Linux.
While Visual Studio Code doesn't come with an automated .NET installer like Visual Studio does, adding .NET support is simple.
- Download and install Visual Studio Code.
- Download and install the .NET SDK.
- Install the C# extension from the Visual Studio Code marketplace.
Install with bash automation
The dotnet-install scripts are used for automation and non-admin installs of the runtime. You can download the script from the dotnet-install script reference page.
The script defaults to installing the latest long term support (LTS) version, which is .NET Core 3.1. You can choose a specific release by specifying the current
switch. Include the runtime
switch to install a runtime. Otherwise, the script installs the SDK.
Note
The previous command installs the ASP.NET Core runtime for maximum compatability. The ASP.NET Core runtime also includes the standard .NET runtime.
Docker
Containers provide a lightweight way to isolate your application from the rest of the host system. Containers on the same machine share just the kernel and use resources given to your application.
.NET can run in a Docker container. Official .NET Docker images are published to the Microsoft Container Registry (MCR) and are discoverable at the Microsoft .NET Core Docker Hub repository. Each repository contains images for different combinations of the .NET (SDK or Runtime) and OS that you can use.
Microsoft provides images that are tailored for specific scenarios. For example, the ASP.NET Core repository provides images that are built for running ASP.NET Core apps in production.
For more information about using .NET Core in a Docker container, see Introduction to .NET and Docker and Samples.
Next steps
- How to check if .NET Core is already installed.
- Working with macOS Catalina notarization.
- Tutorial: Get started on macOS.
- Tutorial: Create a new app with Visual Studio Code.
- Tutorial: Containerize a .NET Core app.
DDEV is an open source tool that makes it dead simple to get local PHP development environments up and running within minutes. It's powerful and flexible as a result of its per-project environment configurations, which can be extended, version controlled, and shared. In short, DDEV aims to allow development teams to use Docker in their workflow without the complexities of bespoke configuration.
System Requirements¶
- Docker version 18.06 or higher. Linux users make sure you upgrade docker-compose and do the post-install steps
- docker-compose 1.21.0 and higher (bundled with Docker in Docker Desktop for Mac and Docker Desktop for Windows)
- OS Support
* macOS Mojave and higher (macOS 10.14 and higher; it should run anywhere Docker Desktop for Mac runs (Current Docker Desktop has deprecated macOS 10.13 High Sierra, but Docker Desktop versions prior to can still work with DDEV-Local on High Sierra.)
* Linux: Most Linux distributions which can run Docker-ce are fine. This includes at least Ubuntu 16.04+, Debian Jessie+, Fedora 25+. Make sure to follow the docker-ce post-install steps
* Windows 10 (all editions) with WSL2 (version 1903.1049, 1909.1049, 2004 or later)
* (Non-WSL2) Windows 10 Home, Pro, or Enterprise with Docker Desktop for Windows - Architecture Support
* AMD64 is supported on Windows 10 (with either traditional Windows or WSL2), macOS, and Linux.
* ARM64 machines are currently supported on Linux and in WSL2 in Windows ARM64 computers.
* Apple Silicon M1 (ARM64) is supported in v1.17-alpha1+ (edge versions).
Using DDEV alongside other development environments¶
DDEV by default uses ports 80 and 443 on your system when projects are running. If you are using another local development environment you can either stop the other environment or configure DDEV to use different ports. See troubleshooting for more detailed problem solving.
Installation¶
When upgrading, please run ddev poweroff
and check the release notes for actions you might need to take on each project.
Docker Installation¶
Docker and docker-compose are required before anything will work with DDEV. This is pretty easy on most environments; see the docker_installation page to help sort out the details, especially on Windows and Linux.
Homebrew - macOS/Linux¶
For macOS (both amd64 and arm64) and Linux users, we recommend installing and upgrading via Homebrew (macOS) or Homebrew on Linux (Linux):
If you would like more frequent 'edge' releases then use brew install drud/ddev-edge/ddev
instead.)
As a one-time initialization, run mkcert -install
. Linux users may have to take additional actions as discussed below in 'Linux mkcert -install
additional instructions'.
Later, to upgrade to a newer version of DDEV-Local, run:
Installation or Upgrade - Windows (WSL2)¶
This is the recommended installation method for all Windows users that are on Windows 10 1903.1049, 1909.1049, 2004 or higher If you don't have this version yet, or if you don't want to use WSL2, please follow the legacy instructions for Windows below.
All Windows 10 editions (including Windows 10 Home) support WSL2. Docker Toolbox support for DDEV has been removed. If you're already familiar with DDEV on Windows, you might have been using NFS for better filesystem performance. You won't need NFS anymore once you switch to WSL2, since it provides awesome filesystem performance out of the box.
The WSL2 install process involves:
- Installing Chocolatey package manager (optional).
- One time initialization of mkcert.
- Installing WSL2, setting version 2 as the default version, and installing a distro like Ubuntu.
- Installing or upgrading to the latest Docker Desktop for Windows with WSL2 enabled.
- Installing DDEV inside your distro.
We'll walk through these in more detail. You may prefer other techniques of installation or may not need some steps, but this is the full recipe:
- If you have previously installed Docker Toolbox, please completely uninstall Docker Toolbox.
- Chocolatey: We recommend using Chocolatey for Chocolatey installing required Windows apps like mkcert. In an administrative 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://chocolatey.org/install.ps1'))
- In an administrative PowerShell:
choco install -y mkcert
- In administrative PowerShell, run
mkcert -install
and answer the prompt allowing the installation of the Certificate Authority. - In administrative PowerShell, run the command
setx CAROOT '$(mkcert -CAROOT)'; If ($Env:WSLENV -notlike '*CAROOT/up:*') { setx WSLENV 'CAROOT/up:$Env:WSLENV' }
. This will set WSL2 to use the Certificate Authority installed on the Windows side. - Install WSL2. In an administrative PowerShell
Enable-WindowsOptionalFeature -Online -FeatureName $('VirtualMachinePlatform', 'Microsoft-Windows-Subsystem-Linux')
(Your computer will reboot.) (See detailed documentation.) - Download and install the WSL2 kernel from WSL2 kernel upgrade page.
- Set the default WSL version to 2:
wsl --set-default-version 2
You may be prompted to upgrade the WSL2 kernel. - Install a WSL2 distro from the Microsoft Store. We recommend Ubuntu. (You do not have to log in to the Microsoft Store, just 'X' out the dialog box requesting that.)
- Docker Desktop for Windows: If you already have the latest Docker Desktop, configure it in the General Settings to use the WSL2-based engine. Otherwise install the latest Docker Desktop for Windows and select the WSL2-based engine (not legacy Hyper-V) when installing. Install via Chocolatey with
choco install docker-desktop
or it can be downloaded from download.docker.com. Start Docker. It may prompt you to log out and log in again, or reboot. - Go to Docker Desktop settings > Resources > WSL integration > enable integration for your distro (now
docker
commands will be available from within your WSL2 distro). - Double-check in PowerShell:
wsl -l -v
should show three distros, and your Ubuntu should be the default. All three should be WSL version 2. - Double-check in Ubuntu (or your distro):
echo $CAROOT
should show something like/mnt/c/Users//AppData/Local/mkcert
- Check that docker is working inside Ubuntu (or your distro):
docker ps
- Optional: If you prefer to use the Windows ddev instead of working inside WSL2, install it with
choco install -y ddev
. The Windows ddev works fine with the WSL2-based Docker engine. - Open the WSL2 terminal, for example
Ubuntu
from the Windows start menu. - Install Homebrew:
/bin/bash -c '$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)'
(See https://brew.sh/.) - Add brew to your path as prompted, for example,
echo 'eval $(/home/linuxbrew/.linuxbrew/bin/brew shellenv)' >> ~/.profile && source ~/.profile
brew install gcc && brew install drud/ddev/ddev
sudo apt-get update && sudo apt-get install -y xdg-utils
to install the xdg-utils package that allowsddev launch
to work.
That's it! You have now installed DDEV on WSL2. If you're using WSL2 for ddev (recommended), remember to run all ddev
commands inside the WSL2 distro.
Make sure you put your projects in the Linux filesystem (e.g. /home/), not in the Windows filesystem (/mnt/c), because you'll get vastly superior performance on the Linux filesystem.
Note that nfs-mount-enabled (and running NFS) are not required on WSL2 because it's perhaps faster without NFS.
Installation or Upgrade - Windows (legacy)¶
- If you use chocolatey (recommended), then you can just
choco install ddev git
from an administrative shell. Upgrades are justddev poweroff && choco upgrade ddev
. - A windows installer is provided in each ddev release (
ddev_windows_installer..exe
). Run that and it will do the full installation for you. Open a new git-bash or PowerShell or cmd window and start using ddev. - Most people interact with ddev on Windows using git-bash, part of the Windows git suite. Although ddev does work with cmd and PowerShell, it's more at home in bash. You can install it with chocolatey using
choco install -y git
.
Installation/Upgrade Script - Linux and macOS (ARM/ARM64 and AMD64 architectures)¶
Windows WSL2, Linux and macOS users can use this line of code to your terminal to download, verify, and install (or upgrade) ddev using our install script. Note that this works with both amd64 and arm64 architectures, including Surface Pro X with WSL2 and 64-bit Raspberry Pi OS. It also works with the new macOS Apple Silicon M1 machines.
The installation script can also take a version argument in order to install a specific version or a prerelease version. For example,
Later, to upgrade DDEV to the latest version, just run ddev poweroff
and run the script again.
Install Homebrew Mac Mojave Download
Manual Installation or Upgrade - Linux and macOS¶
You can also easily perform the installation or upgrade manually if preferred. DDEV is just a single executable, no special installation is actually required, so for all operating systems, the installation is just copying DDEV into place where it's in the system path. Install wireshark on virtual machine.
ddev poweroff
if upgrading- Download and extract the latest ddev release for your architecture.
- Move ddev to /usr/local/bin:
mv ddev /usr/local/bin/
(may require sudo), or another directory in your$PATH
as preferred. - Run
ddev
to test your installation. You should see DDEV's command usage output. - As a one-time initialization, run
mkcert -install
, which may require your sudo password. Linux users may have to take additional actions as discussed below in 'Linuxmkcert -install
additional instructions. If you don't have mkcert installed, you can install it from https://github.com/FiloSottile/mkcert/releases. Download the version for the correct architecture andsudo mv /usr/local/bin/mkcert && sudo chmod +x /usr/local/bin/mkcert
.
Installation via package managers - Linux¶
The preferred Linux package manager is Homebrew : brew install drud/ddev/ddev
We also currently maintain a package on Arch Linux (AUR)
As a one-time initialization, run mkcert -install
, which may require your sudo password. See below for additional information.
Install Homebrew Mac Mojave Safari
Linux mkcert -install
additional instructions¶
The mkcert -install
step on Linux may provide you with additional instructions.
On variants of Linux you may be prompted for additional package installation to get certutil installed, but you can follow the instructions given by mkcert:
$ mkcert -install
Created a new local CA at '/home/username/.local/share/mkcert'
Installing to the system store is not yet supported on this Linux but Firefox and/or Chrome/Chromium will still work.
You can also manually install the root certificate at '/home/username/.local/share/mkcert/rootCA.pem'.
Warning: 'certutil' is not available, so the CA can't be automatically installed in Firefox and/or Chrome/Chromium! ⚠️
Install 'certutil' with 'apt install libnss3-tools' or 'yum install nss-tools' and re-run 'mkcert -install'
(Note the prompt Installing to the system store is not yet supported on this Linux
, which can be a simple result of not having /usr/sbin in the path so that /usr/sbin/update-ca-certificates
can be found.)
Windows and Firefox mkcert -install
additional instructions¶
The mkcert -install
step on Windows does not work for the Firefox browser.
You need to add the created root certificate authority to the security
configuration by your self:
- Run
mkcert -install
(you can use the shortcut from the start menu for that) - Run
mkcert -CAROOT
to see the local folder used for the newly created root
certificate authority - Open the Firefox settings
- Enter
certificates
into the search box on the top - Click to
Show certificates..
- Select the tab
Certificate authorities
- Click to
Import..
- Go to the folder where your root certificate authority was stored
- Select the file
rootCA.pem
- Click to
Open
You should now see your CA under mkcert development CA
.
Install Homebrew Mac Mojave Patcher
Uninstallation¶
For instructions to uninstall DDEV-Local see Uninstallation.
Support and User-Contributed Documentation¶
We love to hear from our users and help them be successful with DDEV. Support options include:
- DDEV Stack Overflow for support and frequently asked questions. We respond quite quickly here and the results provide quite a library of user-curated solutions.
- DDEV issue queue for bugs and feature requests
- The gitter drud/ddev channel (it's easy to log in many different ways)
- The
#ddev
channels in Drupal Slack, TYPO3 Slack for interactive, immediate community support. - ddev-contrib repo provides a number of vetted user-contributed recipes for extending and using DDEV. Your contributions are welcome.
- awesome-ddev repo has loads of external resources, blog posts, recipes, screencasts, and the like. Your contributions are welcome.
- Twitter with tag #ddev will get to us, but it's not as good for interactive support, but we'll answer anywhere.