Skip to content
Pankha Fan Control - Docs

Building from Source

For developers who want to modify the code 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”

For active development with hot-reload:

Backend

Section titled “Backend”
Terminal window
cd backend
npm install
npm run dev

Frontend

Section titled “Frontend”
Terminal window
cd frontend
npm install
npm run dev

Build Agents

Section titled “Build Agents”

Linux Agent (Rust)

Section titled “Linux Agent (Rust)”
target/release/pankha-agent
cd agents/clients/linux/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.