Skip to main content

Building Floorp on Linux

danger

We cannot provide support if a build fails. Please understand this before proceeding with the following steps.

danger

As of August 21, 2025, Floorp can be built on WSL2 but is not functional for development use.

Requirements

Machine Specifications

  • Memory: Minimum 4GB RAM, 8GB+ recommended.
  • Disk Space: At least 40GB of free disk space.
  • Operating System: The latest version of Ubuntu.

Required Tools

Installation steps

  1. Install Deno:
curl -fsSL https://deno.land/install.sh | sh
  1. Clone the Floorp repository:
git clone https://github.com/Floorp-Projects/Floorp
cd Floorp
  1. Install dependencies:
deno install
  1. Build Floorp:
deno task dev

First run downloads the binary from GitHub Actions. A browser will launch and automatically reload when you change the source code (using hot reload or HMR if supported), so you won't need to restart.

Congratulations! You have successfully built Floorp!