Lumic Control Center documentation

Install Lumic, connect an agent, and operate the node.

Lumic Control Center (Lumic) is a host-native operating layer for Linux servers. Install it once, then use the same typed capabilities through CLI, UI, and MCP.

1. Install Lumic

ssh root@server 'curl -fsSL https://lumic.cc/install.sh | sh'

A fresh VPS becomes an autonomous Lumic node. The canonical installer is https://lumic.cc/install.sh.

2. Ask the node

lumic how-are-you

CLI, UI, and MCP share one factual view of health, incidents, recent changes, and recommended attention. See MCP for stdio, restricted SSH, and authenticated HTTP setup.

3. Open the UI

The installer starts the UI on the VPS and prints its one-time sign-in token. Run the following tunnel command on your local computer and leave it running:

ssh -N -L 8080:127.0.0.1:8080 root@server

Open http://127.0.0.1:8080 on your local computer and sign in with the token. If the token was lost, run sudo lumic ui token rotate on the VPS (for example, through a normal SSH session) to create a replacement. The authenticated Rust UI shows applications, services, repositories, deployments, events, host status, and confirmed actions. Read the detailed operator UI instructions.

Browse the dedicated Features catalog for supported applications, managed services, and host capabilities.

Describe the application once

Repositories can include an optional lumic.toml with runtime extensions, capability requirements, typed service resources, processes, domain, health, and deployment intent. Lumic combines that intent with repository evidence and live node state before proposing a plan.

A typical request can therefore be short:

Read lumic.toml, inspect this repository and prepare this Lumic node for production. Fill in safe obvious details from the repository, show the infrastructure plan before material changes, deploy the application and verify its health.

Give Codex a complete VPS task

After MCP is connected, ask for the outcome and require a plan before mutation:

Inspect this Lumic node and repository. Plan the runtime, services, web routing, TLS, workers, schedules, and Git deployment. Apply the approved plan, verify health, and report what changed.

The agent supplies the reasoning. Lumic supplies host evidence, plans, policy, safe operations, and an audit trail.

Explore supported features

The Features section lists application support, managed services, and host capabilities in compact catalogs. The Feature matrix records exact platform coverage and planned expansion.

Documentation status: These pages are the public product contract. Each page distinguishes implemented, nightly, foundation-only, and planned behavior.

Lumic manages Linux directly. Docker is supported as a workload feature, not used as the product’s core abstraction.

STARTIntroductionWhat Lumic Control Center is, what it replaces, and the rules that keep it simple.GUIDEFirst VPSInstall a stable node, verify it, open the local UI and run the first attention check.STATUSAttention and personalityOne factual answer to how the node is doing, with optional deterministic personality.STARTInstallationFrom a fresh VPS to a Lumic Control Center node.SERVERServer managementTyped operations for the Linux host and its native subsystems.APPLICATIONSApplicationsApplications own runtime, Git, environment, web routing, workers, jobs, TLS and deployments.GUIDESoftware installersInspect, plan, and install Lumic's default supported software catalog.APPLICATIONSlumic.tomlThe versioned repository-to-server application and deployment contract.INTELLIGENCEServer intelligenceEvidence-backed application detection, safe service wiring, dependency impact and incident context.APPLICATIONSApplication recipesInstall and reconcile versioned application compositions over Lumic's existing capabilities.SERVICESManaged servicesInstall and operate native data, queue, storage, search, metrics, and logging services.REPOSITORIESGit repositoriesCreate, import, discover, adopt and synchronize host-native Git repositories.INFRASTRUCTUREGit, environments and multiple nodesHost Git, clone portable environments and coordinate autonomous Lumic nodes.APPLICATIONSDeploymentsHealth-gated Git releases, activation, retention, and rollback.OPERATEOperator UIOperate applications and managed services through Lumic's local Rust UI.AGENTSMCPStructured infrastructure capabilities for Codex, Claude and other agent clients.AUTOMATIONEvents & automationDurable events, notifications, and constrained remediation.SECURITYSecurity modelPolicy, safe native execution, and auditable host mutations.STATUSFeature matrixWhat Lumic 1.0 implements and what remains deliberate expansion work.REFERENCECLI referenceThe human console over the same typed capabilities used by UI and MCP.REFERENCEConfigurationMachine, application and infrastructure intent should be exportable and reproducible.RELEASESNightly channelLumic ships continuous gated builds while stable stays conservative.DEVELOPMENTDevelopment & documentationHow contributors keep Lumic extensible and the docs permanently trustworthy.