github/Fabric
1
1
Fork 0
mirror of https://github.com/danielmiessler/Fabric.git synced 2026-01-06 21:13:58 -05:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
Fabric/scripts/installer/README.md
Kayvan Sylvan fad176a0a8 docs: streamline install process with one-line installer scripts and update documentation 
- Add markdown file triggers to GitHub workflow
- Update VSCode settings with new spell entries
- Simplify README installation with one-line installers
- Add bash installer script for Unix systems
- Add PowerShell installer script for Windows
- Create installer documentation with usage examples
- Remove redundant pattern from pattern explanations
2025-09-01 11:39:27 -07:00

3.2 KiB
Raw Permalink Blame History

Fabric One-Line Installer

This directory contains the official one-line installer scripts for Fabric.

Quick Start

Unix/Linux/macOS

Install Fabric with a single command:

curl -fsSL https://raw.githubusercontent.com/danielmiessler/fabric/main/scripts/installer/install.sh | bash

Windows (PowerShell)

Install Fabric with a single PowerShell command:

iwr -useb https://raw.githubusercontent.com/danielmiessler/fabric/main/scripts/installer/install.ps1 | iex

Custom Installation Directory

Unix/Linux/macOS

By default, Fabric is installed to ~/.local/bin. To install elsewhere:

curl -fsSL https://raw.githubusercontent.com/danielmiessler/fabric/main/scripts/installer/install.sh | INSTALL_DIR=/usr/local/bin bash

For system-wide installation (requires sudo):

curl -fsSL https://raw.githubusercontent.com/danielmiessler/fabric/main/scripts/installer/install.sh | sudo INSTALL_DIR=/usr/local/bin bash

Windows (PowerShell)

By default, Fabric is installed to %USERPROFILE%\.local\bin. To install elsewhere:

$env:INSTALL_DIR="C:\tools"; iwr -useb https://raw.githubusercontent.com/danielmiessler/fabric/main/scripts/installer/install.ps1 | iex

Supported Systems

  • Operating Systems: Darwin (macOS), Linux, Windows
  • Architectures: x86_64, arm64, i386 (Windows only)

What It Does

  1. Detects your OS and architecture automatically
  2. Downloads the latest Fabric release from GitHub
  3. Extracts only the fabric binary (not the full archive)
  4. Installs to your chosen directory (default: ~/.local/bin)
  5. Verifies the installation works correctly
  6. Provides PATH setup instructions if needed

Features

  • ✅ Cross-platform - Unix/Linux/macOS (bash) and Windows (PowerShell)
  • ✅ Zero dependencies - No additional tools required
  • ✅ Automatic detection - OS and architecture
  • ✅ Smart extraction - Only the binary, not extra files
  • ✅ Error handling - Clear messages and graceful failures
  • ✅ PATH guidance - Helps you set up your environment
  • ✅ Verification - Tests the installation before completing

Requirements

Unix/Linux/macOS

  • curl or wget for downloading
  • tar for extraction (standard on all Unix systems)
  • Write permissions to the installation directory

Windows

  • PowerShell (built into Windows)
  • Write permissions to the installation directory

After Installation

  1. Configure Fabric: Run fabric --setup
  2. Add API keys: Follow the setup prompts
  3. Start using: Try fabric --help or fabric --listpatterns

Troubleshooting

Permission denied?

  • Try with sudo for system directories
  • Or choose a directory you can write to: INSTALL_DIR=~/bin

Binary not found after install?

  • Add the install directory to your PATH
  • The installer provides specific instructions for your shell

Download fails?

  • Check your internet connection
  • Verify GitHub is accessible from your network

Alternative Installation Methods

If the one-liner doesn't work for you, see the main Installation Guide for:

  • Binary downloads
  • Package managers (Homebrew, winget, AUR)
  • Docker images
  • Building from source
Reference in New Issue View Git Blame Copy Permalink