Skip to content
This repository was archived by the owner on Aug 18, 2025. It is now read-only.
This repository was archived by the owner on Aug 18, 2025. It is now read-only.

Quickstart documentation for macOS does not work #1340

@mcalthrop

Description

@mcalthrop

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions