Futrou CLI

Manage Futrou Cloud or a standalone Futrou Nasua server from your terminal.

What it does

The Futrou CLI manages Futrou Cloud or a standalone Futrou Nasua server — the same commands work against either, since both expose the same API and schema. Use it for serverlets, proxies, DNS zones, volumes, projects, and the rest of your workspace, locally or from CI. By default it points at Futrou Cloud (api.futrou.com); pass --api-url to target a Nasua server directly instead.

Install

On Linux or macOS, install the latest Futrou CLI with:

bash
curl -fsSL https://futrou.com/install.sh | bash

On Windows PowerShell:

powershell
irm https://futrou.com/install.ps1 | iex

You can also install it with npm, or run it without a global installation:

bash
npm install -g futrou
npx futrou --help

The Futrou CLI supports Linux, macOS, Windows, and FreeBSD on x64 and arm64.

text
Futrou CLI  v2.0.0  help

Deploy and manage Futrou Cloud from your terminal.

Global options:
   --api-url value    Futrou API URL (default: "https://api.futrou.com") [$FUTROU_API_URL]
   --api-token value  Futrou API token (overrides stored credentials) [$FUTROU_API_TOKEN]
   --help, -h         Display help

Commands:
   login         Log in to Futrou Cloud on this machine
   logout        Log out from Futrou Cloud on this machine
   whoami        Display the currently authenticated user or api token info
   setup mcp     Configure Futrou MCP for AI coding agents
   setup skills  Configure Futrou Skills for AI coding agents
   init          Create a futrou.json config file for this project
   deploy        Deploy or upgrade resources based on futrou.json config
   upgrade       Upgrade Futrou CLI to the latest or a specific version
   serverlets    Manage serverlets
   proxies       Manage HTTPs/TCP/UDP proxies
   dns           Manage DNS zones and records
   projects      Manage projects
   workspaces    Manage workspaces
   volumes       Manage persistent volumes
   license       Display the Futrou CLI license
   version       Display the Futrou CLI version
   schema        Display the Futrou API v2 OpenAPI schema
   help, h       Display the list of commands or help for one command

Authenticate and explore

Sign in, then use the built-in help to discover available commands for your workspace:

bash
futrou login
futrou --help
futrou serverlets list

Use futrou <command> --help whenever you need command-specific flags or examples.

Last updated