mirror of
https://github.com/Studio-Saelix/sencho.git
synced 2026-07-26 11:49:16 +00:00
docs: retire the public-beta label and document v0.92.0 capabilities (#1398)
Sencho exits public beta after a clean v0.92.0 QA pass. Replace the global "public beta on the path to v1.0" callout with scoped maturity language across the README, KNOWN_LIMITATIONS, quickstart, troubleshooting, upgrade, and the security-architecture reference. The copy stays honestly pre-1.0 and avoids a blanket "stable" claim. Reframe the Scale limitations to credit QA, audit, and end-to-end validation while keeping the honest caveat that large-scale performance is not yet benchmarked. Fold the new v0.92.0 capabilities into the README sections: Compose Doctor preflight checks, health-gated updates with stalled-update recovery, file move/rename in the explorer, ordered multi-file Compose for Git sources, the Security overview, on-demand node-wide scans, the Compose network inspector with an exposure-intent guard, scan policy packs, documentation-drift flags, and configurable image-update cadence with registry/source links.
This commit is contained in:
@@ -1,15 +1,17 @@
|
|||||||
# Known limitations
|
# Known limitations
|
||||||
|
|
||||||
> [!NOTE]
|
> [!NOTE]
|
||||||
> Sencho is currently in public beta on the path to v1.0. Core workflows are actively tested, but early users should review the known limitations and avoid deploying it blindly on critical infrastructure without testing in their own environment first.
|
> Sencho is used in production for day-to-day Docker Compose and fleet management. As a pre-1.0 project it still evolves quickly, so review the limitations below and validate against your own setup before deploying it on critical infrastructure.
|
||||||
|
|
||||||
Below are the limitations we know about today. If you hit something that is not here, please file a bug.
|
Below are the limitations we know about today. If you hit something that is not here, please file a bug.
|
||||||
|
|
||||||
## Scale
|
## Scale
|
||||||
|
|
||||||
- Single-instance use: not benchmarked yet beyond typical homelab loads. Expect comfortable operation on tens of stacks and a few hundred containers per node; very large nodes may show UI slowdowns.
|
Sencho's core workflows are validated through QA, repeated security and code audits, and end-to-end journey testing, so day-to-day correctness is well exercised. What is not yet characterized is performance at large scale: the figures below are ranges we have run comfortably, not hard ceilings.
|
||||||
- Fleet: not benchmarked yet. Comfortably tested with small fleets (a handful of nodes); larger fleets work but are less exercised.
|
|
||||||
- Container log streaming: not benchmarked yet at sustained high log rates; very chatty containers may lag the UI.
|
- Single instance: comfortable at typical homelab and small-team loads (tens of stacks and a few hundred containers per node). Very large nodes are not yet benchmarked and may show UI slowdowns.
|
||||||
|
- Fleet: validated on small fleets (a handful of nodes). Larger fleets work but are less exercised, and fleet-wide operations are not yet benchmarked at scale.
|
||||||
|
- Container log streaming: handles normal log volumes smoothly. Sustained high log rates are not yet benchmarked, and very chatty containers may lag the UI.
|
||||||
|
|
||||||
## Platform support
|
## Platform support
|
||||||
|
|
||||||
|
|||||||
@@ -28,7 +28,7 @@
|
|||||||
</picture>
|
</picture>
|
||||||
|
|
||||||
> [!NOTE]
|
> [!NOTE]
|
||||||
> Sencho is currently in public beta on the path to v1.0. Core workflows are actively tested, but early users should review the known limitations and avoid deploying it blindly on critical infrastructure without testing in their own environment first.
|
> Sencho is used in production for day-to-day Docker Compose and fleet management. As a pre-1.0 project it still evolves quickly, so review the known limitations and validate against your own setup before deploying it on critical infrastructure.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -62,17 +62,20 @@ See [KNOWN_LIMITATIONS.md](KNOWN_LIMITATIONS.md) for the current limitation list
|
|||||||
### Stacks
|
### Stacks
|
||||||
- Full Compose lifecycle: create, deploy, restart, stop, pull
|
- Full Compose lifecycle: create, deploy, restart, stop, pull
|
||||||
- Monaco editor with diff preview before save and one-click rollback
|
- Monaco editor with diff preview before save and one-click rollback
|
||||||
- [Git-sourced stacks](https://docs.sencho.io/features/git-sources) pulled and synced from any repository
|
- [Health-gated updates](https://docs.sencho.io/features/health-gated-updates) that hold a rollout until health checks pass, with stalled-update detection and in-app recovery
|
||||||
- File explorer for compose, env, and supporting files
|
- [Git-sourced stacks](https://docs.sencho.io/features/git-sources) pulled and synced from any repository, with ordered multi-file Compose
|
||||||
|
- [File explorer](https://docs.sencho.io/features/stack-file-explorer) for compose, env, and supporting files, with move and rename across directories
|
||||||
|
- [Compose Doctor](https://docs.sencho.io/features/compose-doctor) preflight checks that catch compose problems before deploy
|
||||||
- [Stack labels](https://docs.sencho.io/features/stack-labels) for grouping and bulk operations
|
- [Stack labels](https://docs.sencho.io/features/stack-labels) for grouping and bulk operations
|
||||||
- [App Store](https://docs.sencho.io/features/app-store) with LinuxServer.io templates
|
- [App Store](https://docs.sencho.io/features/app-store) with LinuxServer.io templates
|
||||||
|
|
||||||
### Observability
|
### Observability
|
||||||
- Aggregated [log search and stream](https://docs.sencho.io/features/global-observability) across every container in the fleet
|
- Aggregated [log search and stream](https://docs.sencho.io/features/global-observability) across every container in the fleet
|
||||||
- Live container stats, health checks, and image-update notifications
|
- Live container stats, health checks, and image-update notifications on a configurable cadence, with links from each image to its registry and source
|
||||||
- Threshold alerts for CPU, memory, and network
|
- Threshold alerts for CPU, memory, and network
|
||||||
- Read-only [audit log](https://docs.sencho.io/features/audit-log) of every action **(Admiral)**
|
- Read-only [audit log](https://docs.sencho.io/features/audit-log) of every action **(Admiral)**
|
||||||
- [Network topology](https://docs.sencho.io/features/fleet-view) view of containers, networks, and nodes
|
- [Network topology](https://docs.sencho.io/features/fleet-view) view of containers, networks, and nodes
|
||||||
|
- Documentation-drift flags when a [stack dossier](https://docs.sencho.io/features/stack-dossier) diverges from the running stack
|
||||||
|
|
||||||
### Fleet
|
### Fleet
|
||||||
- Multi-node management via authenticated HTTP and WebSocket proxy
|
- Multi-node management via authenticated HTTP and WebSocket proxy
|
||||||
@@ -93,7 +96,10 @@ See [KNOWN_LIMITATIONS.md](KNOWN_LIMITATIONS.md) for the current limitation list
|
|||||||
- [SSO](https://docs.sencho.io/features/sso): custom OIDC, presets for Google, GitHub, and Okta, plus LDAP and Active Directory
|
- [SSO](https://docs.sencho.io/features/sso): custom OIDC, presets for Google, GitHub, and Okta, plus LDAP and Active Directory
|
||||||
- [Two-factor authentication](https://docs.sencho.io/features/two-factor-authentication) with TOTP and backup codes
|
- [Two-factor authentication](https://docs.sencho.io/features/two-factor-authentication) with TOTP and backup codes
|
||||||
- [RBAC](https://docs.sencho.io/features/rbac) with admin (full control) and viewer (read-only) roles; deployer, node-admin, and auditor roles plus scoped permissions **(Admiral)**
|
- [RBAC](https://docs.sencho.io/features/rbac) with admin (full control) and viewer (read-only) roles; deployer, node-admin, and auditor roles plus scoped permissions **(Admiral)**
|
||||||
- [Vulnerability scanning](https://docs.sencho.io/features/vulnerability-scanning) via Trivy on every tier with VEX-based suppression; SARIF export and SBOM upload **(Admiral)**
|
- [Security overview](https://docs.sencho.io/features/security) with a chart-led scan summary, sortable images, and searchable scan history
|
||||||
|
- [Vulnerability scanning](https://docs.sencho.io/features/vulnerability-scanning) via Trivy on every tier, with on-demand node-wide scans and VEX-based suppression; SARIF export and SBOM upload **(Admiral)**
|
||||||
|
- [Compose network inspector](https://docs.sencho.io/features/compose-networking) with an exposure-intent guard for unintended published ports
|
||||||
|
- Scan policy packs for reusable security rules **(Admiral)**
|
||||||
- [Private registries](https://docs.sencho.io/features/private-registries) and [deploy enforcement](https://docs.sencho.io/features/deploy-enforcement) for non-compliant images **(Admiral)**
|
- [Private registries](https://docs.sencho.io/features/private-registries) and [deploy enforcement](https://docs.sencho.io/features/deploy-enforcement) for non-compliant images **(Admiral)**
|
||||||
- [API tokens](https://docs.sencho.io/features/api-tokens) for automation
|
- [API tokens](https://docs.sencho.io/features/api-tokens) for automation
|
||||||
|
|
||||||
|
|||||||
@@ -6,7 +6,7 @@ description: Get Sencho running in under five minutes.
|
|||||||
This walks you from a clean Docker host to a working Sencho console. Five minutes if your Compose directory is already in the right place, ten if you need to lay it out first.
|
This walks you from a clean Docker host to a working Sencho console. Five minutes if your Compose directory is already in the right place, ten if you need to lay it out first.
|
||||||
|
|
||||||
<Note>
|
<Note>
|
||||||
Sencho is currently in public beta on the path to v1.0. Core workflows are actively tested, but early users should review the [known limitations](https://github.com/studio-saelix/sencho/blob/main/KNOWN_LIMITATIONS.md) and avoid deploying it blindly on critical infrastructure without testing in their own environment first.
|
Sencho is used in production for day-to-day Docker Compose and fleet management. As a pre-1.0 project it still evolves quickly, so review the [known limitations](https://github.com/studio-saelix/sencho/blob/main/KNOWN_LIMITATIONS.md) and validate against your own setup before deploying it on critical infrastructure.
|
||||||
</Note>
|
</Note>
|
||||||
|
|
||||||
## Prerequisites
|
## Prerequisites
|
||||||
|
|||||||
@@ -4,7 +4,7 @@ description: Solutions to the most common Sencho setup and runtime problems.
|
|||||||
---
|
---
|
||||||
|
|
||||||
<Note>
|
<Note>
|
||||||
Sencho is currently in public beta on the path to v1.0. Core workflows are actively tested, but early users should review the [known limitations](https://github.com/studio-saelix/sencho/blob/main/KNOWN_LIMITATIONS.md) and avoid deploying it blindly on critical infrastructure without testing in their own environment first.
|
Sencho is used in production for day-to-day Docker Compose and fleet management. As a pre-1.0 project it still evolves quickly, so review the [known limitations](https://github.com/studio-saelix/sencho/blob/main/KNOWN_LIMITATIONS.md) and validate against your own setup before deploying it on critical infrastructure.
|
||||||
</Note>
|
</Note>
|
||||||
|
|
||||||
If something has broken and you want a quick "what do I do now?" overview rather than a specific symptom, start with the [Recovery guide](/operations/recovery). It walks through getting back to a working state when Sencho, a deploy, sign-in, Docker, or a remote node fails, and links back here for the details.
|
If something has broken and you want a quick "what do I do now?" overview rather than a specific symptom, start with the [Recovery guide](/operations/recovery). It walks through getting back to a working state when Sencho, a deploy, sign-in, Docker, or a remote node fails, and links back here for the details.
|
||||||
|
|||||||
@@ -4,7 +4,7 @@ description: How to update Sencho, what happens during upgrades, and the version
|
|||||||
---
|
---
|
||||||
|
|
||||||
<Note>
|
<Note>
|
||||||
Sencho is currently in public beta on the path to v1.0. Core workflows are actively tested, but early users should review the [known limitations](https://github.com/studio-saelix/sencho/blob/main/KNOWN_LIMITATIONS.md) and avoid deploying it blindly on critical infrastructure without testing in their own environment first.
|
Sencho is used in production for day-to-day Docker Compose and fleet management. As a pre-1.0 project it still evolves quickly, so review the [known limitations](https://github.com/studio-saelix/sencho/blob/main/KNOWN_LIMITATIONS.md) and validate against your own setup before deploying it on critical infrastructure.
|
||||||
</Note>
|
</Note>
|
||||||
|
|
||||||
## Upgrade steps
|
## Upgrade steps
|
||||||
|
|||||||
@@ -6,7 +6,7 @@ description: How Sencho protects your infrastructure with layered authentication
|
|||||||
Sencho applies defense-in-depth across authentication, authorization, encryption, and auditing. All security features ship with sensible defaults and work out of the box on a fresh install.
|
Sencho applies defense-in-depth across authentication, authorization, encryption, and auditing. All security features ship with sensible defaults and work out of the box on a fresh install.
|
||||||
|
|
||||||
<Note>
|
<Note>
|
||||||
Sencho is currently in public beta on the path to v1.0. Core workflows are actively tested, but early users should review the [known limitations](https://github.com/studio-saelix/sencho/blob/main/KNOWN_LIMITATIONS.md) and avoid deploying it blindly on critical infrastructure without testing in their own environment first.
|
Sencho is used in production for day-to-day Docker Compose and fleet management. As a pre-1.0 project it still evolves quickly, so review the [known limitations](https://github.com/studio-saelix/sencho/blob/main/KNOWN_LIMITATIONS.md) and validate against your own setup before deploying it on critical infrastructure.
|
||||||
</Note>
|
</Note>
|
||||||
|
|
||||||
## The authentication stack
|
## The authentication stack
|
||||||
|
|||||||
Reference in New Issue
Block a user