Installing Skifta

Get Skifta installed and ready to use in under 2 minutes.

System Requirements

Skifta runs on:

• Linux (x86_64, ARM64)
• macOS (Intel and Apple Silicon)

Prerequisites:

• curl (pre-installed on most systems)
• Bash or compatible shell

⚠️ Windows Support: Skifta does not currently support Windows. Windows users can use WSL (Windows Subsystem for Linux) as a workaround.

Quick Install

Run this one-liner in your terminal:

curl --proto '=https' --tlsv1.2 -LsSf https://sh.skifta.dev | sh

What this does:

1. Downloads the latest Skifta release for your platform
2. Installs the binary to ~/.cargo/bin/ or a similar location in your PATH
3. Makes skifta available globally

The installation script is secure and uses HTTPS with TLS 1.2+ for all connections.

Verify Installation

Confirm Skifta is installed correctly:

skifta --version

Expected output:

skifta 0.15.1

If you see the version number, you're ready to go! Proceed to the Quickstart Guide.

Updating Skifta

Automatic Update (Recommended)

Skifta includes a built-in update command:

skifta update

This automatically:

• Checks for the latest release
• Downloads and installs the new version
• Replaces your current installation

💡 Update Notifications: Skifta will notify you when a new version is available when you run any command.

Check Current Version

See which version you're running:

skifta --version

Manual Update

Alternatively, re-run the installation script:

curl --proto '=https' --tlsv1.2 -LsSf https://sh.skifta.dev | sh

Or download binaries directly from GitHub Releases.

Troubleshooting

Command Not Found

If skifta is not recognized after installation:

1. Check if binary is in PATH:

   ls ~/.cargo/bin/skifta

2. Add to PATH manually (if needed):

   export PATH="$HOME/.cargo/bin:$PATH"

3. Restart your terminal and try again.

Permission Denied

If you get permission errors during installation:

# Ensure the install location is writable
chmod +x ~/.cargo/bin/skifta

Installation Script Fails

If the automated installer doesn't work:

1. Download the binary manually from GitHub Releases
2. Place it in a directory in your PATH
3. Make it executable: chmod +x skifta

Still Having Issues?

Open an issue on GitHub with:

• Your operating system and version
• The full error message
• Output of echo $PATH

What's Next?

• Quickstart Guide: Transform your first SQL dump in 5 minutes
• Configuration: Learn how to configure Skifta for your database
• Transformers: Explore available data transformers