Local development setup ‐ macOS Sonoma (14.6)

These are the steps for setting up a development environment on macOS Sonoma (14.6) ARM64.

The asdf runtime version manager is used for installing Python and NodeJS.

Set up the prerequisites

Install Homebrew

Use the standard Homebrew installation approach:

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Install the MySQL client

$ brew install mysql-client
$ echo '# Add the MySQL client to the path, for Redash' >> ~/.zshrc
$ echo 'PATH=$PATH:/opt/homebrew/opt/mysql-client/bin' >> ~/.zshrc

Install asdf

$ brew install coreutils curl git
$ git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.14.1
$ echo '. "$HOME/.asdf/asdf.sh"' >> ~/.zshrc
$ echo 'fpath=(${ASDF_DIR}/completions $fpath)' >> ~/.zshrc
$ echo 'autoload -Uz compinit && compinit' >> ~/.zshrc

Then start a new terminal session so the above change is active.

Install Docker Desktop

Download and install Docker Desktop

Allow Rosetta to be installed during the installation where it asks for confirmation.

Verify docker works

$ docker run hello-world

What else?

Probably just need to follow the Debian 12 install approach from here onwards?

• Cloning Redash source works
• Installing Python using asdf works
• Creating Python virtual environment works

Problems

• Installing the Python dependencies for Redash throws errors. Looks like some missing prerequisites?
  • MySQL client library. Fixed
  • pymssql. MS SQL Server client library?
  • What else?

Further stuff is TBD