Frequently Asked Questions

How do I run DevPortal locally?

Use the DevPortal 3.x local quickstart, which runs the portal with devportal-local.

Which Helm chart installs DevPortal on Kubernetes?

Use the devportal Helm chart. Start with the installation plan to prepare its requirements.

Does the chart install PostgreSQL?

No. The chart installs no database, and DevPortal requires PostgreSQL. See the installation plan and PostgreSQL setup step.

Which default does the chart use for guest sign-in?

From chart 1.0.4, guest sign-in is off. Chart 1.0.3 and earlier turn it on and map guests to user:default/admin. Set global.veecode.guestAuth.enabled: false in the chart values to turn it off on any chart version. See the setup guide and its install values.

How do I move an existing 2.x installation to 3.x?

Follow the 2.x-to-3.x migration guide.

Where can I find the 3.x support policy?

See Support for the release support policy and troubleshooting route.

Container startup

Why does the Marketplace look empty?

The Marketplace fills after the catalog finishes loading. On a fresh local database, the first start takes two to three minutes; see the local quickstart. The Marketplace lists the plugins from a catalog index image that the plugin install step pulls. If it stays empty, read that step's output, shown in the next answer. A cluster without internet access must mirror that image; see Install without internet access.

Why does the portal not start locally?

The devportal service waits for the install-dynamic-plugins service to finish successfully before it starts. Read that step's output with:

docker compose logs install-dynamic-plugins

The portal does not become ready on Kubernetes

Check the plugin installer log and rollout status with these commands:

kubectl -n "$NAMESPACE" logs deployment/devportal-developer-hub -c install-dynamic-plugins
kubectl -n "$NAMESPACE" rollout status deployment/devportal-developer-hub

Why does a local configuration key have no effect?

Compose loads the product configuration fragment last by default. Add your fragment after it when you need to override a product value. Configuration arrays replace earlier arrays, so include the full array in your override. See Add configuration to the local stack.

Authentication

Why can a user not sign in after Keycloak accepts their credentials?

DevPortal signs a user in only after it imports that user from Keycloak. With the values in the setup guide, the first import runs 15 seconds after startup, then runs every five minutes. If the user is not in the catalog yet, wait for the next import and try again. See Step 7: Sign in and check.

Presets

Does DevPortal 3.x use presets?

No. DevPortal 3.x has no preset model. Its default plugins come from the plugin catalog index, and provider settings are configured explicitly. See the 2.x-to-3.x migration guide.

Plugins

How do I enable a plugin?

Open Marketplace after the catalog finishes loading and select a plugin to install. For a local portal, you can also add a plugin entry to the operator plugin file. See Configure dynamic plugins for the local stack. For Kubernetes, configure additions and overrides through chart values. See Disable a default plugin.

Do I need to copy the default plugins into chart values?

No. The plugin catalog index ships its default plugins. Use chart values for additions or overrides. See Disable a default plugin for the override form.