> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.bearsampp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Bearsampp on Windows

> Download and set up Bearsampp on Windows 10 or 11. Requires administrator rights. No installer — just extract the ZIP and run bearsampp.exe.

Bearsampp has no installer. You download a ZIP archive, extract it to the folder of your choice, and launch `bearsampp.exe`. The entire stack lives inside that one folder — nothing is written outside of it.

## System requirements

* **Windows 10 or Windows 11** (64-bit)
* **Administrator privileges** — required to install and manage Windows services
* At least **500 MB of free disk space** (more if you plan to add additional module versions)

## Download and setup

<Steps>
  <Step title="Download the latest release">
    Go to the [Bearsampp releases page](https://github.com/Bearsampp/Bearsampp/releases/latest) and download the latest `.zip` file.
  </Step>

  <Step title="Choose an installation folder">
    Decide where you want to run Bearsampp from. Good options include:

    * `C:\bearsampp` — a dedicated folder on your system drive
    * `D:\bearsampp` — a secondary drive
    * The root of a USB drive, such as `E:\bearsampp`

    <Warning>
      Avoid paths that contain spaces or special characters (such as `C:\My Projects\bearsampp` or `C:\Users\John Doe\bearsampp`). Some modules do not handle these paths correctly and may fail to start.
    </Warning>
  </Step>

  <Step title="Extract the ZIP archive">
    Right-click the downloaded ZIP file and select **Extract All**, then choose your installation folder as the destination. When extraction finishes, you should have a folder containing `bearsampp.exe` and subdirectories like `bin/`, `www/`, `tools/`, and `apps/`.
  </Step>

  <Step title="Run as Administrator">
    Right-click `bearsampp.exe` and select **Run as administrator**.

    <Note>
      Bearsampp requires administrator privileges to install and manage Windows services. If you launch it without administrator rights, you will see an error prompt with the message: *"bearsampp requires administrator privileges to install and manage Windows services. Please right-click on bearsampp.exe and select 'Run as administrator'."*
    </Note>

    To avoid repeating this step every time, you can configure `bearsampp.exe` to always run as administrator:

    1. Right-click `bearsampp.exe` and select **Properties**
    2. Go to the **Compatibility** tab
    3. Check **Run this program as an administrator**
    4. Click **OK**
  </Step>

  <Step title="Wait for first-launch setup">
    The first time Bearsampp starts, it performs initial setup — checking paths, registering services, and generating configuration files. A loading screen shows the progress. This takes a few seconds.

    Once setup completes, the Bearsampp bear icon appears in your Windows system tray and all bundled services start automatically.
  </Step>
</Steps>

## What happens on first launch

When Bearsampp starts for the first time:

* **Windows services are installed** for Apache, MySQL, MariaDB, PostgreSQL, and other enabled binaries
* **The system tray icon appears** — right-click it to access the full menu
* **All enabled services start automatically** — you can verify this by opening `http://localhost` in your browser, which loads the Bearsampp dashboard
* **Log files are created** in the `logs/` directory inside your Bearsampp folder

<Tip>
  If any service fails to start on first launch, check that the required port is not already in use by another application. Apache uses port 80 by default, MySQL uses 3306, and PostgreSQL uses 5432. You can change any of these from the tray menu.
</Tip>

## Portability note

Because Bearsampp is self-contained, you can move the entire folder to a different location at any time — including onto a USB drive. When you launch `bearsampp.exe` from the new location, it detects the path change and updates its configuration automatically.

This makes Bearsampp suitable for carrying your full development environment between machines, keeping it on external storage, or maintaining separate installations for different projects.

Now that Bearsampp is running, head to the [quickstart guide](/quickstart) to serve your first project.