Files
zulip/docs/development/setup/wsl-rebuild.md
Apoorva Pendse 67a60829e6 docs: Add WSL rebuild steps.
Previously, the rebuild steps for WSL in the recommended setup guide
incorrectly just included the Vagrant instructions.

This commit fixes the issue by adding the appropriate steps to delete
the WSL instance using `wsl --unregister` in the docs.

Additionally, it includes steps to rebuild the development database,
which is a much faster alternative for folks who just want that.

Fixes #32402.
2024-11-27 14:33:18 -08:00

1.3 KiB

If you ever want to recreate your development environment again from scratch (e.g., to test a change you've made to the provisioning process, or because you think something is broken), you can do so using the following steps:

  1. To find the distribution name to unregister (delete), open Command Prompt or PowerShell and use the following command:
$ wsl --list --verbose

If you are unsure about which distribution to unregister, you can log into the WSL distributions to ensure you are deleting the one containing your development environment using the command:

wsl -d <Distribution Name>
  1. To uninstall your WSL distribution, enter the command:
$ wsl --unregister <Distribution Name>

For more information, checkout the official documentation for WSL commands

  1. Next, follow the setup instructions, starting from [Step 1: Install prerequisites]

If you just want to rebuild the development database, the following is much faster:

$ ./tools/rebuild-dev-database

For more details, see the schema migration documentation.