Using Scarf as system package manager


In addition to easy package management, Scarf supports installing static binaries in a way that sends anonymized usage statistics to the package author.


On Debian-based linux systems, there is a dependency on netbase

$ sudo apt-get install netbase

To get Scarf, simply run:

$ curl -L | bash

You'll then need to add ~/.scarf/bin to you PATH

Install your packages

$ scarf install <package>

System package file

Scarf keeps track of installed packages in ~/.scarf/scarf-package.json. It can be useful to keep this file in version control so you can keep a consistent package setup across multiple computers. If you want to (re)install all packages from your system package file, run:

$ scarf install --system-package-file

Use a package privately

All packages on Scarf are free to download, and some let you purchse the ability to use them without reporting any usage statistics! Here's how:

  • Create an account on Scarf
  • Add some payment information on your account settings page.
  • Search for your package and find the Private Tier option to purchase. Select the payment details you added and confirm your purchse
  • Find your SCARF_API_TOKEN on your account settings page.
  • SCARF_API_TOKEN="${your token}" scarf sync-access

Now, any time you use your package, Scarf knows you have purchased the Private Tier for this package, and no usage statistics will be sent!

Keeping Scarf up to date

A simple upgrade command is all you need to get the latest version of Scarf

$ scarf upgrade