Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/stratosphere-ve/core/llms.txt

Use this file to discover all available pages before exploring further.

Building Stratosphere Core produces a single self-contained binary you can run without needing Go installed on the target machine. The standard go build command handles everything — dependency fetching, compilation, and linking.

​
Prerequisites

  • Go 1.21 or newer — Download from go.dev/dl. Verify with go version.
  • Git — Required to clone the repository.

​
Steps

1

Clone the repository

git clone https://github.com/stratosphere-ve/core.git && cd core
2

Build the binary

Run go build from the project root. The output binary name differs by platform.
go build -o stratosphere main.go
Go automatically downloads any missing dependencies before compiling.
3

Run the binary

Execute the compiled binary directly.
./stratosphere
You will see the same interactive menu as go run main.go.

​
Cross-compilation

Go supports compiling for a different OS or architecture than your current machine by setting the GOOS and GOARCH environment variables before running go build. 
# Build a Linux amd64 binary from any host
GOOS=linux GOARCH=amd64 go build -o stratosphere main.go

# Build a Windows amd64 binary from any host
GOOS=windows GOARCH=amd64 go build -o stratosphere.exe main.go

# Build a Linux arm64 binary (e.g. for a Raspberry Pi)
GOOS=linux GOARCH=arm64 go build -o stratosphere-arm64 main.go

​
Windows Defender Smart App Control

Windows Defender Smart App Control may block the compiled .exe from running, even if you built it yourself. If this happens, use go run main.go instead of the compiled binary — it bypasses the block by running the program directly through the Go toolchain rather than as a standalone executable.

​
go run vs compiled binary

go run main.goCompiled binary
Requires Go installedYesNo (on target machine)
Startup timeSlightly slower (compiles on each run)Faster
PortabilitySource must be presentSingle file, copy anywhere
Development useRecommendedRecommended for distribution
For day-to-day development and testing, go run main.go is the simpler choice. Build a binary when you want to distribute or deploy the program without bundling the Go toolchain.

​
Next steps

Quickstart

Run Stratosphere Core directly with go run — no build step needed.

Introduction

Learn about the architecture, packages, and project roadmap.

Build docs developers (and LLMs) love

Get started for freeTalk to us