Getting started

Install Opsaido with Docker, create your admin account and ask your first question — about five minutes.

What you need

MinimumRecommended
HostAny Linux, macOS or Windows machine with DockerA small VM or mini PC that’s always on
CPU / memory2 cores, 2 GB4 cores, 4 GB
Disk5 GB20 GB (history, backups, reports)
NetworkReach the systems you want to manageThe same network or VLANs as those systems
AIAn API key from a cloud provider, or a local modelSee AI providers and cost

Install and set up

  1. Start the container

    docker run -d --name opsaido -p 8443:8443 -v opsaido:/data ghcr.io/opsaido/opsaido:latest
  2. Open it at https://your-server:8443. The first start makes a self-signed certificate, so your browser warns you once.

  3. Create the admin account. The first person to open the page becomes the admin. Turn on two-step verification in Settings → Security straight away.

  4. Add an AI provider in Settings → AI providers: pick a preset, paste the API key, choose a model.

  5. Connect a system in Settings → Connectors: pick the type, fill in the address and login, press Test connection.

  6. Ask your first question in Chat.

Not sure what to ask? Type “give me some ideas”. Opsaido suggests requests built from the systems you’ve connected, including ones that combine several.

First questions to try

AskWhat happens
“How are my servers doing?”Checks every connected system and summarises what needs attention
“What’s using the disk space on web-01?”Finds the biggest folders and files, read-only
“Which updates are pending on the Proxmox nodes?”Lists updates per node, including kernel updates
“Dry run: restart the services that failed today”Rehearses each step and shows a plan to approve

Where to go next

To…Read
Add many servers at once, with shared loginsConnectors
Understand what needs approval and how plans workApprovals and dry runs
Keep AI costs lowAI providers and cost
Set up single sign-on, roles and your own certificateSecurity and access