Cloud

Overview

Vintage Cloud is a lightweight telemetry platform for machines. Configure your machine with a write token and it will automatically stream state changes and log messages to a hosted dashboard — accessible from anywhere, with no infrastructure to manage.

The model is simple:

1. Create a bucket — you get a public ID and a secret write token.
2. Configure your machine with those credentials via environment variables.
3. View the dashboard — state data streams in automatically, filterable by machine and key.

Creating a bucket

Open the cloud dashboard and click Create bucket. Give it a name — this is just a label for your own reference.

After creation, you'll see your credentials once. Save them immediately — the write token cannot be recovered.

You can download a .env file with both values pre-formatted:

VINTAGE_CLOUD_PUBLIC_ID=<your-public-id>
VINTAGE_CLOUD_WRITE_TOKEN=<your-write-token>

Connecting a machine

Set the two environment variables before starting the vintage CLI:

export VINTAGE_CLOUD_PUBLIC_ID=your-public-id
export VINTAGE_CLOUD_WRITE_TOKEN=your-write-token

vintage serve my-machine.ts

Or use a .env file:

vintage serve my-machine.ts --env .env

Once connected, every updateState() call and every emitInfo / emitWarn / emitError is sent to your bucket automatically.

Dashboard

The bucket dashboard shows incoming state data as a table, refreshing every 5 seconds. Filter by machine ID or state key to narrow down the view.

Up to 1,000 rows are shown, ordered newest first.

Access model

The public ID is safe to share — anyone with it can view the dashboard. The write token is secret and should only be in your machine's environment.

Bookmarks

Use the Open bucket page to access a bucket by public ID. Buckets can be bookmarked locally in the browser for quick access.