NjordDeploy Deployment Wizard

Network Discovery

We need to find supported single-board computers (Raspberry Pi, Orange Pi, ODROID, Radxa, or Pine64) on your network to begin.

Getting Started & Prerequisites

Checklist & AI Setup

Deployment Checklist

Target Machine: Raspberry Pi, Orange Pi, ODROID, VM, or server running Debian/Ubuntu (64-bit recommended).
SSH Access: Port 22 open with sudo permissions. Key-based authentication recommended (ssh-copy-id username@target-ip).
Network Scanner: nmap installed locally for auto-discovery (sudo apt install nmap), or use Direct IP / Tailscale / Proxmox.
Container Engine: Choose Docker CE or rootless Podman via the topbar switcher.

AI Diagnostics & LLM Keys (Optional)

NjordDeploy features AI Failure Diagnosis & Component Generation. Configure your API keys in Settings or via .env:

Google Gemini Key OpenAI Key Claude Key HostYourAI (EU) Ollama (Offline / No Key)

Manage all keys and endpoints: Configure in Settings

Auto-Detect (Recommended)

Scans your current local subnet automatically.

Manual Subnet Scan

Use this if you are on a different VLAN or VPN.

Direct IP / Hostname / MAC Deployment

Target a specific host or local MAC address directly, bypassing standard discovery.

Tailscale / Headscale Mesh Discovery Checking...

Automatically discover online nodes across your Tailscale / Headscale overlay network.

Create New Proxmox LXC Target

Provision a brand new LXC container on your Proxmox VE server automatically.

Create New Proxmox VM Target

Clone and provision a brand new QEMU VM from a Proxmox template.

Select Existing Proxmox Target

Deploy to an existing VM or LXC container on your Proxmox server.

Auto-Detect Local Subnet (L2 ARP Broadcast)

Scans your primary local subnet using L2 ARP broadcasts. Best for Raspberry Pi or SBCs on your local network.

ssh-copy-id pi@192.168.1.50

SSH Key Authentication Tip: For passwordless deployment or servers with password login disabled, authorize your public SSH key on the target node using:
ssh-copy-id username@target-ip

Configure your container orchestration engine and component template repository source.

1. Container Engine

Docker CE (Standard)

Standard Docker daemon. Requires sudo or docker group permissions.

Podman (Rootless)

Daemonless rootless execution. Configures kernel unprivileged ports (≥ 53) & user lingering.

2. Components Repository Source

NjordDeploy Scope: This manager exclusively detects, archives, and restores services, persistent volumes, and configurations managed by NjordDeploy (under /opt/njorddeploy). External host directories and unmanaged system processes are not affected.

Target Host IP / Hostname

SSH Username

SSH Password

Stack Directory

Auto-detects compose stacks.

Select NjordDeploy services to include in archive:

Inspecting target host volumes...

Pause active containers during archiving for transactional consistency (recommended for databases)

Available backup archives on target host:

	Archive File	Date Created	Size
Loading archives...

Self-Hosting Made Simple in 4 Easy Steps

NjordDeploy provisions and orchestrates containerized services on Single-Board Computers (Raspberry Pi, Orange Pi, ODROID), cloud/local Linux servers, and Proxmox LXC/VMs.

1. Target Discovery

Find target SBCs automatically via local L2 ARP scan, sweep custom CIDR subnets, target direct IPs / Tailscale mesh nodes, or provision new Proxmox LXCs/VMs.

2. SSH Connection

Connect securely to your target machine using SSH key authentication (ssh-copy-id) or password with standard sudo privileges.

3. Select Services

Pick from 45+ modular container stacks (AdGuard Home, Vaultwarden, Nextcloud, etc.). NjordDeploy automatically checks for port and storage conflicts.

4. Live Deployment

Watch live Ansible streaming logs, verify container status, launch your web UIs with direct links, and manage backups with the built-in backup manager.

Don't show this quick start guide on startup