mirror of
https://github.com/Studio-Saelix/sencho.git
synced 2026-08-09 02:12:59 +00:00
db73d7671a
* feat: add RBAC viewer accounts, atomic deployments, and fleet-wide backups (Pro) Introduces three Pro-tier features: - RBAC: Multi-user system with admin/viewer roles, user management UI, automatic migration from single-admin credentials, viewer restrictions across the entire UI (read-only editor, hidden action buttons) - Atomic Deployments: Pre-deploy file backup to .sencho-backup/, automatic rollback on health probe failure, manual rollback button, health probes added to stack updates, webhook-triggered deploys use atomic rollback - Fleet-Wide Backups: Point-in-time snapshots of compose files across all nodes (local + remote), stored centrally in SQLite, per-stack restore with optional redeploy, graceful handling of offline nodes * fix(settings): use correct ProGate prop name in UsersSection * fix(settings): remove unused isPro prop from UsersSection * fix(auth): fetch user info after login and setup so isAdmin is set correctly
59 lines
1.9 KiB
Plaintext
59 lines
1.9 KiB
Plaintext
---
|
|
title: RBAC & User Management
|
|
description: Role-based access control for Sencho Pro — create admin and viewer accounts to control who can modify your stacks.
|
|
---
|
|
|
|
<Note>
|
|
RBAC requires a Sencho Pro license. Community Edition supports a single admin account only.
|
|
</Note>
|
|
|
|
Sencho Pro introduces role-based access control with two distinct roles: **Admin** and **Viewer**. This lets you give team members read-only access to your infrastructure without risking accidental changes.
|
|
|
|
## Roles
|
|
|
|
| Role | Description |
|
|
|------|-------------|
|
|
| **Admin** | Full access to all features — deploy, edit, manage users, configure nodes, and more |
|
|
| **Viewer** | Read-only access to dashboards, logs, stats, and file contents |
|
|
|
|
### What viewers can see
|
|
|
|
- Dashboard and home metrics
|
|
- Stacks list and stack detail view
|
|
- Compose and `.env` file contents (read-only)
|
|
- Per-container stats and logs
|
|
- Fleet view
|
|
- Resources hub (images, volumes, networks — read-only)
|
|
- Global logs
|
|
- Notifications
|
|
|
|
### What viewers cannot do
|
|
|
|
- Edit compose or environment files
|
|
- Deploy, restart, stop, or start stacks
|
|
- Create or delete stacks
|
|
- Manage users, nodes, webhooks, or alerts
|
|
- Access the host console
|
|
- Prune resources
|
|
- Change settings
|
|
|
|
## Managing users
|
|
|
|
Admins can manage accounts in **Settings → Users**. From there you can:
|
|
|
|
- **Create** a new user with a username, password, and role (Admin or Viewer)
|
|
- **Edit** an existing user's password or role
|
|
- **Delete** a user account
|
|
|
|
## Migration from single-admin setup
|
|
|
|
When you upgrade to Sencho Pro, your existing single-admin credentials are automatically migrated to the new users table. No manual action is required — your login continues to work as before, and your account is assigned the Admin role.
|
|
|
|
## License tiers
|
|
|
|
| Tier | Admin accounts | Viewer accounts |
|
|
|------|---------------|-----------------|
|
|
| **Community** | 1 | 0 |
|
|
| **Personal Pro** | 1 | 1 |
|
|
| **Team Pro** | Unlimited | Unlimited |
|