diff --git a/docs-site/src/content/docs/blog/2026-04-06-v1-0-0.md b/docs-site/src/content/docs/blog/2026-04-06-v1-0-0.md deleted file mode 100644 index a87cdd8..0000000 --- a/docs-site/src/content/docs/blog/2026-04-06-v1-0-0.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: SimpleDeploy 1.0.0 -date: 2026-04-06 -authors: - - name: SimpleDeploy maintainers - title: Project team - picture: https://github.com/vazra.png - url: https://github.com/vazra/simpledeploy -excerpt: First public release. One Go binary, Docker Compose apps on a VPS with HTTPS, metrics, backups, alerts, and a dashboard. -tags: - - release ---- - -The 1.0.0 cut. Everything needed to run a small fleet of Compose apps on a single VPS, in one binary. - -## What's in the box - -- **CLI + API server.** `simpledeploy serve` runs the daemon; the CLI talks to it locally or remotely with context switching (`simpledeploy context`). -- **Reconciler.** Drops a `compose.yml` in the apps directory and SimpleDeploy applies it. A directory watcher with debounce handles edits. -- **Embedded Caddy.** Reverse proxy is built in, programmatic config (no Caddyfile), with custom modules for per-domain rate limiting and request metrics. -- **SQLite + WAL store.** Apps, deploys, users, API keys, app access, metrics, request stats, alerts, webhooks, backups, all in one local file. -- **Auth.** Passwords (bcrypt), JWT sessions, API keys with scopes, per-app access middleware, login rate limiting. -- **Metrics.** System and container stats collector, buffered batch writer, tiered rollup and pruning, query API. -- **Request stats.** Caddy module records every request; tiered rollup powers the dashboard charts. -- **Backups.** Strategies and targets with a scheduler, configs and run history in the store, CLI commands. -- **Alerts.** Rule evaluator, webhook dispatch with built-in templates, history. -- **Svelte dashboard.** Embedded in the Go binary. Login, app list, app detail with charts and live logs, deploy/remove flows, backups page, alerts page, user management. -- **Log streaming.** Process stdout/stderr through a ring buffer, exposed live over WebSocket and the CLI. - -## Install - -Homebrew tap: - -```bash -brew install vazra/tap/simpledeploy -``` - -APT: - -```bash -curl -fsSL https://vazra.github.io/apt-repo/key.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/simpledeploy.gpg -echo "deb [signed-by=/etc/apt/keyrings/simpledeploy.gpg] https://vazra.github.io/apt-repo stable main" | sudo tee /etc/apt/sources.list.d/simpledeploy.list -sudo apt update && sudo apt install simpledeploy -``` - -Or grab a tarball from [GitHub Releases](https://github.com/vazra/simpledeploy/releases/tag/v1.0.0). - -## Where to start - -`simpledeploy serve`, point a browser at the dashboard, complete first-time setup, and deploy your first compose app from the UI or via `simpledeploy apply`. diff --git a/docs-site/src/content/docs/blog/2026-04-07-v1-1-0.md b/docs-site/src/content/docs/blog/2026-04-07-v1-1-0.md deleted file mode 100644 index b205dc2..0000000 --- a/docs-site/src/content/docs/blog/2026-04-07-v1-1-0.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: SimpleDeploy 1.1.0 -date: 2026-04-07 -authors: - - name: SimpleDeploy maintainers - title: Project team - picture: https://github.com/vazra.png - url: https://github.com/vazra/simpledeploy -excerpt: Patch release fixing the goreleaser pipeline so artifacts publish cleanly. -tags: - - release ---- - -Quick follow-up to 1.0.0 to fix the release pipeline. - -### Bug fixes - -- Reset git state after the UI build so goreleaser doesn't see a dirty tree and skip publishing. - -No code or behavior changes for users. Upgrade only if you're scripting against the latest tag. diff --git a/docs-site/src/content/docs/blog/2026-04-08-v1-2-0.md b/docs-site/src/content/docs/blog/2026-04-08-v1-2-0.md deleted file mode 100644 index 332ad22..0000000 --- a/docs-site/src/content/docs/blog/2026-04-08-v1-2-0.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: SimpleDeploy 1.2.0 -date: 2026-04-08 -authors: - - name: SimpleDeploy maintainers - title: Project team - picture: https://github.com/vazra.png - url: https://github.com/vazra/simpledeploy -excerpt: Patch release. CGO disabled for cross-compilation so Linux ARM64 and macOS builds publish. -tags: - - release ---- - -Second follow-up to 1.0.0. - -### Bug fixes - -- Disable CGO for cross-compilation. Linux ARM64 and macOS arm64/amd64 binaries now build cleanly under goreleaser. -- Reset git state after UI build (carried over from 1.1.0). - -This is the recommended 1.x baseline until [1.3.0](/blog/2026-04-30-v1-3-0/). diff --git a/docs-site/src/content/docs/blog/2026-04-17-introducing-simpledeploy.md b/docs-site/src/content/docs/blog/2026-04-17-introducing-simpledeploy.md index 987d39e..0962907 100644 --- a/docs-site/src/content/docs/blog/2026-04-17-introducing-simpledeploy.md +++ b/docs-site/src/content/docs/blog/2026-04-17-introducing-simpledeploy.md @@ -1,78 +1,50 @@ --- -title: Introducing SimpleDeploy -date: 2026-04-17 +title: SimpleDeploy 1.0.0 +date: 2026-04-08 authors: - name: SimpleDeploy maintainers title: Project team picture: https://github.com/vazra.png url: https://github.com/vazra/simpledeploy -excerpt: A single binary that turns any VPS into a production-grade Docker Compose host. HTTPS, backups, alerts, metrics. No Kubernetes. +excerpt: First public release. One Go binary, Docker Compose apps on a VPS with HTTPS, metrics, backups, alerts, and a dashboard. tags: - - announcement + - release --- -We have been quietly building SimpleDeploy: a single Go binary that runs Docker Compose apps on a VPS the way you actually want them to run in production. +The 1.0.0 cut. Everything needed to run a small fleet of Compose apps on a single VPS, in one binary. -## The problem +## What's in the box -You write a `docker-compose.yml`, `scp` it to a VPS, run `docker compose up -d`, then start gluing on the missing pieces: +- **CLI + API server.** `simpledeploy serve` runs the daemon; the CLI talks to it locally or remotely with context switching (`simpledeploy context`). +- **Reconciler.** Drops a `compose.yml` in the apps directory and SimpleDeploy applies it. A directory watcher with debounce handles edits. +- **Embedded Caddy.** Reverse proxy is built in, programmatic config (no Caddyfile), with custom modules for per-domain rate limiting and request metrics. +- **SQLite + WAL store.** Apps, deploys, users, API keys, app access, metrics, request stats, alerts, webhooks, backups, all in one local file. +- **Auth.** Passwords (bcrypt), JWT sessions, API keys with scopes, per-app access middleware, login rate limiting. +- **Metrics.** System and container stats collector, buffered batch writer, tiered rollup and pruning, query API. +- **Request stats.** Caddy module records every request; tiered rollup powers the dashboard charts. +- **Backups.** Strategies and targets with a scheduler, configs and run history in the store, CLI commands. +- **Alerts.** Rule evaluator, webhook dispatch with built-in templates, history. +- **Svelte dashboard.** Embedded in the Go binary. Login, app list, app detail with charts and live logs, deploy/remove flows, backups page, alerts page, user management. +- **Log streaming.** Process stdout/stderr through a ring buffer, exposed live over WebSocket and the CLI. -- nginx or Caddy for TLS. -- certbot or some script for renewals. -- A cron for `pg_dump` and `aws s3 cp`. -- A second cron for log rotation. -- Some monitoring (Prometheus? Netdata?) and an alert webhook. -- A dashboard for the team. -- A way to do this from your laptop. +## Install -It works, but every step is its own decision. Now repeat for every project. - -## What SimpleDeploy gives you - -One binary that ships all of the above as defaults you can override: - -- **Docker Compose deploys** with safety: every change is versioned, every deploy is auditable, every app can roll back. -- **Automatic HTTPS** via embedded Caddy. Let's Encrypt out of the box. Custom certs supported. -- **Built-in backups** for Postgres, MySQL, MongoDB, Redis, SQLite, and raw volumes. Local or S3 targets. Retention and scheduling per app. -- **Alerts** with rules like "CPU above 80% for 5 minutes" and webhook delivery to Slack, Discord, PagerDuty. -- **Metrics and request stats** with tiered rollups so the database stays small forever. -- **Multi-user RBAC** with per-app access. API keys for CI. -- **Remote CLI** with kubectl-style contexts. Deploy from your laptop or a GitHub Actions job. -- **A dashboard** for everything above. - -All of it ships in one process. About 60 MB resident for a small fleet. SQLite for state. No external dependencies beyond Docker. - -## Who it is for - -- Solo developers who want production-quality deployments without spending Saturdays on YAML. -- Small teams running a handful of services on one or two VPSes. -- Agencies hosting client apps cheaply. -- Anyone who looked at Kubernetes for a side project and thought "no thanks". - -If you need multi-host orchestration, GPU scheduling, or an autoscaler, you want something else. SimpleDeploy is for the long tail of "this app needs to run reliably on a $20 VPS". - -## Try it - -Five minutes from zero to a HTTPS-served app: +Homebrew tap: ```bash -brew install vazra/tap/simpledeploy # or apt, or curl -simpledeploy init --config /etc/simpledeploy/config.yaml -sudo systemctl enable --now simpledeploy -simpledeploy users create --username admin --role super_admin -# drop a docker-compose.yml with simpledeploy.endpoints.0.domain label -simpledeploy apply -f docker-compose.yml --name myapp +brew install vazra/tap/simpledeploy ``` -The full walk-through is in the [quickstart](/start/quickstart/). +APT: -## What's next +```bash +curl -fsSL https://vazra.github.io/apt-repo/key.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/simpledeploy.gpg +echo "deb [signed-by=/etc/apt/keyrings/simpledeploy.gpg] https://vazra.github.io/apt-repo stable main" | sudo tee /etc/apt/sources.list.d/simpledeploy.list +sudo apt update && sudo apt install simpledeploy +``` -- A growing library of [backup strategies](/guides/backups/overview/) and [target backends](/guides/backups/s3-target/). -- Multi-host federation for unified visibility across instances. -- SSO via OIDC. -- A community marketplace of compose templates. +Or grab a tarball from [GitHub Releases](https://github.com/vazra/simpledeploy/releases/tag/v1.0.0). -The full direction is on the [roadmap](/community/roadmap/). The repo is at [github.com/vazra/simpledeploy](https://github.com/vazra/simpledeploy). Issues and discussions are open. +## Where to start -If you build something on SimpleDeploy, tell us. We will list it on the [showcase](/community/showcase/). +`simpledeploy serve`, point a browser at the dashboard, complete first-time setup, and deploy your first compose app from the UI or via `simpledeploy apply`.