maluos.com / how to

How To

MaluOS is a large system: a database, a vault, a model gateway, agents, a Business OS and an estate of machines. These guides take one task at a time and walk through it step by step, with the exact commands and what you should see after each one. Every guide also ships as an Agent Skill, a SKILL.md file that Claude Code and other assistants can follow to do the task with you (see llms.txt).

Installing your first server

Install MaluOS Server on a machine, a VM or a cloud host, let it provision itself on first boot, check that everything is healthy, and get your first model and the Business OS running.

install · first boot · maluctl · models · business os
Read the guide →

Installing MaluOS Desktop

Install the GNOME 50 desktop, sign into the MaluOS session, install Chrome, VS Code, Claude Code, Codex and Ollama in one click, add a model, and enrol the desk with your office.

install · session · tools installer · models · office enrolment
Read the guide →

Installing a MaluOS GPU Server

Put MaluOS Server on an x86-64 box with an NVIDIA RTX card, install the signed driver, run local models, then issue keys and expose the gateway so every desk on the network can use the GPU.

nvidia · ollama · tiers · share · keys · expose · pairing
Read the guide →

Installing GPU Server on M-series Mac

Serve an Apple Silicon Mac's models to your MaluOS machines: Ollama on the Mac, bound to the network, added as a backend of a MaluOS gateway with its own tier.

apple silicon · ollama · backend · tiers · lan only
Read the guide →

Installing GPU Server on NVIDIA ARM

Serve a DGX Spark's models to your MaluOS network: Ollama on DGX OS, bound to the network, added as a backend of a MaluOS gateway with its own tier.

dgx spark · arm64 · ollama · backend · tiers · lan only
Read the guide →

Installing MaluOS Application/Web Server

Run the Business OS as your office: choose the domain and TLS, provision the kernel, sign in as the first super-admin, mint desk enrolment codes, give the office a model and publish applications to desks.

business os · domain · tls · super-admin · desks · applications
Read the guide →

Guides on the way

More step-by-step guides are being written. Until then, the design notes in the repository are the reference for each part of the system.