Skip to content

install.md

Latest commit

 

History

History
90 lines (66 loc) · 1.64 KB

install.md

File metadata and controls

90 lines (66 loc) · 1.64 KB

Installation

Prerequisites

  • Docker
  • Go (recommended: latest stable)
  • Optional for hardened runtime: gVisor (runsc)

Quick install (recommended)

Install latest release binary:

curl -fsSL https://raw.githubusercontent.com/MrUprizing/opensbx/main/scripts/install.sh | bash

Run locally:

opensbx

Health check:

curl http://127.0.0.1:8080/v1/health

Docker setup

macOS

Install Docker Desktop, then verify:

docker --version
docker info

Ubuntu

sudo apt update
sudo apt install -y docker.io
sudo systemctl enable docker
sudo systemctl start docker
docker --version

gVisor setup (optional, Ubuntu)

Use this if you want stronger isolation for untrusted workloads.

curl -fsSL https://gvisor.dev/archive.key | sudo gpg --dearmor -o /usr/share/keyrings/gvisor-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/gvisor-archive-keyring.gpg] https://storage.googleapis.com/gvisor/releases release main" | sudo tee /etc/apt/sources.list.d/gvisor.list > /dev/null
sudo apt update
sudo apt install -y runsc

Configure Docker runtime:

RUNSC_PATH=$(command -v runsc)
sudo mkdir -p /etc/docker
cat <<EOF | sudo tee /etc/docker/daemon.json
{
  "default-runtime": "runsc",
  "runtimes": {
    "runsc": {
      "path": "${RUNSC_PATH}"
    }
  }
}
EOF
sudo systemctl restart docker

Validate:

docker info | grep "Default Runtime"
docker run --rm hello-world

Next docs