Quick Start

Sign up

Navigate to your oCore instance (e.g., http://localhost:3000) and click Sign Up. Enter your name, email address, and a password.

Password requirements:

• Minimum 8 characters
• At least 1 letter
• At least 1 number

After signing up, verify your email address if email verification is enabled. Check your inbox for a verification link from oCore.

Create an organization

After signing in, you will be prompted to create your first organization. An organization in oCore is the top-level container for all your resources -- servers, projects, instances, and team members.

Enter a name for your organization (e.g., "My Company") and an optional slug (e.g., my-company). The slug is auto-generated from the name if left blank.

• Slug must be 3-50 characters
• Only lowercase letters, numbers, and hyphens
• Must be unique across your oCore instance

You are automatically assigned the Owner role, giving you full control over the organization. You can invite team members later.

Navigate to servers

In the oCore dashboard, navigate to Servers in the sidebar, then click Add Server.

Enter server details

Fill in the server connection details:

• Name: A friendly name for this server (e.g., "Production Server 1")
• Hostname: The IP address or domain name of the server (e.g., 192.168.1.100 or server.example.com)
• Port: SSH port (default: 22)
• Username: SSH user (e.g., root or a sudo-capable user)
• Authentication: Choose SSH key (recommended) or password

Verify the connection

After saving, oCore tests the SSH connection to your server. You will see a status indicator:

• Connected -- SSH connection successful, server is reachable
• Failed -- Connection failed (check credentials, firewall, SSH configuration)

If the connection fails, verify:

1. The server is reachable from the oCore host (ping <hostname>)
2. SSH is running on the specified port (ssh -p <port> <user>@<hostname>)
3. The credentials are correct
4. No firewall is blocking the connection

Agent installation

Once connected, oCore installs a lightweight monitoring agent on the server. The agent collects:

• System metrics: CPU usage, memory usage, disk usage, load average
• Docker metrics: Container count, container states, resource usage per container
• Network metrics: Bandwidth usage, connection counts

The agent runs as a systemd service and reports metrics back to oCore at regular intervals. It also enables oCore to manage Docker containers on the server for Odoo instance deployments.