You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs(readme): update the services shipped and emergency uninstall docs.
- Update Services shipped:
- Remove `Acrylic` from the services shipped with valet table.
- Add `Acrylic` to the auto-downloaded services table.
- Update all auto-downloaded services versions to the latest versions and change the date using the ISO 8601 date format.
- Update emergency uninstall:
- Change all paths to use the new "Emergency Uninstall" directory.
- Add an important note in the section for the Ansicon `The system cannot find the path specified` error.
- Add descriptions of the new "Emergency Uninstall" directory.
|[Acrylic DNS Proxy](https://mayakron.altervista.org/support/acrylic/Home.htm)| 2.1.0 |
158
-
|[ngrok](https://ngrok.com/)| 3.3.1 |
155
+
| Service | Version |
156
+
| --------------------------: | ------- |
157
+
|[ngrok](https://ngrok.com/)| 3.3.1 |
159
158
160
159
> [!IMPORTANT]
161
160
> ngrok may error out that it is "too old" when running it for some accounts. In the upcoming v3.2.0 release, Valet will ship with the latest version of ngrok.
@@ -166,14 +165,15 @@ Valet ships with and installs these services:
166
165
>
167
166
> For both commands, valet automatically appends the config file location as a flag to the command, so ngrok will already know where the config file is.
168
167
169
-
As of v3.2.0, Valet no longer ships with the executables for the following services, instead they will be downloaded and installed automatically from GitHub's API. This is so that the latest versions with bug fixes and security updates can be installed.
168
+
As of v3.2.0 and v3.3.0, Valet no longer ships with the executables for the following services, instead they will be downloaded and installed automatically from it's online source (GitHub, SourceForge, etc.). This is so that the latest versions with bug fixes and security updates can be installed.
|[Acrylic DNS Proxy](https://mayakron.altervista.org/support/acrylic/Home.htm)| 2.2.1 |
177
177
178
178
> [!IMPORTANT]
179
179
>
@@ -1537,17 +1537,25 @@ Doesn't affect valet functionality.
1537
1537
1538
1538
## Emergency Stop and Uninstall Services
1539
1539
1540
-
As of v3.1.6, Valet has an emergency stop and uninstall services script. This script is copied to the `/.config/valet` directory for safe keeping.
1540
+
As of v3.1.6, Valet has an emergency stop and uninstall services script. This script is copied to the `/.config/valet/Emergency Uninstall` directory for safe keeping.
1541
1541
1542
1542
So if `composer global update` is ran before valet is uninstalled, and several running services prevent composer from removing the files and updating valet, then you can run the `emergency_uninstall_services.bat` file to stop and uninstall the services.
1543
1543
1544
1544
To run, open a CMD terminal with Admin privileges and run this:
All services will have been stopped and you can then be able to run `composer global update`.
1550
+
Alternatively, find it in the File Explorer and double clicking the file will also run it.
1551
+
1552
+
All services will have been stopped and removed and you can then be able to run `composer global update`.
1553
+
1554
+
> [!IMPORTANT]
1555
+
>
1556
+
> If you receive the `The system cannot find the path specified` error or similar while installing valet, then usually it's to do with Ansicon leaving it's path in the registry after uninstalling, which then fails Valet's installation.
1557
+
>
1558
+
> The emergency uninstall script can help to uninstall Ansicon again and hopefully fully removing it from the registry.
1551
1559
1552
1560
## Valet Directories
1553
1561
@@ -1595,7 +1603,13 @@ Upon installation, Valet creates the following directories and config files:
This is an batch file to do an emergency stop and uninstall of all services. See the [Emergency Stop and Uninstall Services section](#emergency-stop-and-uninstall-services).
1600
1614
1601
1615
> [!WARNING]
@@ -1657,7 +1671,9 @@ Upon installation, Valet creates the following directories and config files:
1657
1671
1658
1672
- If there is a large error and it's file trace output to the terminal, the top of the error may be cut off/overwritten. Apparently Symfony can only write to the terminal that is viewable, if it goes outside of the viewable area (ie. you need to scroll up to view) then the output is overwritten and the most important part of the error, the description at the start is cut off. (See https://github.com/symfony/symfony/issues/35012). If this happens, make the terminal larger in height and try the command again to try and view the full error.
1659
1673
1660
-
- When trying to install Valet after updating via Composer, and you receive this error or similiar: `The system cannot find the path specified`; it could be that Ansicon hasn't uninstalled properly and left it's path in the registry. Because it happens unpredictably, there is no way of debugging or fixing it. The only "workaround" is to use the emergency uninstall script (`emergency_uninstall_services.bat`) in the `C:\Users\Stuart\.config\valet\Emergency Uninstall` directory to allow Ansicon another chance to uninstall itself properly. (See [issue 28](https://github.com/yCodeTech/valet-windows/issues/28)).
1674
+
- When trying to install Valet after updating via Composer, and you receive this error or similiar: `The system cannot find the path specified`; it could be that Ansicon hasn't uninstalled properly and left it's path in the registry. Because it happens unpredictably, there is no way of debugging or fixing it.
1675
+
1676
+
The only "workaround" is to use the emergency uninstall script (`emergency_uninstall_services.bat`) in the `~/.config/valet/Emergency Uninstall` directory to allow Ansicon another chance to uninstall itself properly. (See [issue 28](https://github.com/yCodeTech/valet-windows/issues/28)). See the [Emergency Stop and Uninstall Services section](#emergency-stop-and-uninstall-services).
0 commit comments