Coda on Windows

From Coda Wiki
Jump to navigation Jump to search


Running directly on Windows is not officially supported at this time. However, there are some workarounds to let you connect to the Coda network from an Ubuntu environment running on your Windows machine or in the cloud.

Regardless of the workaround you pick, once you have access to an Ubuntu environment from your Windows PC, proceed with following the instructions given to Ubuntu users.

👋If you're interested in working on native Windows support, come join the Discord and let us know or check out the Coda grants program.

Windows Subsystem for Linux (WSL)

This is probably the most straightforward way to get a Coda experience similar to Linux users. WSL is free, supported on most Windows 10 PCs, and doesn't require messing with a cloud provider. Unfortunately, Coda uses Linux features that aren't supported by the first version of WSL. WSL2, however, does work.

How to run Coda node using Windows Subsystem for Linux:

  • Enable WSL1 via powershell. Open PowerShell as Administrator and paste this command:
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
  • Update to WSL2. See the notes in the Microsoft docs about how to do this. You will need to be running a very recent version of Windows 10.
  • Restart your PC
  • Install Ubuntu 18.04 from the Microsoft Store
  • Run Ubuntu 18.04 and wait until installation complete
  • Choose username and password
  • You're ready to go! Continue by following the instructions for running on Ubuntu.

See here for more details.

Cloud VM

One option is to use a Ubuntu Virtual Machine (VM) on a cloud provider. Some providers offer free trials, e.g. Google Cloud Platform offers $300 free credit for new users. A cloud VM can be a little tricky to set up and manage at times, depending on the cloud provider, but one big advantage for someone trying to stake on the Coda network is that they can safely shut down their personal computer while the cloud machine continues to stake.

See Coda in the Cloud for more information.

Local VM

If you don't want to deal with a cloud provider, you can also create a VM on your local computer. There are several options for this.

Hyper-V

Hyper-V is a first-party Windows product that can create VMs on your local computer. If your machine supports it, it can be another alternative to using WSL.

You can follow these guides to enable Hyper-V on your machine and then use it to create a VM.

Other Virtualization Tools

If your computer doesn't support Hyper-V, you can also use tools like VirtualBox or VMWare to create local Ubuntu VMs.

Either way, you'll want to create an Ubuntu VM, and then follow any Coda instructions for Ubuntu users.