Servers

A server is the machine where Nebion deploys your environments. Each server runs Docker and is connected to Nebion via SSH.

Docker Hosting

Runs containers for all your project environments

SSH Access

Secure key-based authentication for deployments

File Storage

Upload database dumps, assets, and configuration files

Multi-Project

Share one server across multiple projects

Prerequisites

Before adding a server to Nebion, make sure you have:

• A Linux server with Docker installed
• SSH access to the server (port 22 open)
• An SSH keypair for Nebion to use

Generating an SSH Keypair

ssh-keygen -t ed25519 -f nebion-key -C "nebion"

This creates two files:

• nebion-key — Private key → paste into Nebion when adding the server
• nebion-key.pub — Public key → add to ~/.ssh/authorized_keys on your server

On the server:

# Append the public key to the SSH user's authorized_keys
cat nebion-key.pub >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys

Adding a Server

1. Click New server

   From the Servers page, click the New server button.

2. Fill in the server details

   Field	Required	Description
   Title	Yes	A name for the server (e.g., Production EU, Staging US)
   SSH User	No	Username for SSH connections (default: web)
   Server IP	No	IP address of the server
   SSH private key	Yes	Private key for SSH authentication to the server
   SSH Public Key	Yes	Corresponding public key

3. Save

   Your server is created. Nebion generates it on the Servers list ready to be assigned to projects.

TIP

After saving, click Test Connection on the server overview to verify Nebion can reach your server.

Server Page

Each server has three tabs:

OverviewConfigureFiles

Overview

Shows server details and actions:

• Server Information — IP address, organization, connection status, active environments, last deployment
• Connected Projects — Projects assigned to this server, with their role (Development/Production)
• Quick Actions:
  • Public SSH Key — View and copy the server's public key
  • Test Connection — Verify SSH connectivity to the server
  • Verify Setup — Check that the SSH key is properly configured
  • View Logs — Server operation history

Configure

Edit server settings: title, SSH user, server IP, SSH keys.

Files

Upload files that are synchronized to the server. Use this for database dumps, image archives, or other assets your environments need.

• Files are synced to the server's storage directory
• Uploading a file with the same name overwrites the existing file
• Allowed types: txt, sql, zip, gz, md
• Size limit: 1 GB per file

Assigning Servers to Projects

Servers are linked to projects through the project's Settings tab. Each project can have:

• Development server — Used for PR environments and testing
• Production server — Used for production deployments

A single server can be shared across multiple projects within the same organization.

Connection Status

Status	Meaning
Ready	Server is reachable and SSH connection works
Pending	Server has been added but connection has not been verified yet

After adding a server, use Test Connection on the server overview to verify connectivity. If the test fails, check that:

• The server IP is correct and reachable
• The SSH key is authorized on the server
• The SSH user exists and has the required permissions
• Port 22 is open on the server