Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installation

From Source

Prerequisites:

  • Rust (stable toolchain)
  • For Oracle support: Oracle Instant Client libraries
git clone https://github.com/rustpunk/ferrule.git
cd ferrule

# Default build (Postgres, MySQL, MSSQL, SQLite)
cargo build --release --bin ferrule

# With Oracle support
cargo build --release --bin ferrule --features oracle

# Install to ~/.cargo/bin
cargo install --path ferrule-cli

The resulting binary is at ./target/release/ferrule.

Pre-built Binaries

Pre-built binaries are published on the releases page.

curl -L https://github.com/rustpunk/ferrule/releases/latest/download/ferrule-linux-x64.tar.gz | tar xz
sudo mv ferrule /usr/local/bin/

Feature Flags

FeatureDefaultDescription
postgresPostgreSQL backend (via tokio-postgres + rustls)
mysqlMySQL backend (via mysql_async)
mssqlMSSQL backend (via tiberius)
sqliteSQLite backend (via rusqlite, bundled)
oracleOracle backend (requires Instant Client)

To build a minimal binary with only SQLite:

cargo build --release --bin ferrule --no-default-features --features sqlite