> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.knapsack.cloud/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.knapsack.cloud/_mcp/server.

# System Prerequisites

## Overview

**Following these prerequisites will enable you to utilize Knapsack's full potential and avoid common setup issues.** If your system already meets these requirements, you can proceed directly to the setup and running of your Knapsack workspace.

## Operating System Requirements

Knapsack requires a POSIX-compliant environment to run properly. This means you can run Knapsack on:

* Linux
* macOS
* Windows (with Windows Subsystem for Linux/WSL enabled)

### **Windows Users**

If you're running Windows, you'll need to have WSL installed and enabled. Please refer to [Microsoft's official WSL installation guide](https://learn.microsoft.com/en-us/windows/wsl/install) for setup instructions.

**Note:** Running Knapsack directly on Windows (without WSL) is not supported and may cause render errors or other unexpected behavior.

## Software Requirements

Knapsack workspaces build and run locally on your machine, so you need to install a few software packages. The following software must be installed before you set up and run Knapsack on your local machine:

| **Software**                | **Description**                                                  |
| --------------------------- | ---------------------------------------------------------------- |
| **Git**                     | Version control system for tracking changes in your code.        |
| **Node.js v18 or v20**      | JavaScript runtime (NVM recommended for managing Node versions). |
| **npm version 7 or higher** | Package manager for JavaScript.                                  |
| **Yarn 1.22.19**            | Alternative to npm, optimized for speed.                         |
| **Python 3**                | Programming language for various build and deployment scripts.   |

## Supported Browsers

| Browser    | Supported Versions        |
| ---------- | ------------------------- |
| Chrome     | The last 4 major versions |
| Firefox    | The last 3 major versions |
| Safari     | The last 2 major versions |
| iOS Safari | The last 2 major versions |

## Twig renderer

As the Twig renderer relies on PHP, the following packages must also be installed:

| Software             | Description                     |
| -------------------- | ------------------------------- |
| **PHP 8.1 or later** | Server-side scripting language. |
| **Composer**         | Dependency manager for PHP.     |