Skip to main content
Run this node when you want to host TinyCloud yourself instead of using a managed node.

​
What the node does

  • Serves the HTTP API
  • Verifies authentication and delegations
  • Stores KV, SQL, and block data
  • Exposes health and metrics endpoints
  • Supports local filesystem, SQLite, PostgreSQL, MySQL, and S3-compatible storage backends

​
Default ports

relay.port currently defaults to 8081 in configuration, but the node server does not start a relay listener from that setting. Do not publish 8081 for the minimal node unless a deployment-specific relay process requires it.

​
Start here

  1. Choose Docker or your own process supervisor and launch the node
  2. Verify http://localhost:8000/healthz returns a successful response
  3. Read Configuration, then choose production database and block-storage backends
  4. Enable monitoring after the node starts cleanly with persistent storage

Configuration

Canonical config keys, env vars, and defaults.

Docker

Minimal container setup and volume layout.

Databases

SQLite, PostgreSQL, and MySQL connection strings.

Monitoring

Health checks, metrics, and tracing.