Get started

Getting started with Hyjal

Deploy full stack applications in minutes: install the CLI, add agent support if you use an AI coding agent, and deploy.

View as Markdown

This is the five-minute path from an empty terminal to a live HTTPS URL. You will create an account, install the hyjal CLI, log in, initialize a repository, and deploy. The example ships a Project named acme with one Resource, web.

Prerequisites

1. Install the Hyjal CLI

Run the following one-line installer:

curl -fsSL https://hyjal.cloud/install.sh | sh

On macOS you can also use Homebrew:

brew tap hyjal/tap
brew install hyjal

Verify the install:

$ hyjal --version

3. Log in

hyjal login uses a device flow. once you run the command, it will print a one-time code and a Console URL; simply just approve the session in your browser and you’re good to go.

$ hyjal login
Your device code: HJAL-7Q2X
Open https://console.hyjal.cloud/device and enter the code to continue.
Waiting for approval...
Approved. Logged in as john@acme.example (Organization: acme).

Confirm the session:

$ hyjal whoami
john@acme.example (Organization: acme)

4. Initialize the repository

From your project directory, run hyjal init. It detects the repo shape
and writes a starting hyjal.toml manifest.

$ cd ~/code/acme
$ hyjal init
Detected: static site (build: npm run build, output: dist)
Wrote hyjal.toml
  project = acme
  resource.web  lane = static
Review hyjal.toml, then run: hyjal deploy

Open hyjal.toml and confirm the Project and Resource names. The generated manifest for this example looks like:

[project]
name = "acme"
[resource.web]
lane = "static"
build = "npm run build"
output = "dist"

5. Deploy

hyjal deploy uploads every Component of your application to your Project’s Bucket, builds all of them according to any specifications provided, uploads them to your Project’s Bucket, applies any policies you have set, and flips request routing atomically.

$ hyjal deploy
Building resource web (lane: static)...
  npm run build ✓
  compressing assets (brotli, gzip) ✓
Uploading artifact... digest sha256:9f2c1a…e4b7
Applying policy... ✓
Flipping route... ✓
Deployed acme/web
  https://web--acme.hyjal.cloud

Open the URL. Your application is live on the internet, served on a fresh Afterburner instance per request.

$ hyjal open web
Opening https://web--acme.hyjal.cloud

6. Watch the logs

Stream request-correlated logs with hyjal logs -f. Each request row carries its method, path, status, and latency.

$ hyjal logs -f --resource web
[14:02:11] GET  /            200   12ms
[14:02:11] GET  /assets/app.css  200    4ms
[14:02:14] GET  /about       200    9ms

Press Ctrl-C to stop streaming. The same timeline appears in the Console’s Logs tab.

Where to go next