Install software

Homebrew

Homebrew (opens new window) is a package manager that installs packages in its own locations, and allows you to uninstall packages, a feature that is lacking in macOS. We will use this to install software, but you can also choose to use official installers.

Install Homebrew with these steps:

• Open Terminal.
• Enter this command:

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

• Then just follow the instructions. The installation may take a long time.

Text editor

MacOS includes TextEdit, which can be used for single text files, but we recommend to use a better editor that also works for projects containing many files. We suggest Visual Studio Code (opens new window)

Homebrew:
https://formulae.brew.sh/cask/visual-studio-code (opens new window)

• Open Terminal.
• Enter this command:

  % brew install --cask visual-studio-code
  

• You can start Visual Studio Code like any other app, but you can also easily launch it from the command line with the command code. For example:

  % code path/to/file.txt
  

We have a suggested configuration of Visual Studio Code for our development environment.

GitHub Desktop

You need a Git client to get the source code from Git. We suggest GitHub Desktop (opens new window)

Homebrew:
https://formulae.brew.sh/cask/github (opens new window)

• Open Terminal.
• Enter this command:

  % brew install --cask github
  

When you start GitHub Desktop, you will be asked to log in or create an account at GitHub.

Source Code

Choose a directory on your computer to clone Git repositories. We will call this <GITDIR>. Then clone the following repositories. Further instructions on cloning a repository with GitHub Desktop are given below.

https://github.com/RoessinghResearch/rrd-utils.git (opens new window)
Clone to: <GITDIR>/rrd-utils

https://github.com/RoessinghResearch/senseeact.git (opens new window)
Clone to: <GITDIR>/senseeact

Clone with GitHub Desktop

• Open GitHub Desktop.
• If you see the start screen, click Clone a repository from the Internet... Otherwise choose from the menu File > Clone repository...
• Select the tab URL.
• Enter the URL of the repository:
  • https://github.com/RoessinghResearch/rrd-utils.git (opens new window)
  • https://github.com/RoessinghResearch/senseeact.git (opens new window)
• At Local path click Choose... and open your <GITDIR>. This will be saved for next time. The repository name, rrd-utils or senseeact, should automatically be added.
• Click Clone.

Java

We recommend the Eclipse Temurin OpenJDK binaries from Adoptium (opens new window).

Homebrew:
https://formulae.brew.sh/cask/temurin (opens new window)

Version 17 available through homebrew/cask-versions:
https://github.com/Homebrew/homebrew-cask-versions (opens new window)

• Open Terminal.
• Enter these commands:

  % brew tap homebrew/cask-versions
  % brew install --cask temurin17
  

Key generator

You can generate passwords and keys for configuration files with our key generator:

• Open Terminal in this directory:
  <GITDIR>/rrd-utils/BuildTools/BuildTools-1.0.0

• Run this to see available options:

  % ./keygenerator.sh -h
  

• For example you can generate a password with:

  % ./keygenerator.sh -t secure_password
  

During the configuration in the next section, you can keep this terminal open so you can generate a password or key where needed.

Docker Desktop

https://www.docker.com/ (opens new window)

Homebrew:
https://formulae.brew.sh/cask/docker (opens new window)

• Open Terminal.
• Enter this command:

  % brew install --cask docker
  

• Start Docker.
• You will be offered to run a tutorial. You can complete the tutorial or just click Skip tutorial.