Skip to content
Pankha Fan Control - Docs

Building from Source

For developers who want to modify Pankha Fan Control or contribute to development.

Prerequisites

Section titled “Prerequisites”
  • Git
  • Docker and Docker Compose
  • Node.js 20+ (for local development)
  • Rust toolchain (for Linux agent)
  • .NET 8 SDK (for Windows agent)

Clone Repository

Section titled “Clone Repository”
Terminal window
git clone https://github.com/Anexgohan/pankha.git
cd pankha

Build Docker Image

Section titled “Build Docker Image”

Build locally instead of pulling from Docker Hub:

Terminal window
docker compose build --no-cache
docker compose up -d

Development Mode

Section titled “Development Mode”

The repository is an npm workspaces monorepo - install once at the root:

Terminal window
npm install
npm run dev              # both: frontend (5173, hot reload) + backend (3000)


# or individually:
npm run dev:frontend
npm run dev:backend


# checks
npm run typecheck
npm run lint

Build Agents

Section titled “Build Agents”

Linux Agent (Rust)

Section titled “Linux Agent (Rust)”
target/release/pankha-agent-linux
cd agents/clients/linux/rust
cargo build --release

IPMI Agent (Rust)

Section titled “IPMI Agent (Rust)”
target/release/pankha-agent-ipmi-linux
cd agents/clients/linux/virtual-agents/host-ipmi-rust
cargo build --release

Windows Agent (.NET 8)

Section titled “Windows Agent (.NET 8)”
Terminal window
cd agents/clients/windows/varient-c
.\build.ps1 -Menu              # Interactive menu
# OR
.\build.ps1 -Clean -Publish -BuildInstaller
# Output: publish/win-x64/installer/pankha-agent-windows_x64.msi

Contributing

Section titled “Contributing”
  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

See the main repository for contribution guidelines.