Open WebUI
A browser interface for OpenAI-compatible APIs and Ollama.
- One-click install
- Managed HTTPS
- Secrets in panel
- Multi-app VPS
Get Open WebUI running in minutes
Install Open WebUI from the VPSnet Applications catalog, claim secrets in the panel, open when HTTPS is ready, and finish initial setup in the app — without SSH as the default path.
Order a server and install
Order Cloud VPS or VDS, or open an existing service. Install Open WebUI from Applications — safe defaults apply when the recipe allows.
Claim one-time secrets in the panel
Usernames and passwords appear once in the VPSnet panel after install. Copy them when the credentials window opens — they are never emailed.
Open when HTTPS is ready
Most apps use managed HTTPS on a *.vpsnet.cloud host. Wait until the certificate is active, then Open URL from the panel — certificate pending is not an install failure.
Complete initial setup in the app
Sign in with the secrets you claimed (or finish the in-app admin wizard). Complete one real job for Open WebUI. If you enabled Optional packs at install, finish each pack’s first-run inside the app. Restart, logs, update, and uninstall stay in the Applications panel.
Continue reading the full install guide → — numbered steps, configuration variables, NOTES, and troubleshooting for Open WebUI.
How to install Open WebUI on VPSnet
Managed install of Open WebUI from the Applications panel — credentials in-panel, HTTPS included.
- 01. Choose a plan for Open WebUIOpen the Open WebUI product page and note minimum and recommended vCPU, RAM, and disk. Order a new Cloud VPS or VPS, or use a running server that still has free capacity.
- 02. Install from ApplicationsIn the service panel open Applications → Open WebUI → Install. Choose an access mode and expand Additional settings. If a customer-editable password field is offered, enter your own strong value or leave it empty for VPSnet to generate a random one. Confirm a runtime restart if the panel asks.
- 03. Save one-time credentialsWhen install finishes, the panel shows owner or admin credentials once. Copy them into your password manager immediately — they are never sent by email. If you closed the dialog too early, use the recovery path on that install in Applications.
- 04. Open the managed HTTPS URLWhen Open WebUI exposes a web UI, VPSnet assigns a *.vpsnet.cloud hostname. A short Certificate pending state is normal while DNS and SSL finish. When the status is active, use Open URL in Applications.
About the application
Chat with local or cloud AI models, compare models, work with files and organize prompts and knowledge bases in one browser interface.
Server requirements
| Requirement | vCPU | RAM | NVMe |
|---|---|---|---|
| Minimum | 2 | 4 GB | 25 GB |
| Recommended | 4 | 8 GB | 50 GB |
Tested compatibility
| Server type | Operating system | Architecture |
|---|---|---|
| VPS | Almalinux 10 | x86_64 |
| VPS and Cloud VPS | Almalinux 9 | x86_64 |
| VPS | Centos stream 10 | x86_64 |
| VPS and Cloud VPS | Centos stream 9 | x86_64 |
| VPS and Cloud VPS | Debian 12 | x86_64 |
| VPS and Cloud VPS | Debian 13 | x86_64 |
| VPS | Rocky 10 | x86_64 |
| VPS and Cloud VPS | Rocky 9 | x86_64 |
| VPS and Cloud VPS | Ubuntu 22.04 | x86_64 |
| VPS and Cloud VPS | Ubuntu 24.04 | x86_64 |
| VPS and Cloud VPS | Ubuntu 26.04 | x86_64 |
| Cloud VPS | Almalinux 8 | x86_64 |
| Cloud VPS | Arch latest | x86_64 |
| Cloud VPS | Oracle 9 | x86_64 |
| Cloud VPS | Rocky 8 | x86_64 |
What you will configure
These are the customer-editable fields for this recipe version. In the install dialog they live under Additional settings (Basics and Optional packs). Access mode is a separate control above that section. Generated passwords and owner accounts appear once as secrets in the panel after install — they are not free-text catalog fields unless listed below.
| Variable | Label | Type | Required | Secret | Default | Meaning |
|---|---|---|---|---|---|---|
ADMIN_NAME | Administrator name | string | Optional | No | Admin | Optional display name for an administrator created when both email and password are provided. |
ADMIN_EMAIL | Administrator email | email | Required Generated if left blank | Secret | — | Login email for the first administrator account. · Generated if left blank |
ADMIN_PASSWORD | Administrator password | string | Required Generated if left blank | Secret | — | Password for the first administrator account. · Generated if left blank |
USE_VPSNET_AI | Use the paid VPSnet AI API | boolean | Optional | No | false | Connect this application to the VPSnet AI API. Model usage is deducted from your account balance at current API rates; no free usage is included. |
OPENAI_API_BASE_URL | OpenAI-compatible API URL | url | Optional | No | — | Optional HTTPS endpoint. Leave blank to add OpenAI-compatible, Ollama or local connections in Open WebUI later. |
OPENAI_API_KEY | Provider API key | string | Optional | Secret | — | Optional credential for the OpenAI-compatible endpoint. |
Additional notes
- The install dialog has more than the variables table: Application access (VPSnet HTTPS, Private, Public IP, Managed HTTPS, External HTTPS when offered), Use VPSnet AI plus a model picker when the recipe supports it, Additional settings (Basics and Optional packs), and a runtime restart confirmation on the first managed install.
Frequently asked questions
01How do I install Open WebUI on a VPSnet server?
Choose Open WebUI while ordering and it will be installed automatically as soon as the server is ready. On an active server, open Applications, select Open WebUI and choose Install. You may leave optional settings blank or change them before installation.
02What are the minimum requirements for Open WebUI?
The catalog lists a minimum of 2 vCPU, 4 GB RAM and 25 GB NVMe for Open WebUI. Requirements may differ by server type; compare the table above.
03How can I access Open WebUI after installation?
During installation, you can use an automatically created VPSnet HTTPS address, choose a domain from your VPSnet account and enter its subdomain, provide an existing HTTPS address, open it through the server public IP over HTTP or keep the application private.
04How do I manage Open WebUI after installation?
In Applications, you can start, stop or restart Open WebUI, check its health and review recent activity. The same actions are available through the API and MCP.