Run Streambased on your own machine
Streambased runs locally on Docker or Kubernetes. Use the CLI for scripted control, or the desktop app if you'd rather click through it.
Get Started
CLI
Get started with the CLI
Before you start
- Docker installed and running, or a Kubernetes context set up.
- Optional: a Claude or OpenAI API key, if you want the AI chat in the web app.
1Install the CLI
- macOS
- Linux
curl -fsSL https://streambased.io/cli/install.sh | shstreambased: command not found?The CLI installs to
~/.local/bin, which isn't on your PATH by default on macOS. Add it, then open a new terminal:zsh (macOS default)echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrcbashecho 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrcHow do I update?
Run this any time to get the latest version. It updates in place, so there's no need for sudo.
streambased update2Spin it up
Pick Docker or Kubernetes, then the wizard walks you through the rest of the setup. When it's done, the Streambased web app opens in your browser at http://localhost:7080.
streambased bootstrap3Tear it down
Finished? Remove the local environment. Adding
--purgealso wipes the PostgreSQL volume holding your seeded test data, so your next bootstrap starts fresh. Leave it off to keep the data for next time.streambased bootstrap teardown --purge
Desktop app
Or download the desktop app
A native GUI that bootstraps a local Streambased environment for you, with the same setup as the CLI.
Before you start
- Docker installed and running, or a Kubernetes context set up.
- Optional: a Claude or OpenAI API key, if you want the AI chat in the web app.
Questions before you dive in?
Tell us about your setup and we'll help you get Streambased running, locally or in production.