How skygenesisenterprise/notploy works
Notploy is a self-hostable deployment control plane: users configure infrastructure and projects, deploy and operate applications, Compose stacks, and databases, then monitor and maintain them. The dashboard is the main user-facing workflow; the desktop app is a separate client for connecting to an instance and managing its resources. The README documents deployment engines, scheduled backups, API/CLI/SDK/MCP access, and templates, but their implementation paths are not present in this tree. The graph uses documented capabilities without claiming uninspected wiring; sampled source supports the desktop connection/storage flow and dashboard API actions.
Main entry points: dashboard Dashboard · project Projects and environments · application Application configuration · connection-manager.ts Connection manager
Components 27
Web Control Plane
- Dashboard
apps/notploy/components/dashboard - Authentication
apps/notploy/lib/auth-client.ts - Projects and environments
apps/notploy/components/dashboard/project - Servers and clusters
apps/notploy/components/dashboard/settings/servers
Deploy And Operate
- Application configuration
apps/notploy/components/dashboard/application - Compose projects
apps/notploy/components/dashboard/compose - Database services
apps/notploy/components/dashboard/postgres - Deployment operations
apps/notploy/components/dashboard/deployments - Domains and routing
apps/notploy/components/dashboard/application/domains - Database backups
apps/notploy/components/dashboard/database/backups - Docker operations
apps/notploy/components/dashboard/docker - Monitoring and logs
apps/notploy/components/dashboard/monitoring - Git and notifications
apps/notploy/components/dashboard/settings/git
Desktop Client
- Desktop pages
apps/desktop/src/renderer/pages/overview-page.tsx - Desktop IPC
apps/desktop/src/main/ipc.ts - Connection manager
apps/desktop/src/main/connection/connection-manager.ts - Instance API client
apps/desktop/src/main/client/notploy-client.ts - Credential storage
apps/desktop/src/main/security/safe-storage.ts - Encrypted credentials
apps/desktop/src/main/security/secure-storage.ts
Supporting Services
- API and work service
apps/api/src/service.ts - Metrics service
apps/monitoring/main.go
Other components
- Platform operator
- Notploy instance
- Managed workloads
- Operating-system keychain
- API, CLI, SDK, MCP
- Blueprint gallery
Connections 29
- Platform operator → Dashboard: uses
- Dashboard → Authentication: authenticates with
- Dashboard → Projects and environments: configures
- Dashboard → Servers and clusters: configures
- Projects and environments → Application configuration: organizes
- Projects and environments → Compose projects: organizes
- Projects and environments → Database services: organizes
- Application configuration → Deployment operations: configures deploys
- Compose projects → Deployment operations: configures deploys
- Database services → Database backups: configures backups
- Application configuration → Domains and routing: configures
- Dashboard → Docker operations: operates
- Dashboard → Monitoring and logs: views
- Dashboard → Git and notifications: configures
- Deployment operations → Managed workloads: deploys
- Docker operations → Managed workloads: manages
- Monitoring and logs → Metrics service: reads metrics
- Dashboard → API and work service: calls
- Platform operator → Desktop pages: uses
- Desktop pages → Desktop IPC: invokes
- Desktop IPC → Connection manager: dispatches
- Connection manager → Credential storage: reads credentials
- Credential storage → Encrypted credentials: selects storage
- Encrypted credentials → Operating-system keychain: encrypts through
- Connection manager → Instance API client: builds client
- Instance API client → Notploy instance: requests API
- Notploy instance → API and work service: serves requests
- API, CLI, SDK, MCP → API and work service: automates through
- Blueprint gallery → Projects and environments: provides blueprints