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 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 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 && 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 - https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/master/pub.gpg | sudo apt-key add -

Add the repository:

echo 'deb https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/repos/debs/ 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:

rpm --import https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/master/pub.gpg

Add the repository:

  • Fedora/RHEL:
    sudo tee -a /etc/yum.repos.d/vscodium.repo << 'EOF'
    [gitlab.com_paulcarroty_vscodium_repo]
    name=gitlab.com_paulcarroty_vscodium_repo
    baseurl=https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/repos/rpms/
    enabled=1
    gpgcheck=1
    repo_gpgcheck=1
    gpgkey=https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/master/pub.gpg
    EOF
    
  • openSUSE/SUSE:
    sudo tee -a /etc/zypp/repos.d/vscodium.repo << 'EOF'
    [gitlab.com_paulcarroty_vscodium_repo]
    name=gitlab.com_paulcarroty_vscodium_repo
    baseurl=https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/repos/rpms/
    enabled=1
    gpgcheck=1
    repo_gpgcheck=1
    gpgkey=https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/master/pub.gpg
    EOF
    

Install the software:

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

Flatpak Option (Linux)

VSCodium is not available as a Flatpak app, but @amtlib-dot-dll has done significant work to package up the open source build of Visual Studio Code without telemetry, very similarly to VSCodium. That package is available here and the build repo is here.

More Info

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