# Quickstart First Deployment Errors on Windows

**URL:** <https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845>\
**Category:** Developers\
**Created:** [January 23, 2021, 3:41pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845 "2021-01-23T15:41:47Z")\
**Posts on this page:** 18\
**Page:** 1

<div class="post-metadata">

**Author:** ![evanmcfarland](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/evanmcfarland/32/1744_2.png) [@evanmcfarland](https://forum.dfinity.org/u/evanmcfarland)\
**Post date:** [January 23, 2021, 3:41pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/1 "2021-01-23T15:41:47Z")

</div>

I’m having trouble getting past the quickstart local and network deployment tutorial. I am completely new at this so it could be something stupid but I can’t get anything to deploy.

I’m using a Windows computer with Ubuntu subsystem for Linux CLI. It’s my understanding that it works here too. I have installed and updated dfx, node.js, VSCode. Now here are some of the problem points.

Quickstart local development tab (got up to)  
$ dfx canister create hello  
returns code: 111 “tcp connect error”

Quickstart network development tab (got up to)  
$ dfx deploy --network=ic  
after trying to build canisters it returns httperror and does not deploy

One problem I get is when installing “brew” and going through the process, brew --version is never recognized but I thought this doesn’t matter since I have node. Has anyone had similar problems and know how to fix? Thank you.

---

<div class="post-metadata">

**Author:** ![Ori](https://avatars.discourse-cdn.com/v4/letter/o/ecae2f/32.png) [@Ori](https://forum.dfinity.org/u/Ori)\
**Post date:** [January 23, 2021, 6:34pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/2 "2021-01-23T18:34:18Z")

</div>

Check you’re using WSL version 2, as per this: [https://forum.dfinity.org/t/native-windows-support/1241/2?u=ori](https://forum.dfinity.org/t/native-windows-support/1241/2)

Also make sure you’re using two terminal windows, with `dfx start` left running in one of them.

---

<div class="post-metadata">

**Author:** ![evanmcfarland](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/evanmcfarland/32/1744_2.png) [@evanmcfarland](https://forum.dfinity.org/u/evanmcfarland)\
**Post date:** [January 24, 2021, 2:18pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/3 "2021-01-24T14:18:03Z")

</div>

Switching to WSL version 2 got me over the hump. Didn’t realize everything that went into this but it’s working now. Thank’s Ori.

---

<div class="post-metadata">

**Author:** ![evanmcfarland](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/evanmcfarland/32/1744_2.png) [@evanmcfarland](https://forum.dfinity.org/u/evanmcfarland)\
**Post date:** [January 24, 2021, 3:44pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/4 "2021-01-24T15:44:15Z")

</div>

My problem persists when trying to create canisters.  
$ dfx canister create --all  
“Could not reach the server”

Dfx is running in a separate cli tab. Any idea what I’m doing wrong Ori?

---

<div class="post-metadata">

**Author:** ![Ori](https://avatars.discourse-cdn.com/v4/letter/o/ecae2f/32.png) [@Ori](https://forum.dfinity.org/u/Ori)\
**Post date:** [January 24, 2021, 7:22pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/5 "2021-01-24T19:22:20Z")

</div>

Try stopping and restarting the `dfx start` command, perhaps using the `dfx start --clean` flag to restore the project’s local network state to default.

---

<div class="post-metadata">

**Author:** ![evanmcfarland](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/evanmcfarland/32/1744_2.png) [@evanmcfarland](https://forum.dfinity.org/u/evanmcfarland)\
**Post date:** [January 24, 2021, 7:36pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/6 "2021-01-24T19:36:29Z")

</div>

No luck there. I’ve been trying those commands and restarting with no luck.

---

<div class="post-metadata">

**Author:** ![Ori](https://avatars.discourse-cdn.com/v4/letter/o/ecae2f/32.png) [@Ori](https://forum.dfinity.org/u/Ori)\
**Post date:** [January 24, 2021, 8:29pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/7 "2021-01-24T20:29:48Z")

</div>

Are you seeing any errors in the dfx start terminal’s output? Has is started up correctly?

---

<div class="post-metadata">

**Author:** ![evanmcfarland](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/evanmcfarland/32/1744_2.png) [@evanmcfarland](https://forum.dfinity.org/u/evanmcfarland)\
**Post date:** [January 24, 2021, 8:36pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/8 "2021-01-24T20:36:07Z")

</div>

```
Jan 24 15:41:34.265 ERRO s:fscpm-uiaaa-aaaaa-aaaap-yai/n:qulyp-lyqyl-zzxe3-5k6gd-cpc6e-reqvx-iwo52-g57sc-4pb37-wwzlr-6ae/ic_consensus/random_tape_maker Couldn't find transcript at height 200 with finalized height 199 and CUP height 0

```

thread ‘replica-actor’ panicked at ‘called `Result::unwrap()` on an `Err` value: Cannot start the replica: Timeout’, src/dfx/src/actors/replica.rs:310:17  
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace

Yes, this is the end of the start terminal output.

---

<div class="post-metadata">

**Author:** ![PaulLiu](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/paulliu/32/4701_2.png) [@PaulLiu](https://forum.dfinity.org/u/PaulLiu)\
**Post date:** [January 26, 2021, 12:24am UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/9 "2021-01-26T00:24:20Z")

</div>

Windows is not an officially supported platform at the moment. What previously worked under WSL or WSL2 might fail to work in new releases. We are aware of this problem, and we are working on supporting Windows developers through WSL.

Unofficially, I myself submitted patches recently to make things work under WSL again (I work for Dfinity). But it’ll take time for the patches to get into next release. Also, unless we have proper CI setup on Windows to catch future failures, we cannot guarantee official support.

The safer (but obviously non-optimal) fallback is to run dfx from a Linux running in VMWare or VirtualBox.

---

<div class="post-metadata">

**Author:** ![evanmcfarland](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/evanmcfarland/32/1744_2.png) [@evanmcfarland](https://forum.dfinity.org/u/evanmcfarland)\
**Post date:** [January 26, 2021, 3:14pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/10 "2021-01-26T15:14:52Z")

</div>

Okay. I actually was able to launch the hello canister a few months ago before WSL2 which now makes sense.

I hope this can be fixed. I shouldn’t have to buy a mac just for development purposes but thanks for letting me know, Paul.

---

<div class="post-metadata">

**Author:** ![cryptoschindler](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/cryptoschindler/32/26_2.png) [@cryptoschindler](https://forum.dfinity.org/u/cryptoschindler)\
**Post date:** [January 26, 2021, 10:56pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/11 "2021-01-26T22:56:43Z")

</div>

You can also connect VSCode to a VM so you don’t have to work inside the guest OS. Just get a Ubuntu Server for that.  
If you want to be able to use vscode, you can enable port forwarding with Virtualbox. For that go to your vm settings \> network \> adapter 1 \> advanced \> port forwarding \> add a rule ( ssh TCP 127.0.0.1 empty 22)

---

<div class="post-metadata">

**Author:** ![evanmcfarland](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/evanmcfarland/32/1744_2.png) [@evanmcfarland](https://forum.dfinity.org/u/evanmcfarland)\
**Post date:** [January 30, 2021, 7:33pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/12 "2021-01-30T19:33:51Z")

</div>

So my computer is not of a type that will run Linux well and the VirtualBox option seems pretty terrible.

I’m considering buying a cheap and crappy Linux compatible computer just for the purposes of learning ICP-related development. Is this a good idea? Should I expect limitations? Advice is much appreciated.

---

<div class="post-metadata">

**Author:** ![Chris](https://avatars.discourse-cdn.com/v4/letter/c/958977/32.png) [@Chris](https://forum.dfinity.org/u/Chris)\
**Post date:** [May 25, 2021, 9:40pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/13 "2021-05-25T21:40:48Z")

</div>

Virtualbox is actually a very common solution for those who use windows, might not be as terrible as you’d think. The plus side of this approach is your development setup can easily be backed up and transferred around.

Edit: I’m super late, but just setting up my own development environment and google brought me here.

thread ‘replica-actor’ panicked at ‘called `Result::unwrap()` on an `Err` value: Cannot start the replica: Timeout’, src/dfx/src/actors/replica.rs:310:17

(… except I’m running Linux)

---

<div class="post-metadata">

**Author:** ![evanmcfarland](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/evanmcfarland/32/1744_2.png) [@evanmcfarland](https://forum.dfinity.org/u/evanmcfarland)\
**Post date:** [June 14, 2021, 2:50pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/14 "2021-06-14T14:50:35Z")

</div>

Also quite late, but I ended up getting a Linux machine and all the issues I was getting on windows went away while doing a second lap on the tutorials section. Still haven’t gotten much info on how/if WSL support changed, but for now, a crappy Linux Thinkpad was the right move.

---

<div class="post-metadata">

**Author:** ![renny](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/renny/32/1270_2.png) [@renny](https://forum.dfinity.org/u/renny)\
**Post date:** [June 14, 2021, 11:37pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/15 "2021-06-14T23:37:56Z")

</div>

I am running the SDK tutorials very nicely on VirtualBox, you might want to try it.

My setup runs Ubuntu 20.04 using 10G RAM and 3 CPU cores and 128MB video. Everything works fine.

---

<div class="post-metadata">

**Author:** ![anguspersonal](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/anguspersonal/32/22098_2.png) [@anguspersonal](https://forum.dfinity.org/u/anguspersonal)\
**Post date:** [December 8, 2024, 3:21pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/16 "2024-12-08T15:21:18Z")

</div>

Hi @PaulLiu is it still the case that Windows is not officially supported?

I am having similar issues with to run the Dfinity starter project on Windows 11 with WSL2.

---

<div class="post-metadata">

**Author:** ![Vivienne](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/vivienne/32/29170_2.png) [@Vivienne](https://forum.dfinity.org/u/Vivienne)\
**Post date:** [December 9, 2024, 12:35pm UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/17 "2024-12-09T12:35:33Z")

</div>

Answered over here: [Issue with 'dfx start' using windows 11 with WSL](https://forum.dfinity.org/t/issue-with-dfx-start-using-windows-11-with-wsl/38580)

---

<div class="post-metadata">

**Author:** ![kevinmcfarlane](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/kevinmcfarlane/32/3220_2.png) [@kevinmcfarlane](https://forum.dfinity.org/u/kevinmcfarlane)\
**Post date:** [December 11, 2024, 11:47am UTC](https://forum.dfinity.org/t/quickstart-first-deployment-errors-on-windows/1845/18 "2024-12-11T11:47:03Z")

</div>

When I first tried the IC tutorials about 18 months ago, it was on Win 10 with WSL2 and I soon ran into issues. I then switched to VMWare and stuff worked. That’s what I’ve been using recently.

I ran into similar issues with other blockchains. I would always come unstuck on Win/WSL
