Commands to type at the terminal begin "$ ". Do not type "$ ". This is only here to help distinguish between commands and comments.

## Install packages

Before installing packages, it is a good idea to update the package list:

`$ sudo apt update`

Install the git version control system:

`$ sudo apt install git -y`

Install packages that edbrowse uses:

`$ sudo apt install libcurl4-openssl-dev -y`

`$ sudo apt install libpcre2-dev -y`

`$ sudo apt install libreadline-dev -y`

`$ sudo apt install libssl-dev -y`

`$ sudo apt install unixodbc-dev -y`

## Build quickjs

Create a copy of the files in the quickjs repository:

`$ git clone https://github.com/bellard/quickjs`

Change to the quickjs subdirectory:

`$ cd quickjs`

Build quickjs:

`$ make`

If this generates a lot of atomic undefines, and it probably will on 32-bit Raspberry Pi OS, use:

`$ make EXTRA_LIBS=-latomic`

Return to the parent directory:

`$ cd ..`

## Build and install edbrowse

Create a copy of the files in the edbrowse repository:

`$ git clone https://github.com/CMB/edbrowse`

Change to the edbrowse subdirectory:

`$ cd edbrowse`

Build edbrowse:

`$ make`

Install edbrowse:

`$ sudo make install`

Return to the parent directory:

`$ cd ..`

Start edbrowse:

`$ edbrowse`

If this gives a library linking error, reconfigure the dynamic linker run time bindings (you should not need to do this often):

`$ sudo ldconfig`

## Update edbrowse

Update the package list:

`$ sudo apt update`

Upgrade installed packages:

`$ sudo apt full-upgrade -y`

Change to the quickjs subdirectory:

`$ cd quickjs`

Get the latest files from the quickjs repository:

`$ git pull`

If no files have changed, you need not build quickjs again.

If files have changed, build quickjs:

`$ make EXTRA_LIBS=-latomic`

Return to the parent directory:

`$ cd ..`

Change to the edbrowse subdirectory:

`$ cd edbrowse`

Get the latest files from the edbrowse repository:

`$ git pull`

If no files have changed, you need not build and install edbrowse again.

If files have changed, build and install edbrowse:

`$ make`

`$ sudo make install`

Return to the parent directory:

`$ cd ..`

Start edbrowse:

`$ edbrowse`