Connect Your First Server
Connecting a server to RasnuCloud takes under two minutes, and you never have to touch your server manually to do it. RasnuCloud handles its own setup automatically the moment you provide your credentials.
What You'll Need
- A Linux server (any distribution — Ubuntu, Debian, CentOS, Alpine, Fedora, and more)
- SSH access with root or a user with full sudo privileges
- A password or an SSH private key
That's it. No firewall rules to add, no software to pre-install, no configuration to write.
Step 1 — Add Your Server
From your RasnuCloud dashboard, click Connect New Node in the top-right corner of the Server Fleet page.
Fill in the connection details:
| Field | What to Enter |
|---|---|
| Name | Something you'll recognize — "Production API", "Staging DB", "EU-West Node" |
| Host | Your server's IP address or hostname |
| Port | SSH port — 22 unless you've changed it |
| Username | Usually root. Must have sudo access. |
| Authentication | Paste your password or SSH private key |
SSH Keys are Recommended
Private keys are significantly more secure than passwords. You can use your existing key — paste the full contents of your private key directly into the field.
Step 2 — RasnuCloud Takes It From There
Click Connect. RasnuCloud will:
- Verify your credentials and confirm the connection is reachable
- Detect your server's hardware architecture
- Install the RasnuCloud agent — a small, lightweight binary that runs as a background service on your server
- Map your entire infrastructure — every installed package, running service, open port, database, container, and more
- Display a live summary of your server on the dashboard
You watch all of this happen in real time in the installation terminal. The entire process typically completes in 30–90 seconds.
What is the RasnuCloud agent?
The agent is the only component that lives on your server. It's a small, statically compiled binary that:
- Executes commands on behalf of your RasnuCloud AI conversations
- Sends infrastructure mapping data when you connect and rescan
- Sends a heartbeat every 60 seconds so RasnuCloud knows your server is online
The agent runs as a system service and starts automatically on boot. It is open source — you can inspect every line of code.
Step 3 — Your Server is Ready
Once setup completes, your server appears as Verified in the dashboard. You'll immediately see a rich summary of your infrastructure — OS version, CPU and memory, installed packages, running services, open ports, and more.
You're ready to have your first conversation →
Troubleshooting
"Connection failed — authentication error" Double-check your username and credentials. For private keys, make sure you're pasting the private key, not the public key.
"Connection timed out" Confirm the host is reachable on the SSH port. If your server uses a non-standard port, set it correctly in the Port field.
"Agent installation failed" Your server needs outbound internet access to download the agent. Verify that outbound connections are not blocked by a firewall rule.
Your credentials are encrypted
Your SSH password and private key are encrypted at rest and only ever decrypted in memory at the moment of use. They are never logged, never stored in plaintext, and never transmitted to third parties.