This article provides step-by-step instructions to install Phanes on a macOS computer.

---

Service Desk

---

This article provides step-by-step instructions to install Phanes on a macOS. This process utilizes Docker Desktop and requires several developer tools installed via Homebrew. While there is a Homebrew-based method, the official recommendation is to use Docker Desktop for the most stable experience.

---

You will need:

• Install Rust KB00064515

• Install Git KB00064521

• Install Docker KB00064524

---

Open Terminal and run:

bash

Copy code

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

---

In Terminal:

bash

Copy code

brew install git rust pkg-config openssl make coreutils brew install --cask docker

• Note: If docker has been previously installed, ensure it’s updated.

---

bash

Copy code

brew install --cask google-cloud-sdk brew install kubectl

Afterwards, add Google Cloud SDK to your PATH: Add this to your ~/.zshrc (or ~/.bash_profile if using bash): bash

Copy code

source '/usr/local/Caskroom/google-cloud-sdk/latest/google-cloud-sdk/path.zsh.inc'

Then reload your shell:

bash

Copy code

source ~/.zshrc

---

• Open Docker Desktop from your Applications folder.

• Wait until Docker finishes starting up (the Docker icon should show as running in your menu bar).

---

• Generate SSH key if needed:

  bash

  Copy code

  ssh-keygen -t ed25519 -C "your_email@example.com" cat ~/.ssh/id_ed25519.pub # Copy this text

• Add the public key to your GitLab account

4. Add to GitHub

• Go to https://github.com/settings/keys.

• Click “New SSH key” or “Add SSH key”.

• Set a title, e.g., “(username) laptop”.

• Paste the copied public key into the text box.

• Click “Add SSH key”.

---

In Terminal:

bash

Copy code

bash

Copy code

Replace placeholders with your details:

bash

Copy code

phanes setup --username <USER_NAME> --email <EMAIL> --fullname <FULL_NAME>

To specify a custom data directory:

bash

Copy code

phanes setup --datapath <DIR> --username <USER_NAME> --email <EMAIL> --fullname <FULL_NAME>

Note: datapath will default to $HOME/data if not specified. It will be created if it does not exist.

---

bash

Copy code

gcloud init gcloud auth configure-docker gcloud auth application-default login

• Choose the correct project (e.g., prj-p-shared-base-15c0) when prompted.

---

Verify Phanes worked:

bash

Copy code

phanes --help