How to Deploy OpenWebUI With xCloud One Click Apps

Updated November 16, 2026 · 7 min read

Summarize with:
Share:

You can deploy OpenWebUI on xCloud in a few clicks: New Site → search “OpenWebUI” → choose a server → Continue → Site Title, domain and admin login → Next. xCloud runs OpenWebUI in Docker on an NGINX server, puts it on your domain with HTTPS, and creates your admin account. You never write a docker-compose.yml. This guide is for teams and developers who want a private AI chat screen on a server they control.

OpenWebUI is a self-hosted web interface for AI models. It works with Ollama and OpenAI-compatible APIs, so the model you connect does the work and OpenWebUI gives you the chat screen, the accounts and the history. See the OpenWebUI hosting page for plans, or browse every app in the One Click Apps catalog.

Before you start

Requirement What you need Why it matters
Server stack An NGINX server OpenWebUI runs in Docker, and Docker apps run on NGINX servers. OpenLiteSpeed servers can’t run Docker.
Memory 4 GB RAM recommended The catalog recommends 4 GB. Add more if you plan to run Ollama models on the same server.
Disk Plan on 10 GB free xCloud needs 5 GB free to start the install (15 GB with Ollama). The download used about 7 GB on our test server, so plan on 10 GB.
A model Ollama, or an API key from a provider OpenWebUI has no model of its own. You connect one in Step 9.
Domain (optional) DNS access, if you choose Go Live Demo Site gives you a temporary address, so you can start without a domain.

What xCloud installs

Part What you get
App One OpenWebUI container, using the ghcr.io/open-webui/open-webui:main image. You get the newest release at install time. See the OpenWebUI releases page for the current version.
Your data Chats, accounts and uploads are stored in the data folder of your site, at /var/www/YOUR_DOMAIN/data.
Access OpenWebUI is only reachable through your domain over HTTPS, not by server IP and port.
Accounts Sign-up is closed. xCloud creates one admin account from the details in Step 5.
Limits The container can use up to 1 GB of memory and 0.2 of a CPU core, so pages can feel slow while it starts.

Step 1: Find OpenWebUI in the app catalog

In the xCloud dashboard, click New Site. On What would you like to host today?, type OpenWebUI in the search box, then click the OpenWebUI card.

Search for OpenWebUI in the New Site app catalog and click the OpenWebUI card

Expected result: The OpenWebUI page opens. It shows Runs on Nginx, Docker and Recommended: 4 GB RAM · 5 GB disk. The 5 GB is the minimum xCloud checks before it installs; plan on 10 GB, as noted in Before you start.

Step 2: Choose where OpenWebUI runs

Under Where should it run?, click an existing NGINX server card. The card shows the server’s RAM, CPU, free disk and number of sites. If you don’t have a suitable server, choose Deploy on a new server and xCloud creates one for you.

Select an NGINX server under Where should it run? on the OpenWebUI page

Then click Continue.

Expected result: The Install OpenWebUI Into page opens for the server you chose.

Step 3: Enter a Site Title

Under Site Details, type a name in Site Title, for example OpenWebUI. Use Add Tag (optional) only if your team sorts sites by tags.

Type a name in the Site Title field on the Install OpenWebUI page

Expected result: The Site Title field shows the name you typed.

Step 4: Choose Demo Site or Go Live

Under Domain Setup, pick one:

  • Demo Site: xCloud gives you a temporary domain. You can switch to your own domain later. Good for a first test.
  • Go Live: you enter your own domain, and point its DNS at the server.

Choose Demo Site under Domain Setup when installing OpenWebUI

Expected result: With Demo Site, xCloud fills in a Domain Name and a Site User for you. You can keep both.

Step 5: Set your admin login

Under Admin User, xCloud fills in a strong Admin Password and your account email as the Admin Email Address. Change either one if you like, and copy the password before you go on.

Copy the Admin Password and set the Admin Email Address on the Install OpenWebUI page

The Enable Ollama switch above these fields only turns on if the server already has an Ollama site. If it’s off, leave it. You can add Ollama after the install in Step 9.

Expected result: Both fields have a value. This is the login you use in Step 8.

Step 6: Click Next to install OpenWebUI

Check the details, then click Next.

Click Next at the bottom of the Install OpenWebUI form to start the installation

Expected result: xCloud opens the progress page. It checks the server, installs Docker if needed, sets up OpenWebUI, adds HTTPS and sets up the domain. On our test server this took about three minutes. When it finishes, the site opens in the dashboard.

If the install stops with a disk space error, free up space or pick a server with more free disk, then try again.

Step 7: Find your login details

