Free/Libre Open Source Software Binaries of VSCode

VSCodium is a community-driven, freely-licensed binary distribution of Microsoft’s editor VSCode

current release windows_build_status build status license Gitter

Why Does This Exist

Microsoft’s vscode source code is open source (MIT-licensed), but the product available for download (Visual Studio Code) is licensed under this not-FLOSS license and contains telemetry/tracking. According to this comment from a Visual Studio Code maintainer:

When we [Microsoft] build Visual Studio Code, we do exactly this. We clone the vscode repository, we lay down a customized product.json that has Microsoft specific functionality (telemetry, gallery, logo, etc.), and then produce a build that we release under our license.

When you clone and build from the vscode repo, none of these endpoints are configured in the default product.json. Therefore, you generate a “clean” build, without the Microsoft customizations, which is by default licensed under the MIT license

The VSCodium project exists so that you don’t have to download+build from source. This project includes special build scripts that clone Microsoft’s vscode repo, run the build commands, and upload the resulting binaries for you to GitHub releases. These binaries are licensed under the MIT license. Telemetry is disabled.

If you want to build from source yourself, head over to Microsoft’s vscode repo and follow their instructions. VSCodium exists to make it easier to get the latest version of MIT-licensed VSCode.

Use a Package Manager

Install with Brew (Mac)

If you are on a Mac and have Homebrew installed:

brew cask install vscodium

Note for Mac OS X Mojave users: if you see “App can’t be opened because Apple cannot check it for malicious software” when opening VSCodium the first time, you can right-click the application and choose Open. This should only be required the first time opening on Mojave.

Install with Windows Package Manager (WinGet)

If you use Windows and have Windows Package Manager installed:

winget install vscodium

Install with Chocolatey (Windows)

If you use Windows and have Chocolatey installed (thanks to @Thilas):

choco install vscodium

Install with Scoop (Windows)

If you use Windows and have Scoop installed:

scoop bucket add extras
scoop install vscodium

Install with Package Manager (Linux)

Parrot OS:

VSCodium is pre-installed in Parrot OS.

In case you don’t find it by default, you can retrieve it from the official Parrot repo

sudo apt update && sudo apt install vscodium

@paulcarroty has set up a repository for VSCodium here. The instructions below are adapted from there. Any issues installing VSCodium using your package manager should be directed to that repository’s issue tracker.

Debian / Ubuntu (deb package):

Add the GPG key of the repository:

wget -qO - | gpg --dearmor | sudo dd of=/etc/apt/trusted.gpg.d/vscodium.gpg

Add the repository:

echo 'deb vscodium main' | sudo tee --append /etc/apt/sources.list.d/vscodium.list

Update then install vscodium:

sudo apt update && sudo apt install codium

Fedora / Centos / OpenSUSE (rpm package):

Add the GPG key of the repository:

sudo rpm --import

Add the repository:

  • Fedora/RHEL:
    printf "[gitlab.com_paulcarroty_vscodium_repo]\nname=gitlab.com_paulcarroty_vscodium_repo\nbaseurl=\nenabled=1\ngpgcheck=1\nrepo_gpgcheck=1\ngpgkey=" |sudo tee -a /etc/yum.repos.d/vscodium.repo
  • openSUSE/SUSE:
    printf "[gitlab.com_paulcarroty_vscodium_repo]\nname=gitlab.com_paulcarroty_vscodium_repo\nbaseurl=\nenabled=1\ngpgcheck=1\nrepo_gpgcheck=1\ngpgkey=" |sudo tee -a /etc/zypp/repos.d/vscodium.repo

Install the software:

  • Fedora/RHEL:
    sudo dnf install codium
  • OpenSUSE/SUSE:
    sudo zypper in codium


VSCodium is available in Nixpkgs. You can install it by adding vscodium to environment.systemPackages in configuration.nix, or locally:

nix-env -iA nixpkgs.vscodium

Arch Linux

VSCodium is available on the AUR (Arch User Repository) here, and can be installed with an AUR Helper.


  • Aura:
    sudo aura -A vscodium-bin
  • Yay:
    yay -S vscodium-bin

Flatpak Option (Linux)

VSCodium is (unofficially) available as a Flatpak app here and the build repo is here. If your distribution has support for flatpak, and you have enabled the flathub repo:

flatpak install flathub com.vscodium.codium

flatpak run com.vscodium.codium

More Info

The most up-to-date information on migrating from Visual Studio Code and other quirks you might encounter are documented here.