Memos Build Instructions

This document outlines the steps to build Memos from source, including both the backend (Go) and frontend (React/TypeScript).

Prerequisites

Clone the repository:

git clone https://github.com/usememos/memos.git
cd memos

Install Go 1.24: First, try installing through your package manager:
```
sudo apt-get update
sudo apt-get install golang-1.24
```
If Go 1.24 is not available in your package manager, you can install it manually:
```
wget https://go.dev/dl/go1.24.0.linux-arm64.tar.gz
sudo tar -C /usr/local -xzf go1.24.0.linux-arm64.tar.gz
```
Add Go to your PATH by adding these lines to your ~/.bashrc:
```
export GOROOT=/usr/local/go
export PATH=$GOROOT/bin:$PATH
```
Reload your shell configuration:
```
source ~/.bashrc
```
Verify the installation:
```
go version
```
You should see go version go1.24.0 in the output.
Build the frontend: Navigate to the web directory and install dependencies:
```
cd web
npm install
```
Build the frontend for release (this places the files in the correct location for embedding):
```
npm run release
```
This will output the built files to ../server/router/frontend/dist.
Build the backend: Run the build script:
```
cd ..
bash scripts/build.sh
```
This will create the memos executable in the ./build directory.
Run the application:
```
./build/memos --mode dev
```

The application should now be accessible at http://localhost:5230 with the embedded frontend.