Viaalink CLI · via · for developers

From localhost to the world — viaalink.

Run via expose 3000 on your machine to put a local web app on your own domain through your Viaalink Relay.

$ via expose 3000
connectsrelay.yourcompany.com
publishesport 3000

Your app is then reachable at https://app.relay.yourcompany.com

01 / Install

Install the Viaalink CLI.

One command installs via. Then connect it to your Relay with via relay add.

Linux, macOS and Android (Termux)

$ curl -fsSL https://raw.githubusercontent.com/viaalink/cli/main/install.sh | bash

Windows (PowerShell)

$ irm https://raw.githubusercontent.com/viaalink/cli/main/install.ps1 | iex

Or download the archive

The one-liner is the recommended way; the archive is for when you can't run a script. Checksums are linked below to verify your download.

Checksums

02 / Publish

Publish a local port through your Viaalink Relay.

via expose 3000 gives a port on your machine a public HTTPS address through your Viaalink Relay.

$ via expose 3000

via expose 3000 --foreground keeps it in the terminal until you press Ctrl+C.

04 / via.yaml

See what via.yaml publishes.

Edit the file on the left. The right side shows what via net apply would do: which service gets which address on your Relay.

via.yaml
$ via net apply --dry-run

project my-shop · 3 services

shop127.0.0.1:3000
local http://shop.localhost
● https://shop.relay.yourcompany.com
api127.0.0.1:8080
local /api
● https://api.relay.yourcompany.com/api
db-admin127.0.0.1:8978
local 127.0.0.1:8978
local only, not published

Runs in your browser. It reads project and network.services only.

Contact

Talk to a human. Kelvin is one.

Questions about the CLI or Viaalink Relay? Write directly.