In the site menu, open Access Data → Credentials. The Admin User is your email, and Admin Password is the password from Step 5.

Open Access Data then Credentials to see the Admin User and Admin Password for OpenWebUI

Expected result: You can copy both values from this page.

Step 8: Sign in to OpenWebUI

Click Visit Site at the top of the site page.

Click Visit Site at the top of the OpenWebUI site page

On Sign in to OpenWebUI, enter your Admin User email and Admin Password, then click Sign in.

Enter your email and password on the Sign in to OpenWebUI page

Expected result: The chat screen opens and greets you as Admin. If the site shows a 502 error first, wait a few minutes and reload. OpenWebUI is still starting.

Step 9: Connect a model

Until you connect a model, OpenWebUI shows Select a model with nothing to choose. Pick one of these two ways.

Option A: Run models on the same server with Ollama

In the site menu, open OpenWebUI → Enable Ollama.

Open OpenWebUI then Enable Ollama in the site menu

xCloud starts installing Ollama. It adds Ollama to the same server as a separate site, downloads a small first model (deepseek-r1:1.5b, about 1.1 GB) and restarts OpenWebUI. On our test server this took about three minutes. The server needs 15 GB of free disk for this.

Expected result: The menu now shows OpenWebUI → Management, with the model listed as Installed. Click Add New Model there to download more.

Ollama Management lists the installed deepseek-r1 model for OpenWebUI

OpenWebUI then shows the model’s name in the chat box, ready to use. Reload the page if you don’t see it yet.

The deepseek-r1 model selected in the OpenWebUI chat box

Every model needs memory, so match models to your server. For model sizes and how to remove a model, see How to Deploy Ollama With xCloud One Click Apps.

Option B: Use an API provider

In OpenWebUI, open your profile menu, then Admin Panel → Settings → Connections. Next to Manage OpenAI API Connections, click +, then enter your provider’s API URL and key. Any OpenAI-compatible provider works. The model runs at the provider, so your server doesn’t need extra memory for it.

Click the plus next to Manage OpenAI API Connections on the Connections page in OpenWebUI

Expected result: The provider’s models appear in the model list.

Add other people

xCloud installs OpenWebUI with sign-up closed, so strangers can’t create accounts on your domain. To add a teammate, open Admin Panel → Users in OpenWebUI and click Add User.

If you later turn sign-up on, new accounts wait as pending until an admin approves them.

Update OpenWebUI

xCloud has no Update button for OpenWebUI. The App Actions → Update option in the One Click App update guide is for apps installed from templates, and OpenWebUI is not one of them.

To update OpenWebUI, contact the xCloud support team and tell them the site’s domain. Don’t run docker compose yourself from the site folder: xCloud runs the app from its own copy of the compose file, not the docker-compose.yml you see there.

Back up first so your chats are safe if the update fails. See how to back up and restore Docker apps.

Troubleshooting

Problem Likely cause Fix
No server can be picked in Step 2 The server isn’t NGINX, or it’s short on free disk Use an NGINX server with enough free disk, or choose Deploy on a new server.
The install fails on disk space Less than 5 GB free, or 15 GB with Ollama Free up disk space, then try again.
Enable Ollama can’t be switched on during install The server has no Ollama site yet Finish the install, then use OpenWebUI → Enable Ollama.
The domain shows a 502 error right after install OpenWebUI is still starting Wait a few minutes and reload.
The login doesn’t work The password was changed after install Check Access Data → Credentials. If you changed it inside OpenWebUI, the page still shows the original one.
Select a model is empty No model is connected Follow Step 9.
A model is slow or won’t load The model is too big for the server’s RAM Pick a smaller model, or move to a server with more RAM or a GPU.

Frequently asked questions

Do I need to write a docker-compose.yml to deploy OpenWebUI on xCloud?

No. Pick OpenWebUI in the One Click Apps catalog, choose a server, fill in the site details and click Next. xCloud sets up the container, the domain and HTTPS for you.

Does OpenWebUI include an AI model?

No. OpenWebUI is the chat screen. Connect it to Ollama on the same server with Enable Ollama, or add an OpenAI-compatible API in its Admin Panel.

Can other people sign up on my OpenWebUI site?

Not by default. xCloud installs OpenWebUI with sign-up closed and creates one admin account for you. Add other people from the Admin Panel in OpenWebUI.

Does the Update action work for OpenWebUI?

No. App Actions and Update are for apps installed from templates, and OpenWebUI is not one of them. To update OpenWebUI, contact the xCloud support team.

If you run into any issues deploying OpenWebUI, feel free to reach out to our support team.