Liusha

Docs · quickstart

Your first function

This guide takes you from nothing to a live HTTPS URL. You’ll need Node.js 20 or newer and a free Liusha account.

1. Install the CLI

$ npm install -g @liusha-com/cli

Check that it works:

$ liusha --version

2. Sign in

This opens your browser to authorize the CLI. A scoped API key is stored locally — revoke it any time from the console.

$ liusha login

3. Create a function

$ liusha init hello
$ cd hello

The template is a plain Node.js HTTP handler — no framework required, edit index.js and you’re done:

export default function handler(req, res) {
  res.json({ message: 'hello from the sand' });
}

4. Deploy

$ liusha deploy

Your source is packaged and built in the cloud, then released as a new revision. First builds take about a minute; later ones are faster thanks to layer caching. When it finishes you get your URL:

✓ Deployed → https://hello.liusha.app

5. Watch it run

Stream logs live while you send requests:

$ liusha logs hello --follow

Leave it alone for a while and it scales to zero — checkliusha status hello to see it sleeping. The next request wakes it automatically.

Next steps

  • Set environment variables with liusha env set KEY=value — secrets are stored encrypted.
  • Roll back with liusha releases rollback — every deploy is an immutable revision.
  • Invite your team from the console and give CI a deploy-only API key.