UNS OpenHub

Getting started

Install UNS DataHub
Runtime.

Use the public bootstrap to install a verified Runtime, then continue with its guided setup and version-matched documentation.

Bootstrap → Runtime wizard → Browser setup → Versioned guide

01 / Requirements

Before you begin

The bootstrap is available for macOS, Linux, and Windows on Intel/AMD 64-bit and ARM64 hosts.

  • Container engine Docker or Podman with Compose support.
  • Runtime access During the private preview, approved read-only access to the Runtime release.
  • Image access Credentials for any private container images configured by the Runtime.

02 / Install

Install the Runtime

Choose your host platform. The public installer verifies the bootstrap binary before installing it, then uns-bootstrap install downloads and verifies the matching Runtime bundle.

Choose your platform 
curl -fsSL \
  https://github.com/uns-datahub/uns-datahub-bootstrap/releases/latest/download/install.sh |
  sh
"$HOME/.local/bin/uns-bootstrap" install

03 / What happens next

Continue from the terminal to the browser

After the download is verified, the bootstrap starts the Runtime’s setup wizard. The wizard asks only for settings that apply to that Runtime release and prints the exact command to start the selected stack. When the controller is running, finish the initial DataHub setup in the browser.

  1. 1
    Verified Runtime The bootstrap downloads the Runtime release embedded in that bootstrap build and verifies it before installation.
  2. 2
    Guided configuration Complete the interactive wizard for your container engine, Runtime mode, registry, and configuration choices.
  3. 3
    Start the selected stack Run the exact command printed by the wizard rather than a generic website example.
  4. 4
    Browser setup For the bundled local stack, open localhost:8180 after the controller starts and complete the initial DataHub setup.
  5. 5
    Version-matched documentation Continue with the README.md included in the installed Runtime.

04 / Versions

Two products, two version numbers

The bootstrap and Runtime are released independently. Seeing a bootstrap version such as 1.x together with a Runtime version such as 7.x is expected.

  • uns-bootstrap 1.x Version of the small public installer.
  • default runtime 7.x Runtime release selected by that bootstrap build.
  • VERSION Runtime release already installed in the target directory.

05 / Existing Runtime

Your current installation stays protected

The bootstrap never silently replaces a non-empty Runtime directory. Current releases identify the installed and requested Runtime versions when possible and print safe commands for a side-by-side installation or a rename-and-retry.

macOS and Linux 
"$HOME/.local/bin/uns-bootstrap" version
cat "$HOME/uns-datahub-runtime/VERSION"
Windows PowerShell 
& "$HOME\.local\bin\uns-bootstrap.exe" version
Get-Content "$HOME\uns-datahub-runtime\VERSION"
runtime target must be absent or empty

If an older bootstrap prints only this short message, run the platform installer from the Install section again to update the bootstrap binary, then retry the Runtime installation. Updating the bootstrap does not replace the Runtime directory.

Follow the safe alternatives printed by the updated bootstrap. Do not delete the directory or copy an old .env, .secrets, or configuration over a new Runtime without reviewing the version-matched guide.

The Runtime download is denied

Confirm that your GitHub account has Runtime preview access. Use a fine-grained token limited to the Runtime repository with read-only Contents permission.

A container image cannot be pulled

Authenticate Docker or Podman to the configured container registry. Registry authentication is separate from the GitHub token used to download the Runtime.

06 / Versioned guide

Continue with the bundled README

The installed Runtime includes the complete guide for its exact version: configuration details, Infisical, mode-specific operations, updates, administration, and troubleshooting.

macOS and Linux $HOME/uns-datahub-runtime/README.md
Windows $HOME\uns-datahub-runtime\README.md
Bootstrap reference Request preview access