Skip to content

NOISSUE - Improve local Docker bootstrap - #255

Closed
fbugarski wants to merge 1 commit into
mainfrom
improve-local-bootstrap
Closed

NOISSUE - Improve local Docker bootstrap#255
fbugarski wants to merge 1 commit into
mainfrom
improve-local-bootstrap

Conversation

@fbugarski

Copy link
Copy Markdown
Contributor

What type of PR is this?

This is a bug fix and developer experience improvement for running Cube locally.

What does this do?

This PR makes make up reliably start a complete local Cube environment from a clean machine.

Changes include:

  • Validates Docker, Docker Compose v2, curl, and required configuration files.
  • Builds the local embedder image when it is unavailable.
  • Supports the host architecture when building the embedder image.
  • Waits until the login API is ready before completing startup.
  • Waits until all required Ollama models are downloaded.
  • Uses ollama pull instead of starting a model during initialization.
  • Prevents Cloudflare Tunnel from running without the cloud profile.
  • Applies the correct Docker Compose profile to lifecycle commands.
  • Adds make ps for inspecting local service status.
  • Adds missing default environment values to avoid Compose warnings.
  • Updates the root and UI documentation with startup behavior and troubleshooting commands.

No existing API or application behavior is intentionally changed.

Which issue(s) does this PR fix/relate to?

No related issue.

Have you included tests for your changes?

No automated tests were added because these changes affect Docker Compose and local startup orchestration.

The complete stack was tested from clean Docker volumes. Login readiness, required Ollama models, local image builds, and service health were verified.

Did you document any new/modified features?

Yes. The root README and UI README document the updated make up workflow, first-run behavior, and service inspection commands.

Notes

The first startup can take several minutes because Docker images and Ollama models must be downloaded and local embedder images must be built.

Docker, Docker Compose v2, curl, internet access, and sufficient disk space and memory are required.

@dborovcanin dborovcanin closed this Jun 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants