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
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions