Add Troubleshooting for Linux and Windows to README #250

2025-10-20T23:22:22Z

Celshade commented

2025-10-20 23:22:22 +00:00

(Migrated from github.com)

Cheers ☕

After testing and assisting with several builds on both Linux and Windows, I've fleshed out details for two new troubleshooting sections - one for each OS, respectively. All official links are provided and embedded into the markdown with commands added where appropriate.

Cheers ☕ After testing and assisting with several builds on both Linux and Windows, I've fleshed out details for two new troubleshooting sections - one for each OS, respectively. All official links are provided and embedded into the markdown with commands added where appropriate.

parabitdev (Migrated from github.com) reviewed

2025-11-21 10:51:56 +00:00

parabitdev (Migrated from github.com) left a comment

Some minor non-blocking nits.

Holding off on approving strictly for second opinion on windows section from paratoxic, but currently see no reason it shouldn't be approved.

Some minor non-blocking nits. Holding off on approving strictly for second opinion on windows section from paratoxic, but currently see no reason it shouldn't be approved.

README.md

					
				@ -64,11 +64,11 @@ Setup

				### Requirements:

* [Just](https://github.com/casey/just?tab=readme-ov-file#installation) (optional)

```suggestion * [Just](https://github.com/casey/just?tab=readme-ov-file#installation) (optional) ```

README.md

					
				@ -132,3 +132,31 @@ These versions can be verified with:

				rustc --version

				gcc --version

Style nit, I generally would avoid starting a list element with an inline codeblock.

README.md

Windows details look correct, but no windows environment available locally to validate, @paratoxicdev can you take a peak at this as well?

Celshade (Migrated from github.com) reviewed

2025-11-25 15:36:07 +00:00

README.md

					
				@ -132,3 +132,31 @@ These versions can be verified with:

				rustc --version

				gcc --version

We did the same thing here (attached), so I didn't think much of it, but I'll re-word it 👍🏼

We did the same thing here (attached), so I didn't think much of it, but I'll re-word it 👍🏼 <img width="644" height="180" alt="image" src="https://github.com/user-attachments/assets/25a1bc81-6192-4166-80ad-5021d089d1a5" />

Celshade (Migrated from github.com) reviewed

2025-11-25 15:39:17 +00:00

README.md

Would love the confirmation; however, if it helps, I also went through this in a full installation tutorial as well:
https://www.youtube.com/watch?v=f8V2BSsor_I (02:56)

Would love the confirmation; however, if it helps, I also went through this in a full installation tutorial as well: https://www.youtube.com/watch?v=f8V2BSsor_I (02:56)

Celshade (Migrated from github.com) reviewed

2025-11-25 15:47:56 +00:00

README.md

					
				@ -132,3 +132,31 @@ These versions can be verified with:

				rustc --version

				gcc --version

Re-worded to the following

Re-worded to the following <img width="655" height="170" alt="image" src="https://github.com/user-attachments/assets/c080b26d-96af-4071-8e35-0a11a041a102" />

parabitdev (Migrated from github.com) reviewed

2025-11-26 10:15:04 +00:00

README.md

					
				@ -132,3 +132,31 @@ These versions can be verified with:

				rustc --version

				gcc --version

You are correct, I wonder why I didn't notice it there. Could be because of them being only version text after, will take a peek back at that :D

Celshade (Migrated from github.com) reviewed

2025-11-29 08:59:34 +00:00

README.md

As odd as it sounds, this is actually a thing on Windows lol the MSVC option requires Visual Studio with Microsoft Build Tools (a VS package), and is literally defined as "Microsoft Visual C++". Rust will actually prompt you to install it when choosing this ABI, or tell you to install it yourself. It is mandatory to use one of these two ABIs if you're going to build with Rust on this OS. Welcome to Windows funsies 😜

If you watch the tutorial I made Installing Para, you can see the rust installer prompt you as mentioned above -> 03:34 timestamp. Here is a screenshot to verify it as well:

As odd as it sounds, this is actually a thing on Windows lol the MSVC option requires Visual Studio with Microsoft Build Tools (a VS package), and is literally defined as "Microsoft Visual C++". Rust will actually prompt you to install it when choosing this ABI, or tell you to install it yourself. It is mandatory to use one of these two ABIs if you're going to build with Rust on this OS. Welcome to Windows funsies 😜 <img width="666" height="124" alt="image" src="https://github.com/user-attachments/assets/470d2ce2-d93e-4317-86bd-3be07e564b1e" /> <img width="609" height="116" alt="image" src="https://github.com/user-attachments/assets/741d94e3-d551-4f81-9c5b-46ab05910ae6" /> If you watch the tutorial I made [Installing Para](https://www.youtube.com/watch?v=f8V2BSsor_I), you can see the rust installer prompt you as mentioned above -> 03:34 timestamp. Here is a screenshot to verify it as well: <img width="1094" height="398" alt="image" src="https://github.com/user-attachments/assets/650b2a9c-899c-4423-9547-780df6dc1d0a" />

Sign in to join this conversation.

No reviewers