Skip to content

feat: add public one-line remote installer for DeepSQL - #118

Merged
venkateshsakamuri-lab merged 3 commits into
mainfrom
cursor/remote-installer-4090
Sep 21, 2026
Merged

venkateshsakamuri-lab merged 3 commits into
mainfrom
cursor/remote-installer-4090

Conversation

@venkateshsakamuri-lab

@venkateshsakamuri-lab venkateshsakamuri-lab commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a remote-install.sh script for one-liner DeepSQL self-host installation:

curl -fsSL https://raw.githubusercontent.com/DeepSQLAI/deepsql/main/scripts/self-host/remote-install.sh | bash

Features

  • Platform detection: Linux (amd64/arm64) and macOS support
  • Prerequisite checks: Validates bash, curl, git, Docker, Compose v2, and buildx
  • Auto-versioning: Fetches latest release tag from GitHub API, falls back to main
  • Shallow clone: Uses --depth 1 for fast cloning
  • Environment setup: Creates .env from template
  • Optional auto-install: --yes flag for noninteractive mode
  • Remote-friendly guidance: Pre-clone Docker/buildx messages use raw.githubusercontent.com URLs

Options

Flag Description
-y, --yes Run install.sh automatically after setup
--skip-docker-check Skip Docker/Compose/buildx verification
--branch <ref> Use specific branch or tag instead of latest release

Environment Variables

Variable Default Description
DEEPSQL_HOME $HOME/deepsql Installation directory
DEEPSQL_BRANCH (latest release) Branch or tag to checkout

Security

  • Downloads only from GitHub (raw.githubusercontent.com, github.com, api.github.com)
  • No third-party binaries — everything builds from source
  • Transparent: users can inspect the script before running

Follow-up Fix (latest commit)

  • Bug fixed: check_docker() previously printed sudo ./scripts/self-host/bootstrap-server.sh when Docker was missing on Linux, but that path doesn't exist until after clone_or_update runs
  • Solution: Changed to remote one-liner: curl -fsSL https://raw.githubusercontent.com/.../bootstrap-server.sh | sudo bash
  • Also fixed: Same issue in buildx-missing guidance
  • Hardened: get_latest_release_tag() now explicitly:
    • Matches only ^v[0-9] product tags (e.g., v1.3.0)
    • Excludes desktop-v* and other prefixed tags
Open in Web Open in Cursor 

cursoragent and others added 3 commits September 21, 2026 09:05
Add scripts/self-host/remote-install.sh for OpenCode-style one-liner install:
  curl -fsSL https://raw.githubusercontent.com/.../remote-install.sh | bash

Features:
- Detects OS/arch (Linux, macOS, x86_64, arm64)
- Checks for bash, curl, git prerequisites
- Validates Docker Engine, Compose v2, and buildx (with version checks)
- Guides to bootstrap-server.sh if Docker is missing on Linux
- Clones to ${DEEPSQL_HOME:-$HOME/deepsql} at latest v* release tag
- Falls back to main branch if no release tags exist
- Copies .env.example to .env if needed
- Prints clear LLM configuration instructions (DEEPSQL_CHAT_*)
- Supports --yes for noninteractive install, --branch for specific versions
- Security: only fetches from GitHub raw/API for DeepSQLAI org

Also updates README Quick start with the one-liner + link to script.

Co-authored-by: Venkat SF <venkatesh.sakamuri@stayflexi.com>
- Separate info output from return value in get_latest_release_tag
- Add report_version helper that prefers the requested target ref
  for version tags (v*), since shallow clones may not have accurate
  git describe output

Co-authored-by: Venkat SF <venkatesh.sakamuri@stayflexi.com>
- Change check_docker() Linux guidance to use raw.githubusercontent.com
  URLs instead of local paths that don't exist before clone_or_update
- Add re-run hint after bootstrap/Docker install
- Harden get_latest_release_tag() to explicitly:
  - Match only ^v[0-9] product tags (v1.3.0, etc.)
  - Exclude desktop-v* and other prefixed tags
- Both buildx missing and Docker missing messages now use remote URLs

Co-authored-by: Venkat SF <venkatesh.sakamuri@stayflexi.com>
@venkateshsakamuri-lab
venkateshsakamuri-lab marked this pull request as ready for review September 21, 2026 09:15
@venkateshsakamuri-lab
venkateshsakamuri-lab requested a review from a team as a code owner September 21, 2026 09:15
@venkateshsakamuri-lab
venkateshsakamuri-lab merged commit 4b05812 into main Sep 21, 2026
9 checks passed
@venkateshsakamuri-lab
venkateshsakamuri-lab deleted the cursor/remote-installer-4090 branch September 21, 2026 09:15
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