https://github.com/ScoopInstaller/Install
📥 Next-generation Scoop (un)installer
https://github.com/ScoopInstaller/Install
Last synced: 4 months ago
JSON representation
📥 Next-generation Scoop (un)installer
- Host: GitHub
- URL: https://github.com/ScoopInstaller/Install
- Owner: ScoopInstaller
- License: unlicense
- Created: 2019-01-30T07:54:43.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-10-25T04:27:00.000Z (6 months ago)
- Last Synced: 2024-11-27T04:29:50.040Z (5 months ago)
- Language: PowerShell
- Homepage: https://get.scoop.sh
- Size: 58.6 KB
- Stars: 791
- Watchers: 25
- Forks: 100
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - ScoopInstaller/Install - 📥 Next-generation Scoop (un)installer (PowerShell)
README
# Scoop (un)installer
[](https://github.com/ScoopInstaller/Install/actions/workflows/ci.yml)
## Installation
### Prerequisites
[PowerShell](https://aka.ms/powershell) latest version or [Windows PowerShell 5.1](https://aka.ms/wmf5download)
- The PowerShell [Language Mode] is required to be `FullLanguage` to run the installer and Scoop.
- The PowerShell [Execution Policy] is required to be one of `RemoteSigned`, `Unrestricted` or `ByPass` to run the installer. For example, it can be set to `RemoteSigned` via:
```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```
### Typical Installation
Run this command from a **non-admin** PowerShell to install scoop with default configuration,
scoop will be install to `C:\Users\\scoop`.
```powershell
irm get.scoop.sh | iex
# You can use proxies if you have network trouble in accessing GitHub, e.g.
irm get.scoop.sh -Proxy 'http://' | iex
```
### Advanced Installation
If you want to have an advanced installation, you can download the installer and manually execute it with parameters.
```powershell
irm get.scoop.sh -outfile 'install.ps1'
```
To see all configurable parameters of the installer.
```powershell
.\install.ps1 -?
```
For example, you could install scoop to a custom directory, configure scoop to install
global programs to a custom directory, and bypass system proxy during installation.
```powershell
.\install.ps1 -ScoopDir 'D:\Applications\Scoop' -ScoopGlobalDir 'F:\GlobalScoopApps' -NoProxy
```
Or you can use the legacy method to configure custom directory by setting Environment Variables. (**Not Recommended**)
```powershell
$env:SCOOP='D:\Applications\Scoop'
$env:SCOOP_GLOBAL='F:\GlobalScoopApps'
[Environment]::SetEnvironmentVariable('SCOOP_GLOBAL', $env:SCOOP_GLOBAL, 'Machine')
irm get.scoop.sh | iex
```
#### For Admin
Installation under the administrator console has been disabled by default for security considerations. If you know what you are doing and want to install Scoop as administrator. Please download the installer and manually execute it with the `-RunAsAdmin` parameter in an elevated console. Here is the example:
```powershell
irm get.scoop.sh -outfile 'install.ps1'
.\install.ps1 -RunAsAdmin [-OtherParameters ...]
# I don't care about other parameters and want a one-line command
iex "& {$(irm get.scoop.sh)} -RunAsAdmin"
```
### Silent Installation
You can redirect all outputs to Out-Null or a log file to silence the installer. And you can use `$LASTEXITCODE` to check the installation result, it will be `0` when the installation success.
```powershell
# Omit outputs
.\install.ps1 [-Parameters ...] | Out-Null
# Or collect logs
.\install.ps1 [-Parameters ...] > install.log
# Get result
$LASTEXITCODE
```
## License
The project is released under the [Unlicense License](LICENSE) and into the public domain.
[Language Mode]: https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_language_modes
[Execution Policy]: https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies