Installation

Fazt is designed to be installed on a fresh Linux server (Ubuntu 20.04+ recommended) or used locally on macOS/Linux.

bash
curl -s https://fazt-sh.github.io/fazt/install.sh | bash

This script will:

  • Download the correct binary for your architecture.
  • Install it to /usr/local/bin/fazt.
  • (Optional) Set up a systemd service and firewall rules.

Quick Start

Once installed, you can start the server in development mode to test it out.

terminal
# Initialize configuration fazt server init --domain localhost # Start the server fazt server start

Deploying Sites

Fazt treats every folder as a potential site. To deploy, use the client command.

terminal
cd my-website fazt client deploy --domain my-site

Your site will be instantly available at https://my-site.your-domain.com.

Serverless Functions

Add a main.js file to your site directory to handle dynamic requests. Fazt uses an embedded JS runtime.

main.js
export default function(req) { return { status: 200, body: "Hello from Fazt Serverless!" }; }

Configuration

Fazt stores most configuration in the database, but some bootstrap settings can be defined in environment variables or flags.

  • FAZT_DB_PATH: Path to the SQLite database file.
  • FAZT_DOMAIN: The root domain for the server.
  • FAZT_PORT: The port to listen on (default: 8080 or 80/443).

CLI Reference

The fazt binary provides several subcommands:

  • fazt server start: Start the hosting server.
  • fazt server install: Install as a systemd service.
  • fazt client deploy: Deploy a local directory.
  • fazt client logs: View live logs for a site.

FAQ

Where is the data stored?

Everything is stored in a single SQLite file (data.db). Back this up, and you backup everything.

Can I use custom domains?

Yes! Point your domain's A record to the server IP and add the domain in the dashboard.