-
Notifications
You must be signed in to change notification settings - Fork 1.2k
[Add] GPT-OSS Marketplace Documentation #7395
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
josephcardillo-akamai
wants to merge
4
commits into
linode:develop
Choose a base branch
from
josephcardillo-akamai:add/gpt-oss-marketplace-guide
base: develop
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
+86
−0
Open
Changes from all commits
Commits
Show all changes
4 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -24,6 +24,7 @@ adodb | |
| adoptium | ||
| aes | ||
| ag | ||
| agentic | ||
| agentless | ||
| Agones | ||
| ahci0 | ||
|
|
||
85 changes: 85 additions & 0 deletions
85
docs/marketplace-docs/guides/gpt-oss-with-openwebui/index.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,85 @@ | ||
| --- | ||
| title: "Deploy GPT-OSS with Open WebUI through the Linode Marketplace" | ||
| description: "This guide includes instructions on how to deploy Open WebUI with GPT-OSS self-hosted LLM on an Akamai Compute Instance." | ||
| published: 2026-02-12 | ||
| modified: 2026-02-12 | ||
| keywords: ['gpt-oss', 'open-webui', 'vllm', 'ai', 'llm', 'llm-inference', 'openai-gpt-oss'] | ||
| tags: ["quick deploy apps", "cloud manager", "ai", "llm-inference", "llm"] | ||
| aliases: ['/products/tools/marketplace/guides/gpt-oss-with-openwebui/'] | ||
| external_resources: | ||
| - '[Open WebUI Documentation](https://docs.openwebui.com/getting-started/)' | ||
| - '[GPT-OSS 20B on Hugging Face](https://huggingface.co/openai/gpt-oss-20b)' | ||
| - '[GPT-OSS 120B on Hugging Face](https://huggingface.co/openai/gpt-oss-120b)' | ||
| authors: ["Akamai"] | ||
| contributors: ["Akamai"] | ||
| license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' | ||
| marketplace_app_id: 2011885 | ||
| marketplace_app_name: "GPT-OSS with Open WebUI" | ||
| --- | ||
|
|
||
| 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. | ||
|
|
||
| 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. | ||
|
|
||
| ## Deploying a Marketplace App | ||
|
|
||
| {{% content "deploy-marketplace-apps-shortguide" %}} | ||
|
|
||
| {{% content "marketplace-verify-standard-shortguide" %}} | ||
|
|
||
| {{< note title="Estimated deployment time" >}} | ||
| Open WebUI with GPT-OSS should be fully installed within 5-10 minutes after the Compute Instance has finished provisioning. | ||
| {{< /note >}} | ||
|
|
||
| ## Configuration Options | ||
|
|
||
| - **Recommended plan for GPT-OSS 20B (default):** RTX4000 Ada x1 Small (16GB RAM minimum) | ||
| - **Recommended plan for GPT-OSS 120B:** RTX4000 Ada x1 Large or higher (64GB RAM minimum) | ||
|
|
||
| {{< note type="warning" >}} | ||
| 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. | ||
| {{< /note >}} | ||
|
|
||
| ### GPT-OSS Options | ||
|
|
||
| - **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. | ||
|
|
||
| - **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. | ||
|
|
||
| - **Open WebUI admin name.** *(required)*: This is the name associated with your login and is required by Open WebUI during initial enrollment. | ||
|
|
||
| - **Open WebUI admin email.** *(required)*: This is the email used to login into Open WebUI. | ||
|
|
||
| - **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. | ||
|
|
||
| {{% content "marketplace-required-limited-user-fields-shortguide" %}} | ||
|
|
||
| {{% content "marketplace-special-character-limitations-shortguide" %}} | ||
|
|
||
| ## Getting Started After Deployment | ||
|
|
||
| ### Accessing Open WebUI Frontend | ||
|
|
||
| Once your app has finished deploying, you can log into Open WebUI using your browser. | ||
|
|
||
| 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: | ||
|
|
||
| ```command | ||
| ssh {{< placeholder "USER" >}}@{{< placeholder "IP_ADDRESS" >}} | ||
| ``` | ||
| 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. | ||
|
|
||
|  | ||
|
|
||
| 3. Return to your terminal, and open the `.credentials` file with the following command. Replace `{{< placeholder "USER" >}}` with your sudo username: | ||
|
|
||
| ```command | ||
| sudo cat /home/{{< placeholder "USER" >}}/.credentials | ||
| ``` | ||
| 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: | ||
|
|
||
|  | ||
|
|
||
| Once you hit the "Okay, Let's Go!" button, you can start to use the chat feature in Open WebUI. | ||
|
|
||
|  | ||
Binary file added
BIN
+13.9 KB
docs/marketplace-docs/guides/gpt-oss-with-openwebui/openwebui-login.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.