docs icon indicating copy to clipboard operation
docs copied to clipboard

Quickstart documentation for macOS does not work

Open mcalthrop opened this issue 7 months ago • 3 comments

Description

Some parts of the Quickstart documentation do not work as described on macOS.

  1. Docker instructions

    The command to install Docker on macOS does not work: https://coder.com/docs/tutorials/quickstart#install-and-start-coder

    The error message is "ERROR: Unsupported operating system 'macOS'".

    OS details: macOS 15.6, M3, 36Gb RAM

    Image
$ curl -sSL https://get.docker.com | sh

# Executing docker install script, commit: bedc5d6b3e782a5e50d3d2a870f5e1f1b5a38d5c

ERROR: Unsupported operating system 'macOS'
Please get Docker Desktop from https://www.docker.com/products/docker-desktop

$ sw_vers
ProductName:		macOS
ProductVersion:		15.6
BuildVersion:		24G84
$ sysctl -a | grep brand
machdep.cpu.brand_string: Apple M3 Pro
Image
  1. Assigning your user to the Docker group

    Running the command to assign my user to the Docker group also fails:

$ sudo usermod -aG docker $USER

sudo: usermod: command not found
Image
  1. Running newgrp

    I ran the following command to assign my user to the Docker group on macOS:

sudo dscl . create /Groups/docker GroupMembership $USER

Running newgrp fails:

➜  ~ sudo dscl . create /Groups/docker GroupMembership $USER
Password:
➜  ~ newgrp docker

newgrp: docker: bad group name
Image

mcalthrop avatar Aug 08 '25 10:08 mcalthrop

From what I can see so far, the solutions are, respectively:

  1. Install Docker desktop here: https://www.docker.com/products/docker-desktop/
  2. Follow these instructions: https://stackoverflow.com/questions/72544896/create-a-docker-group-and-place-my-user-in-it-in-macos
  3. not sure yet

mcalthrop avatar Aug 08 '25 10:08 mcalthrop

Just installing Docker on macOS is proving to be quite a drama...

I've come across this, but haven't yet got any of the suggestions there working: https://github.com/docker/for-mac/issues/7520

mcalthrop avatar Aug 08 '25 12:08 mcalthrop

btw, I'm happy to raise a PR to address the issues above – just want to be sure of all the fixes before doing so.

mcalthrop avatar Aug 08 '25 13:08 mcalthrop