Installation Requirements

Server Requirements

Minimum Requirements

Supported Operating Systems

• Ubuntu 20.04 LTS or later
• Debian 11 (Bullseye) or later
• Rocky Linux 8 or later
• AlmaLinux 8 or later

Required Software

Nurosentrix will automatically install these on your server:

• Docker Engine 20.10+
• Docker Compose v2
• PostgreSQL 14+ (in Docker)
• Nginx (as reverse proxy)
• Certbot (for SSL certificates)

Network Requirements

Required Ports

Outbound Access

Your server needs outbound access to:

• api.nurosentrix.com - Nurosentrix API
• registry.hub.docker.com - Docker images
• github.com - For custom module installation
• Your backup storage (S3, GCS, Azure Blob)

Adding a Server (BYOS)

Prerequisites

1. A fresh server with a supported OS
2. Root or sudo access
3. SSH access enabled

Step 1: Generate SSH Key (if needed)

In the Nurosentrix dashboard, go to Settings → SSH Keys and either:

• Generate a new SSH key pair
• Upload your existing public key

Step 2: Add the Public Key to Your Server

# On your server, add the Nurosentrix public key
echo "YOUR_PUBLIC_KEY" >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys

Step 3: Add Server in Dashboard

1. Go to Servers → Add Server → BYOS
2. Enter your server's IP address or hostname
3. Select the SSH key to use
4. Click "Connect" to verify access

In the dashboard, navigate to Servers → Add Server and choose either BYOS or Cloud Provider.

Step 4: Server Provisioning

Once connected, Nurosentrix will automatically install the required software and configure your server. This process typically takes 5-10 minutes.

Cloud Provider Integration

DigitalOcean

1. Go to Settings → Cloud Credentials → Add Provider
2. Select DigitalOcean
3. Enter your API token (generate at cloud.digitalocean.com/account/api/tokens)
4. Click "Connect" to verify

Vultr

1. Go to Settings → Cloud Credentials → Add Provider
2. Select Vultr
3. Enter your API key (generate at my.vultr.com/settings/#settingsapi)
4. Click "Connect" to verify

All connected servers appear in the Servers list, along with their status, region, and available resources.

Troubleshooting

SSH Connection Failed

• Verify the server IP address is correct
• Check that port 22 is open in your firewall
• Ensure the SSH key is correctly added to authorized_keys
• Try connecting manually: ssh root@your-server-ip

Provisioning Stuck

• Check server has internet access
• Verify the server meets minimum requirements
• Check Docker installation: docker --version
• View logs in the Nurosentrix dashboard