Обзор развертывания North MiniCode (OpenWebUI) на сервере¶

Prerequisites¶

The following conditions are required for the application to function correctly:

Operating System: Ubuntu.
Kernel: HWE kernel (linux-generic-hwe-22.04).
Drivers: Presence of an NVIDIA GPU and installed recommended NVIDIA drivers.
Ports:
- 8080 — internal application port.
- 443 — external port (HTTPS).

FQDN of the final panel on hostkey.in domain¶

Parameter	Value
Prefix	`north-mini`
Domain	`hostkey.in`
Full Template	`north-mini{Server_ID_from_Invapi}.hostkey.in`

File and Directory Structure¶

Main directories used in the system:

/root/nginx — working directory for Nginx configuration and Docker Compose.
/data/nginx/user_conf.d — directory containing custom Nginx configurations.
/data/nginx/nginx-certbot.env — environment variables file for Certbot.

Application Installation Process¶

Deployment includes the following stages:

Updating system packages and installing the HWE kernel.
Installing NVIDIA drivers (if hardware is present).
Installing and launching Ollama via the official script.
Downloading the north-mini-code-1.0 LLM model into Ollama.
Deploying the OpenWebUI container.
Configuring Nginx reverse proxy with automatic SSL certificate acquisition via Certbot.

Docker Containers and Execution¶

The following containers are deployed in the system:

OpenWebUI¶

Image Name: ghcr.io/open-webui/open-webui:main
Network Mode: host
Volumes:
- open-webui:/app/backend/data
Environment Variables:
- OLLAMA_BASE_URL: http://127.0.0.1:11434
Restart Policy: always

Nginx (Certbot)¶

Image Name: jonasal/nginx-certbot:latest
Network Mode: host
Volumes:
- nginx_secrets:/etc/letsencrypt
- /data/nginx/user_conf.d:/etc/nginx/user_conf.d
Environment Variables: Loaded from file /data/nginx/nginx-certbot.env (including [email protected]).
Restart Policy: unless-stopped

Databases¶

The application uses Ollama as a backend for interacting with language models. OpenWebUI data is stored in the internal Docker volume open-webui.

Application Update Instructions¶

Updates are performed via pull and container restart. To update, execute the following commands: docker compose pull && docker compose up -d in the /root/nginx directory.