mirror of
https://github.com/AikidoSec/safe-chain.git
synced 2026-05-26 12:10:49 +00:00
89 lines
2.2 KiB
Markdown
89 lines
2.2 KiB
Markdown
# Migrating from npm global tool to binary installation
|
|
|
|
If you previously installed safe-chain as an npm global package, you need to migrate to the binary installation.
|
|
|
|
Depending on the version manager you're using, the uninstall process differs:
|
|
|
|
### Standard npm (no version manager)
|
|
|
|
1. **Clean up shell aliases:**
|
|
|
|
```bash
|
|
safe-chain teardown
|
|
```
|
|
|
|
2. **Restart your terminal**
|
|
|
|
3. **Uninstall the npm package:**
|
|
|
|
```bash
|
|
npm uninstall -g @aikidosec/safe-chain
|
|
```
|
|
|
|
4. **Install the binary version** (see [Installation](../README.md#installation))
|
|
|
|
### nvm (Node Version Manager)
|
|
|
|
**Important:** nvm installs global packages separately for each Node version, so safe-chain must be uninstalled from each version where it was installed.
|
|
|
|
1. **Clean up shell aliases:**
|
|
|
|
```bash
|
|
safe-chain teardown
|
|
```
|
|
|
|
2. **Restart your terminal**
|
|
|
|
3. **Uninstall from all Node versions:**
|
|
|
|
**Option A** - Automated script (recommended):
|
|
|
|
```bash
|
|
for version in $(nvm list | grep -oE 'v[0-9]+\.[0-9]+\.[0-9]+'); do nvm use $version && npm uninstall -g @aikidosec/safe-chain; done
|
|
```
|
|
|
|
**Option B** - Manual per version:
|
|
|
|
```bash
|
|
nvm use <version>
|
|
npm uninstall -g @aikidosec/safe-chain
|
|
```
|
|
|
|
Repeat for each Node version where safe-chain was installed.
|
|
|
|
4. **Install the binary version** (see [Installation](../README.md#installation))
|
|
|
|
### Volta
|
|
|
|
1. **Clean up shell aliases:**
|
|
|
|
```bash
|
|
safe-chain teardown
|
|
```
|
|
|
|
2. **Restart your terminal**
|
|
|
|
3. **Uninstall the Volta package:**
|
|
|
|
```bash
|
|
volta uninstall @aikidosec/safe-chain
|
|
```
|
|
|
|
4. **Install the binary version** (see [Installation](../README.md#installation))
|
|
|
|
## Troubleshooting
|
|
|
|
### Shell aliases still present after migration
|
|
|
|
1. Run `safe-chain teardown` (if the binary is installed)
|
|
2. Manually remove any safe-chain entries from your shell config files:
|
|
- Bash: `~/.bashrc`
|
|
- Zsh: `~/.zshrc`
|
|
- Fish: `~/.config/fish/config.fish`
|
|
- PowerShell: `$PROFILE`
|
|
3. Restart your terminal
|
|
4. Re-run the install script
|
|
|
|
### "command not found: safe-chain" after migration
|
|
|
|
The binary installation directory (`~/.safe-chain/bin`) may not be in your PATH. Restart your terminal. If the problem persists: re-run the installation of safe-chain.
|