Getting started
Install Opsaido with Docker, create your admin account and ask your first question — about five minutes.
What you need
| Minimum | Recommended | |
|---|---|---|
| Host | Any Linux, macOS or Windows machine with Docker | A small VM or mini PC that’s always on |
| CPU / memory | 2 cores, 2 GB | 4 cores, 4 GB |
| Disk | 5 GB | 20 GB (history, backups, reports) |
| Network | Reach the systems you want to manage | The same network or VLANs as those systems |
| AI | An API key from a cloud provider, or a local model | See AI providers and cost |
Install and set up
-
Start the container
docker run -d --name opsaido -p 8443:8443 -v opsaido:/data ghcr.io/opsaido/opsaido:latest -
Open it at
https://your-server:8443. The first start makes a self-signed certificate, so your browser warns you once. -
Create the admin account. The first person to open the page becomes the admin. Turn on two-step verification in Settings → Security straight away.
-
Add an AI provider in Settings → AI providers: pick a preset, paste the API key, choose a model.
-
Connect a system in Settings → Connectors: pick the type, fill in the address and login, press Test connection.
-
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
| Ask | What 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 logins | Connectors |
| Understand what needs approval and how plans work | Approvals and dry runs |
| Keep AI costs low | AI providers and cost |
| Set up single sign-on, roles and your own certificate | Security and access |