Getting started

Installing Fyra

Fyra is a command-line tool. Install it once, globally, and you're set up for every project on your machine.

1

Install Node.js

Fyra requires Node.js 16 or later. If you already have it, skip ahead. Otherwise grab it from nodejs.org — the LTS version is fine.

2

Install the CLI

Run this in your terminal. The -g flag installs it globally so you can use fyra from any directory.

Terminal
$ npm install -g fyra
3

Create an account

Register with your email address. You'll use these credentials every time you log in on a new machine.

Terminal
$ fyra register
Email: you@example.com
Password: ········
Confirm password: ········
Account created. Welcome!

Already have an account? Skip registration and run fyra login instead.

Getting started

Your first deploy

Once you're logged in, deploying a site is two commands: one to create the app, one to push it. After that, a single fyra push is all you need.

1

Go to your project directory

Navigate to the folder you want to deploy. It can be a plain HTML folder, the output of a build tool, or anything static.

Terminal
$ cd my-site/dist
2

Create the app

This registers your app and saves a .deploy.yaml file in the current directory. Pass --appname to choose your own slug, or leave it out for a random one.

Terminal
$ fyra create --appname my-site
App created: my-site
Saved .deploy.yaml
3

Push it live

Fyra compresses your directory, streams it to the server, and reloads the CDN. The whole process takes seconds.

Terminal
$ fyra push
Scanning my-site...
Packing 24 files (840 KB)
Uploading... 840 KB sent
Deploying on server...
Done: http://my-site.fyra.sh

Next time, just run fyra push — no flags needed. The .deploy.yaml remembers which app to push to.