Skip to content

Open WebUI OCI

Open WebUI is an extensible, self-hosted AI interface that adapts to your workflow, all while operating entirely offline.

View the synix NixOS module on Forgejo.

References

Configuration

{
  imports = [ inputs.synix.nixosModules.open-webui-oci ];

  services.open-webui-oci.enable = true;

  # You can provide an image to use:
  services.open-webui-oci.image = pkgs.dockerTools.pullImage {
    imageName = "ghcr.io/open-webui/open-webui";
    imageDigest = "sha256:2deb90b0423473d8f97febced2e62b8fd898aa3eb61877bb3aa336370214c258";
    hash = "sha256-2cdKfvZGUyPUm7TFXcf5OcG9ey4BvOZPUOVim1S2C+s=";
    finalImageName = "ghcr.io/open-webui/open-webui";
    finalImageTag = "0.8.5";
  };
}

You can use nix-prefetch-docker to get the attribute set to pass to dockerTools.pullImage:

nix run nixpkgs#nix-prefetch-docker -- --image-name ghcr.io/open-webui/open-webui --arch amd64 --os linux --image-tag 0.8.5

Usage

Visit the web interface at your specified location to create an admin account.

The default location is http://127.0.0.1:8080.

Troubleshooting

JSON parse error

If you get this error in the web interface:

SyntaxError: Unexpected token 'd', "data: {"id"... is not valid JSON category

Clear your browser cache. Steps on Chromium based browsers:

  1. Open DevTools (F12) → Right-click refresh button
  2. Click "Empty Cache and Hard Reload"