Development Setup

Set up your local environment to build and develop Anubis

This guide walks you through setting up your development environment for Anubis.

Prerequisites

Required Software

• Go 1.24+ (specifically Go 1.24.2 or later)
• Node.js (any supported LTS version)
• esbuild (for JavaScript bundling)
• gzip, zstd, brotli (for asset compression)

macOS Installation

If you’re using Homebrew, install all dependencies with:

brew bundle

This will install:

• go@1.24
• node
• esbuild
• zstd
• brotli
• ko (for container builds)

Linux Installation

Install using your distribution’s package manager:

# Debian/Ubuntu
sudo apt install golang nodejs npm esbuild gzip zstd brotli

# Fedora/RHEL
sudo dnf install golang nodejs npm esbuild gzip zstd brotli

# Arch Linux
sudo pacman -S go nodejs npm esbuild gzip zstd brotli

Clone the Repository

Clone the Anubis repository:

git clone https://github.com/TecharoHQ/anubis.git
cd anubis

Install Dependencies

Install Node.js dependencies using npm ci (clean install):

npm ci

Use npm ci instead of npm install to ensure you get the exact dependency versions from package-lock.json.

Install Go module dependencies:

go mod download

Verify Installation

Verify your Go version:

go version
# Should output: go version go1.24.2 or higher

Verify your Node.js version:

node --version
npm --version

Next Steps

Now that your environment is set up, proceed to:

• Building Anubis to compile the project
• Testing to run the test suite
• Contributing to learn about commit requirements