Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 19 additions & 30 deletions posts/23/0411-DevEnvSetup/index.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Developer Environment Setup"
author: "John Gunstone"
date: "2023-04-11"
date-modified: "2025-02-26"
date-modified: "2025-09-08"
categories: [dev-setup]
image: https://github.com/maxfordham/visual-design/blob/main/icons/engineer-icon.png?raw=true
---
Expand All @@ -12,17 +12,6 @@ Setting up WSL has certain risks.
It requires an Adminstrator password to the machine for the initial steps highlighted below.
:::

- [Introduction](#introduction)
- [Prerequisite](#prerequisite)
- [Instructions](#instructions)
- [Install Ubuntu on WSL](#install-ubuntu-on-wsl)
- [Set Up SSH To Access Repositories on Max Fordham GitHub](#set-up-ssh-to-access-repositories-on-max-fordham-github)
- [Install Conda Package Manager](#install-mamba-package-manager)
- [Install some handy CLI tools](#install-some-handy-cli-tools)
- [Install Visual Studio Code](#install-visual-studio-code)

## Introduction

Below are instructions about how to configure a development machine. Ideally they should
be followed exactly, to ensure that tests etc. are reproducible across development team
members.
Expand All @@ -41,10 +30,12 @@ Hyper-V should already be enabled on your laptop but if you are having issues th

### Install Ubuntu on WSL (admin required)

```{danger}

::: {.callout-danger}

couldn't get wsl working on a fresh install.
to fix: https://github.com/microsoft/WSL/issues/9521#issuecomment-2385289848
```
:::

```cmd
wsl --install -d Ubuntu
Expand Down Expand Up @@ -99,17 +90,7 @@ Create the new user as `jovyan` and set the password to something sensible you w

You should now be able to access the repositories on Max Fordham LLP, assuming that you are a member of the organisation.

### Install micromamba Package Manager

```{note}
not miniforge
```

Follow instructions: [micromamba](https://mamba.readthedocs.io/en/latest/installation/micromamba-installation.html#).

add to `.bashrc` init = Y

### Install pixi package manager (optional)
### Install pixi package manager

- [install](https://pixi.sh/latest/#installation)
- `curl -fsSL https://pixi.sh/install.sh | bash` <-- check still current on install
Expand All @@ -121,13 +102,14 @@ add to `.bashrc` init = Y
can also use [pixi](https://pixi.sh/latest/basic_usage/#use-pixi-as-a-global-installation-tool) to globally install useful tools.

```bash
pixi global install micromamba # micormamba pkg manager
pixi global install starship # shell autocompletion
pixi global install ripgrep # searching text in files
pixi global install tree # viewing directory structures in linux
pixi global install gh # github CLI
```

also note that there are many ways to do this. the most standard way it to use apt-get.
also note that there are many other ways to do this. the most standard way it to use apt-get.
e.g.

```bash
Expand Down Expand Up @@ -156,10 +138,17 @@ alias mamba='micromamba'

Restart WSL for the above changes to take effect.

### Install Notepad ++

[notepad++](https://notepad-plus-plus.org/downloads/)
## Other Software

### [notepad++](https://notepad-plus-plus.org/downloads/)

### [vscode](https://code.visualstudio.com/)

### [MySQL 8 Server](https://dev.mysql.com/downloads/mysql/8.0.html)

### [MySql Workbench](https://www.mysql.com/products/workbench/)

### [Windows Terminal](https://github.com/microsoft/terminal)

### Install Visual Studio Code

[vscode](https://code.visualstudio.com/)
Loading