Skip to content

Commit 6b8630e

Browse files
josephcardillo-akamaijddocsn0vabyte
authored
[Add] GPT-OSS Marketplace Documentation (#7395)
* initial commit * updates * dictionary addition and copy edit * Update docs/marketplace-docs/guides/gpt-oss-with-openwebui/index.md Co-authored-by: n0vabyte <94801247+n0vabyte@users.noreply.github.com> --------- Co-authored-by: jddocs <jdutton@akamai.com> Co-authored-by: n0vabyte <94801247+n0vabyte@users.noreply.github.com>
1 parent f83f21f commit 6b8630e

5 files changed

Lines changed: 86 additions & 0 deletions

File tree

ci/vale/dictionary.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@ adodb
2424
adoptium
2525
aes
2626
ag
27+
agentic
2728
agentless
2829
Agones
2930
ahci0
Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
---
2+
title: "Deploy GPT-OSS with Open WebUI through the Linode Marketplace"
3+
description: "This guide includes instructions on how to deploy Open WebUI with GPT-OSS self-hosted LLM on an Akamai Compute Instance."
4+
published: 2026-02-12
5+
modified: 2026-02-12
6+
keywords: ['gpt-oss', 'open-webui', 'vllm', 'ai', 'llm', 'llm-inference', 'openai-gpt-oss']
7+
tags: ["quick deploy apps", "cloud manager", "ai", "llm-inference", "llm"]
8+
aliases: ['/products/tools/marketplace/guides/gpt-oss-with-openwebui/']
9+
external_resources:
10+
- '[Open WebUI Documentation](https://docs.openwebui.com/getting-started/)'
11+
- '[GPT-OSS 20B on Hugging Face](https://huggingface.co/openai/gpt-oss-20b)'
12+
- '[GPT-OSS 120B on Hugging Face](https://huggingface.co/openai/gpt-oss-120b)'
13+
authors: ["Akamai"]
14+
contributors: ["Akamai"]
15+
license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)'
16+
marketplace_app_id: 2011885
17+
marketplace_app_name: "GPT-OSS with Open WebUI"
18+
---
19+
20+
Open WebUI is an open-source, self-hosted web interface for interacting with and managing Large Language Models (LLMs). It supports multiple AI backends, multi-user access, and extensible integrations, enabling secure and customizable deployment for local or remote model inference.
21+
22+
The Marketplace application deployed in this guide uses OpenAI GPT-OSS, a family of open-weight large language models designed for powerful reasoning, agentic tasks, and versatile developer use cases. During deployment, you can choose between two model sizes: GPT-OSS 20B (default) or GPT-OSS 120B. These models are released under the permissive Apache 2.0 license and integrate well with self-hosted platforms like Open WebUI for general-purpose assistance, coding, and knowledge-based workflows.
23+
24+
## Deploying a Marketplace App
25+
26+
{{% content "deploy-marketplace-apps-shortguide" %}}
27+
28+
{{% content "marketplace-verify-standard-shortguide" %}}
29+
30+
{{< note title="Estimated deployment time" >}}
31+
Open WebUI with GPT-OSS should be fully installed within 5-10 minutes after the Compute Instance has finished provisioning.
32+
{{< /note >}}
33+
34+
## Configuration Options
35+
36+
- **Recommended plan for GPT-OSS 20B (default):** RTX4000 Ada x1 Small (16GB RAM minimum)
37+
- **Recommended plan for GPT-OSS 120B:** RTX4000 Ada x1 Large or higher (64GB RAM minimum)
38+
39+
{{< note type="warning" >}}
40+
This Marketplace App only works with Akamai GPU instances. If you choose a plan other than GPUs, the provisioning will fail, and a notice will appear in the LISH console.
41+
{{< /note >}}
42+
43+
### GPT-OSS Options
44+
45+
- **Linode API Token** *(required)*: Your API token is used to deploy additional Compute Instances as part of this cluster. At a minimum, this token must have Read/Write access to *Linodes*. If you do not yet have an API token, see [Get an API Access Token](/docs/products/platform/accounts/guides/manage-api-tokens/) to create one.
46+
47+
- **Email address (for the Let's Encrypt SSL certificate)** *(required)*: Your email is used for Let's Encrypt renewal notices. This allows you to visit Open WebUI securely through a browser.
48+
49+
- **Open WebUI admin name.** *(required)*: This is the name associated with your login and is required by Open WebUI during initial enrollment.
50+
51+
- **Open WebUI admin email.** *(required)*: This is the email used to login into Open WebUI.
52+
53+
- **GPT-OSS Model Size** *(required)*: Select the model size for deployment. Options are `20B` (default, requires 16GB+ RAM) or `120B` (requires 64GB+ RAM). Choose based on your GPU plan and performance requirements.
54+
55+
{{% content "marketplace-required-limited-user-fields-shortguide" %}}
56+
57+
{{% content "marketplace-special-character-limitations-shortguide" %}}
58+
59+
## Getting Started After Deployment
60+
61+
### Accessing Open WebUI Frontend
62+
63+
Once your app has finished deploying, you can log into Open WebUI using your browser.
64+
65+
1. Log into the instance as your limited sudo user, replacing `{{< placeholder "USER" >}}` with the sudo username you created, and `{{< placeholder "IP_ADDRESS" >}}` with the instance's IPv4 address:
66+
67+
```command
68+
ssh {{< placeholder "USER" >}}@{{< placeholder "IP_ADDRESS" >}}
69+
```
70+
2. Upon logging into the instance, a banner appears containing the **App URL**. Open your browser and paste the link to direct you to the login for Open WebUI.
71+
72+
!["Open WebUI Login Page"](openwebui-login.png "Open WebUI Login Page")
73+
74+
3. Return to your terminal, and open the `.credentials` file with the following command. Replace `{{< placeholder "USER" >}}` with your sudo username:
75+
76+
```command
77+
sudo cat /home/{{< placeholder "USER" >}}/.credentials
78+
```
79+
4. In the `.credentials` file, locate the Open WebUI login email and password. Go back to the Open WebUI login page, and paste the credentials to log in. When you successfully login, you should see the following page:
80+
81+
!["Open WebUI Welcome 1"](openwebui-w1.png "Open WebUI Welcome 1")
82+
83+
Once you hit the "Okay, Let's Go!" button, you can start to use the chat feature in Open WebUI.
84+
85+
!["Open WebUI Welcome 2"](openwebui-w2.png "Open WebUI Welcome 2")
13.9 KB
Loading
155 KB
Loading
155 KB
Loading

0 commit comments

Comments
 (0)