← Go back

Install CodeScene on Windows

Download the CodeScene setup app. It checks your PC, prepares Docker Desktop, and gets CodeScene running on your own machine — usually in 5–15 minutes.

  • Windows 10 (version 2004 or later) or Windows 11 — Windows Server isn’t supported
  • 15 GB free disk space and 8 GB RAM recommended
  • Docker Desktop is installed for you if needed — Windows may ask for permission
  • Your code stays on your computer

Download for Windows

Pick the installer that matches your PC.

Windows installer (.msi). Always the latest release.

Not sure which one to choose?

Open Settings → System → About and look at System type. If it says x64-based processor, choose x64. If it says ARM-based processor, choose Arm64. Most PCs use x64.

Installation requirements

  • Supported versions: Windows 10 (version 2004 or later) or Windows 11. Run setup while signed in as the person who will use CodeScene. Windows Server isn’t supported.
  • Administrator approval when requested: Windows asks for permission only if Docker Desktop needs to be installed or removed.
  • Enough disk space and memory: we recommend at least 15 GB of free space on your system drive and 8 GB of RAM.
  • Docker Desktop terms: if setup installs Docker Desktop, review and accept Docker’s terms. A paid subscription may be required for some organizations.
  • Virtualization or VPN: if setup mentions virtualization or a VPN, just follow the on-screen guidance.
  • Restarts: if Windows needs a restart while Docker Desktop is being installed, setup resumes after you sign in again.

Installation

  1. Download and open setup. Download the installer that matches your PC (x64 or Arm64) and run it. The installer copies the CodeScene setup app to your PC and adds it under Start → CodeScene. When it finishes, choose Open CodeScene setup or open that Start menu shortcut. The app checks your computer before making any changes.
  2. Prepare Docker Desktop. CodeScene runs in Docker. If Docker Desktop isn’t on your computer yet, setup downloads and verifies it from Docker and installs it for you. Windows may ask for your permission.
  3. Choose your setup. Pick Recommended to get going right away, or Advanced to set the port, time zone, database, Git access, and more.
  4. Choose repositories (optional). Select the local Git repositories you want to analyze. CodeScene works on a copy, so your originals stay untouched. You can always add more later.
  5. Review and install. Check the summary and select Install. You can follow the progress as CodeScene is downloaded and started.
  6. Open CodeScene. When setup is done, open CodeScene in your browser and explore your first analysis: select Open CodeScene in the setup dashboard, or go to localhost:3003. If you chose a different port in Advanced settings, use that port instead of 3003.
Manage CodeScene later. Open Start → CodeScene → CodeScene setup. The dashboard lets you start or stop CodeScene, open it in your browser, change settings, add repositories, or uninstall.

Next steps

Frequently asked questions

Do I need to set up Docker Desktop myself?

No. If Docker Desktop isn’t installed, the setup app downloads it directly from Docker, verifies it, and installs it for you. Windows may ask for your permission or a restart along the way.

What Windows version and computer resources do I need?

Windows 10 version 2004 (build 19041) or later is required. At least 15 GB of free space on the system drive and 8 GB of memory are recommended. Setup checks your computer and lets you know about anything that needs attention before it installs. Windows Server isn’t supported.

Will I need administrator access?

Only if Docker Desktop needs to be installed or removed. In that case Windows asks for permission; everything else runs under your normal user account. Run setup while signed in as the person who will use CodeScene.

What happens to my repositories and analysis data?

CodeScene analyzes a copy of each repository you select, so your original folders are never changed. Everything stays on your computer. You can skip repositories during setup and add them later, and when uninstalling you decide whether to keep or remove your analysis data.

How long does installation take, and what if Windows restarts?

Most installations take about 5–15 minutes, depending on download speed and whether Docker Desktop is already installed. If a restart is required, setup resumes after you sign back in. Keep the setup window open while installation is running.

What does the Windows installer (MSI) install?

The MSI copies the CodeScene setup app to %ProgramFiles%\CodeScene\ and adds a CodeScene setup shortcut under Start → CodeScene. It does not install CodeScene itself — that happens when you run the setup app. You only need to run the MSI again when you want to upgrade the setup app; day-to-day management is always through CodeScene setup.

How do I start, stop, or open CodeScene later?

Open Start → CodeScene → CodeScene setup. The dashboard shows whether CodeScene is running and lets you start or stop it, open it in your browser, add repositories, change settings, or uninstall. CodeScene is available at localhost:3003 by default.

What does Docker Desktop cost?

Docker Desktop is free for some uses, including personal use, education, non-commercial open-source projects, and small businesses. Larger organizations may need a paid subscription. Check Docker’s current pricing and terms before installing it for work.

Something didn’t work. How do I get help?

First, follow the guidance shown in the setup app. If you’re on a VPN, try disconnecting and running setup again. Still stuck? Select Save diagnostics in the dashboard and attach the file when you contact CodeScene support. We’ll help you get up and running.

Is CodeScene on-prem free?

Yes, you can try CodeScene on-prem free of charge under our terms. Docker Desktop is licensed separately by Docker; see the question above about Docker Desktop pricing.

Ready to try CodeScene?

Download the setup app for Windows 10 and 11 and have CodeScene running in about 15 minutes.

New free trial flow | Windows installation guide (Clone)