SCE Windows

SCE Setup – Windows

This document provides step-by-step instructions for installing the STEM Computing Environment (SCE) on your local Windows computer. Complete the steps listed in the Table of Contents in order. Do not skip any steps.

Table of Contents

1. Check for S Mode
2. Meet the prerequisites
3. Prepare your personal computer
4. Step-by-Step
5. Quick Install
6. Troubleshooting

Check for S Mode

Before setting up the course IDE on Windows, we must verify that your computer's security permissions allow you to run software developer tools. It is common for users of computers owned by others to have restricted account privileges. This simple 5-second test will determine if your machine can support local setup of the course IDE, or if you should bypass it and use just the Codio Virtual Desktop (CVD) option.

1. On your keyboard, press the Windows (⊞) + R keys at the same time to open the Run dialog box.

2. Type ms-settings:about and press Enter or click OK.

3. In the System > About window, scroll down to find Windows info. You may need to expand it.

4. Review the Edition line.

   • No S Mode

WindowsProductName WindowsVersion OsBuildNumber
------------------ -------------- -------------
Windows 11 Pro     24H2           26100

1. On your keyboard, press the Windows (⊞) + R keys at the same time to open the Run dialog box.

2. Type cmd into the box and press Enter.

3. Observe what happens on your screen:

   • GO: A terminal window opens and shows a blinking cursor after the command prompt. Your computer's operating system likely allows local command-line tools. Recommendation: Continue with local setup of the course IDE.

   Note. This test only confirms that command-line tools can open. Step 4: Install the Course IDE also requires an administrator account. If you cannot approve an administrator prompt when you reach Step 4, use the CVD instead.

   • NO GO: An error popup appears, or the window immediately closes. Your computer's operating system or employer-managed security policy blocks local command-line tools. You will not be able to install or run the course IDE locally unless you resolve these issues. Recommendation: Use just the CVD. Go to the Codio README.md to configure the CVD, if you have not done so already. Otherwise, return to the main README.md to complete any outstanding tasks.

Meet the prerequisites

1. Windows Edition. Windows 10 or 11 Home, Pro, Enterprise, or Education not "in S Mode". What's this? How to check?

2. **Version

3. A supported version of Windows.

4. An administrator account

Prepare your personal computer

{{Why?}}

1. Update the operating system. How?

2. Restart the computer. How?

3. Create a restore point and label it, Before WinGet upgrades. How?

4. Open a terminal window.

   1. On your keyboard, hold down the Windows (⊞) key and press the X key.
   2. Select Terminal (Admin) or PowerShell (Admin) from the popup menu.

5. Verify WinGet. What's this?. Copy and paste the following command into the terminal and press Enter.

   winget -v

   Expected Output: A version number beginning with v, such as v1.29.380. Your version number will be different from the example. A different version number is normal and does not indicate an error. The key indicator of success is that WinGet displays a version number. If it does, continue to the next step.

   If the command does not display the expected output, follow CLI troubleshooting procedures. Do NOT continue with the remaining setup tasks until this command produces the expected output.

6. Update WinGet sources. Copy and paste the following command block into the terminal and press Enter. What's this?

   winget source update

   Expected Output: You should see messages indicating that all sources are being updated followed by Done for each source. Key indicator of success is that each source shows as Done.

   If the command does not display the expected output, follow CLI troubleshooting procedures. Do NOT continue with the remaining setup tasks until this command produces the expected output.

7. Update installed packages. Copy and paste the following command block into the terminal and press Enter. What is this?

   winget upgrade -r -u --accept-source-agreements --accept-package-agreements

   Expected Output: You should see messages indicating that {{...}}. Your output may vary. Key indicator of success is {{...}}. Note. Some updates may require a restart to complete. This is normal and does not indicate an error.

   If the command does not display the expected output, follow CLI troubleshooting procedures. Do NOT continue with the remaining setup tasks until this command produces the expected output.

8. Restart the computer. How?

9. Create another restore point and label it, Before STEM compute environment install. How?

Step-by-Step

1. Open a terminal window.

   1. On your keyboard, hold down the Windows (⊞) key and press the X key.
   2. Select Terminal (Admin) or PowerShell (Admin) from the popup menu.

2. Install Git. Copy and paste the following command block into the terminal and press Enter. What is this?

   winget install --id Git.Git -e --source winget --accept-source-agreements --accept-package-agreements

   Expected Output: You should see messages indicating that {{...}}. Your output may vary. Key indicator of success is {{...}}.

   If the command does not display the expected output, follow CLI troubleshooting procedures. Do NOT continue with the remaining setup tasks until this command produces the expected output.

3. Install GitHub CLI. Copy and paste the following command block into the terminal and press Enter. What is this?

   winget install --id GitHub.cli -e --source winget --accept-source-agreements --accept-package-agreements

   Expected Output: You should see messages indicating that {{...}}. Your output may vary. Key indicator of success is {{...}}.

   If the command does not display the expected output, follow CLI troubleshooting procedures. Do NOT continue with the remaining setup tasks until this command produces the expected output.

4. Install Python 3. Copy and paste the following command block into the terminal and press Enter. What is this?

   winget install --id Python.Python.3.12 -e --source winget --accept-source-agreements --accept-package-agreements

   Expected Output: You should see messages indicating that {{...}}. Your output may vary. Key indicator of success is {{...}}.

   If the command does not display the expected output, follow CLI troubleshooting procedures. Do NOT continue with the remaining setup tasks until this command produces the expected output.

5. Install VS Code. Copy and paste the following command block into the terminal and press Enter. What is this?

   winget install --id Microsoft.VisualStudioCode -e --source winget --accept-source-agreements --accept-package-agreements

   Expected Output: You should see messages indicating that {{...}}. Your output may vary. Key indicator of success is {{...}}.

   If the command does not display the expected output, follow CLI troubleshooting procedures. Do NOT continue with the remaining setup tasks until this command produces the expected output.

Quick Install

1. Open a terminal window.

   1. On your keyboard, hold down the Windows (⊞) key and press the X key.
   2. Select Terminal (Admin) or PowerShell (Admin) from the popup menu.

2. Verify WinGet. What's this?. Copy and paste the following command into the terminal and press Enter.

   winget -v

   Expected Output: A version number in the format v1.x.x. The key indicator of success is that WinGet displays a version number. If it does, continue to the next step.

   If the command does not display the expected output, follow CLI troubleshooting procedures. Do NOT continue with the remaining setup tasks until this command produces the expected output.

3. Install the STEM computing tools. Copy and paste the following command block into the terminal and press Enter to run the commands.

   winget source update
   winget install --id Git.Git -e --source winget --accept-source-agreements --accept-package-agreements
   winget install --id GitHub.cli -e --source winget --accept-source-agreements --accept-package-agreements
   winget install --id Python.Python.3.12 -e --source winget --accept-source-agreements --accept-package-agreements
   winget install --id Microsoft.VisualStudioCode -e --source winget --accept-source-agreements --accept-package-agreements

   Expected Output: You should see messages indicating that package sources were updated and required applications were installed, updated, or are already installed. Your output may vary. The key indicator of success is that each command completes without errors.

   If the commands do not display the expected output, follow CLI troubleshooting procedures. Do NOT continue with the remaining setup tasks until this command produces the expected output.

4. Restart the computer. How?

Troubleshooting

Check Windows version