nushell-plugins/installers/bootstrap

Nushell + Plugins Bootstrap Installers\n\nUniversal installers for Nushell and plugins that work without any prerequisites. These scripts solve the bootstrap problem by providing one-command installation that works on fresh systems.\n\n## Quick Start\n\n### Linux/macOS (POSIX Shell)\n\nbash\ncurl -L https://your-url/install.sh | sh\n\n\n### Windows (PowerShell)\n\npowershell\nInvoke-WebRequest -Uri "https://your-url/install.ps1" | Invoke-Expression\n\n\n## Features\n\n- Zero Prerequisites: Works on fresh systems without Rust, Git, or other dependencies\n- Multi-Platform: Supports Linux, macOS, and Windows (x86_64, ARM64)\n- Complete Distribution: Installs Nushell + all workspace and custom plugins\n- Automatic Configuration: Sets up PATH, creates default config, registers plugins\n- Installation Modes: User (/.local/bin) or system (/usr/local/bin) installation\n- Build Options: Pre-built binaries or build from source\n- Verification: Optional installation verification and testing\n- Uninstallation: Clean removal of all installed components\n\n## Installation Options\n\n### Basic Installation\n\nDefault installation to user directory with all plugins:\n\nbash\n# Linux/macOS\ncurl -L install-url/install.sh | sh\n\n# Windows\niwr install-url/install.ps1 | iex\n\n\n### System Installation\n\nInstall to system directories (requires admin privileges):\n\nbash\n# Linux/macOS (requires sudo)\ncurl -L install-url/install.sh | sudo sh -s -- --system\n\n# Windows (requires admin PowerShell)\niwr install-url/install.ps1 | iex -ArgumentList "-System"\n\n\n### Build from Source\n\nBuild Nushell and plugins from source code:\n\nbash\n# Linux/macOS\ncurl -L install-url/install.sh | sh -s -- --build-from-source\n\n# Windows\niwr install-url/install.ps1 | iex -ArgumentList "-BuildFromSource"\n\n\n### Minimal Installation\n\nInstall only Nushell without plugins:\n\nbash\n# Linux/macOS\ncurl -L install-url/install.sh | sh -s -- --no-plugins\n\n# Windows\niwr install-url/install.ps1 | iex -ArgumentList "-NoPlugins"\n\n\n## Command Line Options\n\n### Linux/macOS (install.sh)\n\n| Option | Description |\n|--------|-------------|\n| --system | Install to system directory (/usr/local/bin, requires sudo) |\n| --user | Install to user directory (/.local/bin) [default] |\n| --no-path | Don't modify shell PATH configuration |\n| --no-config | Don't create initial nushell configuration |\n| --no-plugins | Install only nushell, skip plugins |\n| --build-from-source | Build from source instead of downloading binaries |\n| --verify | Verify installation after completion |\n| --uninstall | Remove nushell and plugins |\n| --version VERSION | Install specific version (default: latest) |\n| --help | Show help message |\n\n### Windows (install.ps1)\n\n| Parameter | Description |\n|-----------|-------------|\n| -System | Install to system directory (C:\Program Files\Nushell, requires admin) |\n| -User | Install to user directory (~.local\bin) [default] |\n| -NoPath | Don't modify PATH environment variable |\n| -NoConfig | Don't create initial nushell configuration |\n| -NoPlugins | Install only nushell, skip plugins |\n| -BuildFromSource | Build from source instead of downloading binaries |\n| -Verify | Verify installation after completion |\n| -Uninstall | Remove nushell and plugins |\n| -Version <version> | Install specific version (default: latest) |\n| -Help | Show help message |\n\n## Installation Locations\n\n### User Installation (Default)\n\n- Linux/macOS: ~/.local/bin\n- Windows: %USERPROFILE%\.local\bin\n- No admin privileges required\n- Affects only current user\n\n### System Installation\n\n- Linux/macOS: /usr/local/bin\n- Windows: C:\Program Files\Nushell\bin\n- Requires admin privileges\n- Available to all users\n\n### Configuration Directory\n\n- Linux/macOS: ~/.config/nushell\n- Windows: %USERPROFILE%\.config\nushell\n\n## What Gets Installed\n\n### Core Components\n\n- nushell binary: Main shell executable\n- Workspace plugins: Built-in nushell plugins\n - nu_plugin_custom_values\n - nu_plugin_example\n - nu_plugin_formats\n - nu_plugin_gstat\n - nu_plugin_inc\n - nu_plugin_polars\n - nu_plugin_query\n - nu_plugin_stress_internals\n- Custom plugins: Additional community plugins\n - nu_plugin_clipboard\n - nu_plugin_desktop_notifications\n - nu_plugin_hashes\n - nu_plugin_highlight\n - nu_plugin_image\n - nu_plugin_kcl\n - nu_plugin_tera\n - And more...\n\n### Configuration Files\n\n- config.nu: Main nushell configuration\n- env.nu: Environment configuration\n- Scripts directory for custom commands\n- Plugins directory for plugin configurations\n\n### PATH Integration\n\nAutomatically updates shell configuration files:\n\n- Bash: ~/.bashrc, ~/.bash_profile\n- Zsh: ~/.zshrc\n- Fish: ~/.config/fish/config.fish\n- Nushell: ~/.config/nushell/env.nu\n- Generic: ~/.profile\n- Windows: System/User PATH environment variable\n\n## Examples\n\n### Standard Installation with Verification\n\nbash\n# Linux/macOS\ncurl -L install-url/install.sh | sh -s -- --verify\n\n# Windows\niwr install-url/install.ps1 | iex -ArgumentList "-Verify"\n\n\n### Corporate/Enterprise Installation\n\nbash\n# System installation without auto-config\ncurl -L install-url/install.sh | sudo sh -s -- --system --no-config\n\n# Windows system installation\n# Run as Administrator:\niwr install-url/install.ps1 | iex -ArgumentList "-System", "-NoConfig"\n\n\n### Development Installation\n\nbash\n# Build from source with verification\ncurl -L install-url/install.sh | sh -s -- --build-from-source --verify\n\n# Windows development\niwr install-url/install.ps1 | iex -ArgumentList "-BuildFromSource", "-Verify"\n\n\n### Specific Version Installation\n\nbash\n# Install specific version\ncurl -L install-url/install.sh | sh -s -- --version v0.107.1\n\n# Windows specific version\niwr install-url/install.ps1 | iex -ArgumentList "-Version", "v0.107.1"\n\n\n## Troubleshooting\n\n### Common Issues\n\n#### "Command not found" after installation\n\n- Restart your terminal/command prompt\n- Or reload shell configuration: source ~/.bashrc (Linux/macOS)\n- Check if installation directory is in PATH\n\n#### Permission denied errors\n\n- For system installation, ensure you have admin privileges\n- Use sudo on Linux/macOS or run PowerShell as Administrator on Windows\n- Try user installation instead: --user or -User\n\n#### Download failures\n\n- Check internet connection\n- Try building from source: --build-from-source or -BuildFromSource\n- Manual download: Save installer script and run locally\n\n#### Plugin registration failures\n\n- Verify nushell binary works: nu --version\n- Try manual plugin registration: nu -c "plugin add /path/to/plugin"\n- Check plugin binary permissions (should be executable)\n\n### Build from Source Issues\n\n#### Missing dependencies\n\nInstall required tools:\n\nLinux (Ubuntu/Debian):\n\nbash\nsudo apt update\nsudo apt install git curl build-essential\ncurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\n\n\nLinux (RHEL/CentOS/Fedora):\n\nbash\nsudo dnf install git curl gcc\ncurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\n\n\nmacOS:\n\nbash\n# Install Xcode command line tools\nxcode-select --install\n\n# Install Rust\ncurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\n\n\nWindows:\n\n1. Install Git from https://git-scm.com/\n2. Install Rust from https://rustup.rs/\n3. Install Visual Studio Build Tools\n\n### Verification Steps\n\nTest your installation:\n\nbash\n# Check nushell version\nnu --version\n\n# Test basic functionality\nnu -c "echo 'Hello from Nushell'"\n\n# List installed plugins\nnu -c "plugin list"\n\n# Check PATH\nwhich nu # Linux/macOS\nwhere nu # Windows\n\n\n## Uninstallation\n\n### Complete Removal\n\nbash\n# Linux/macOS\ncurl -L install-url/install.sh | sh -s -- --uninstall\n\n# Windows\niwr install-url/install.ps1 | iex -ArgumentList "-Uninstall"\n\n\n### Manual Removal\n\n1. Remove binaries from installation directory\n2. Remove configuration directory (optional)\n3. Remove PATH entries from shell configuration files\n4. Remove environment variable modifications (Windows)\n\n## Security Considerations\n\n### Script Verification\n\nBefore running any installer, you should:\n\n1. Review the script source code\n2. Verify the download URL and SSL certificate\n3. Check script signatures if available\n4. Consider downloading and running locally instead of piping\n\n### Permissions\n\n- User installations don't require admin privileges\n- System installations require elevated privileges\n- Scripts only modify necessary files and directories\n- No automatic execution of arbitrary code from external sources\n\n### Network Security\n\n- Scripts use HTTPS for all downloads\n- Verify SSL certificates before downloading\n- Consider using corporate proxies or mirrors\n- Firewall may need to allow downloads from GitHub/your hosting\n\n## Distribution Details\n\n### Binary Packages\n\nPre-built binaries are available for:\n\n- Linux x86_64 (GNU libc)\n- Linux aarch64 (GNU libc)\n- macOS x86_64 (Intel)\n- macOS arm64 (Apple Silicon)\n- Windows x86_64\n- Windows aarch64\n\n### Package Structure\n\nplaintext\nnushell-plugins-{platform}-{version}.tar.gz/\n├── nu(.exe) # Main nushell binary\n├── nu_plugin_*(.exe) # Plugin binaries\n├── config/ # Default configuration\n│ ├── config.nu\n│ └── env.nu\n├── scripts/ # Installation scripts\n├── docs/ # Documentation\n├── LICENSE # License file\n└── manifest.json # Package manifest\n\n\n## Contributing\n\n### Testing Installers\n\nTest the installers on various platforms:\n\n1. Fresh VM or container\n2. Different operating system versions\n3. Various shell configurations\n4. With and without prerequisites\n\n### Reporting Issues\n\nWhen reporting problems, include:\n\n- Operating system and version\n- Shell type and version\n- Installation command used\n- Complete error messages\n- Network/firewall configuration\n\n### Improvements\n\nAreas for enhancement:\n\n- Additional platform support\n- Mirror/CDN support for faster downloads\n- Package manager integration\n- Corporate deployment features\n- Automated testing workflows\n\n## License\n\nThese bootstrap installers are part of the nushell-plugins project and are licensed under the same terms. See the main project LICENSE file for details.\n\n## Support\n\n- Documentation: https://nushell.sh\n- Community: https://discord.gg/nushell\n- Issues: https://github.com/your-org/nushell-plugins/issues\n- Discussions: https://github.com/your-org/nushell-plugins/discussions\n\n---\n\nHappy shell scripting with Nushell! 🚀