Application Services¶

Overview¶

flowchart TD
    subgraph APP["<div style='margin-top:10px; white-space: nowrap;'>App Instance (e.g. production)</div>"]
        subgraph sapp[ ]
            direction LR
            app1["app service"]
            app2["app service"]
            appEllipsis["..."]
            app3["app service"]
        end
        style sapp fill:none,stroke:none,stroke-width:0px
    end

    subgraph SR["<div style='margin-top:10px; white-space: nowrap;'>Stack Revision</div>"]
        subgraph sstack[ ]
            direction LR
            stack1["stack service"]
            stack2["stack service"]
            stackEllipsis["..."]
            stack3["stack service"]
        end
        style sstack fill:none,stroke:none,stroke-width:0px
    end

    subgraph sr[ ]
        direction LR
        svc1["service revision"] 
        svc2["service revision"] 
        svcEllipsis["..."]
        svc3["service revision"]
    end
    style sr fill:none,stroke:none,stroke-width:0px

    app1 -.-> stack1
    app2 -.-> stack2
    app3 -.-> stack3

    stack1 -.-> svc1
    stack2 -.-> svc2
    stack3 -.-> svc3

    APP --> SR

    classDef serviceRevision fill:#f0f0ff,stroke:#9370db,stroke-width:1px
    classDef stackRevision fill:#e6f0e6,stroke:#5c6bc0,stroke-width:2px
    classDef stackService fill:#f5f7ff,stroke:#8c9eff,stroke-width:1px
    classDef appInstance fill:#ffffff,stroke:#424242,stroke-width:1px
    classDef appService fill:#ffffff,stroke:#424242,stroke-width:1px
    classDef ellipsis fill:none,stroke:none

    class svc1,svc2,svc3 serviceRevision
    class SR stackRevision
    class stack1,stack2,stack3 stackService
    class APP appInstance
    class app1,app2,app3 appService
    class stackEllipsis,appEllipsis,svcEllipsis ellipsis

An application service is the per-app-instance representation of a stack service.

When you create a new app, Wodby creates one app service for each relevant stack service. The app service starts with stack defaults, then lets you override behavior for that specific app instance.

This is the main place to customize how one environment behaves without changing the stack for every other environment.

Inside Apps > [Instance] > Services > [Service], the dashboard can show:

Overview
Configure
Database
Integrations
Env vars
Helm
Resources
Links
Volumes
Settings
Configs
Tokens
Annotations

Not every app service gets every tab. The menu depends on the service type and whether it is external or derivative.

In general:

Database appears only for services with database support
Env vars, Helm, and Resources appear only for non-external services
Links, Volumes, Settings, and Configs appear only when the service supports them
Tokens appear only for non-external top-level services
Annotations appear only for non-external services

Overview tab¶

The Overview tab shows the current state of the app service, including:

status
machine name
title
version
linked service revision
container images
build image, if the service is built
last build
last deploy

The same screen also exposes Connect via web terminal.

The web terminal button is available only when both the app instance and the app service are in a healthy OK state. It opens an interactive shell session in a separate window. If the service has multiple workloads or containers, you can target a specific one. Otherwise Wodby uses the primary workload and its first container automatically.

Configure tab¶

The Configure tab is the main operational form for the service.

Depending on the service, you can:

enable or disable the service
mark it as the main service when it exposes HTTP routes
change the service version
change the number of replicas for non-external services
change build source settings for buildable services

Changing app-service configuration can mark the app instance as needing rebuild, because some changes affect the build output or deployment manifests.

Build source¶

If a service is buildable, the app service includes build-source controls.

You can point the service to a Git repository and a reference such as:

branch
tag
commit SHA

The available options depend on your CI mode and Git integrations. Build source is chosen during app creation, but can also be changed later from the app service.

Database tab¶

The Database tab appears for services that can attach to a database resource.

From there you can choose:

database user
DB

The available choices are filtered by databases visible in the current project context and by actual user-to-DB access inside the selected database resource.

Integrations tab¶

If a service supports integrations, the Integrations tab lets you attach compatible integrations of the required type.

This is commonly used for storage, mail, monitoring, or other provider-backed features exposed by the service.

Env vars tab¶

The Env vars tab lets you add, remove, or override environment variables for the app service.

Some values are inherited and cannot be deleted directly, but they can usually be overridden. Inherited variables can come from:

the service manifest
the stack manifest
linked services such as databases
settings

Env vars can be global for the whole service or scoped to a specific workload and container. If you do not specify a target, the variable is applied to all containers in the service.

Wodby also adds system variables to every container:

Variable	Description
`WODBY_APP_NAME`	Machine name of the application
`WODBY_INSTANCE_NAME`	Machine name of the application instance
`WODBY_ENVIRONMENT_NAME`	Name of the environment
`WODBY_ENVIRONMENT_TYPE`	Type of the environment
`WODBY_HOSTS`	List of domains from enabled HTTP routes
`WODBY_PRIMARY_HOST`	Hostname from the enabled main app service with an HTTP route
`WODBY_PRIMARY_URL`	URL (`https` if certificate attached) of the enabled main app service with an HTTP route

Helm tab¶

The Helm tab lets you add or override Helm values for the app service.

Use this when a specific environment needs a chart-level override without changing the stack for every other environment.

App-level Helm values override values coming from the service and stack. Helm values can also be stored as secrets.

Resources tab¶

The Resources tab lets you configure CPU and memory requests and limits per workload and container.

CPU values are set in millicores, where 1000 means 1 CPU core. Memory values are set in megabytes in the dashboard UI.

Resource requests directly affect whether the service can be scheduled. If the cluster does not have enough available CPU or memory for the requested pod size, the pod stays pending until enough capacity becomes available. If cluster autoscaling is enabled, the cluster may add nodes to satisfy that demand.

Apps running on a demo cluster cannot change service resources.

Replicas¶

Replicas are configured from Configure, but they directly affect service scaling.

Stateless app services can be scaled by increasing replicas for higher throughput and high availability. Replicas can also be adjusted automatically when autoscaling is enabled. Some stateful services expose their own replication behavior as part of the service design.

Links tab¶

The Links tab lets you change links between app services.

Links are usually defined in the stack, but app services can override them per app instance.

Those overrides also affect deployment ordering for that app instance. If linked services are deployed together, Wodby deploys the linked target first.

Volumes tab¶

The Volumes tab shows service volumes and their app-level values.

Volume resize is not supported for existing app instances. In practice, volume size is chosen during app creation and should not be treated as something you can resize later from this screen.

Settings tab¶

The Settings tab lets you change values of settings exposed by the service.

These settings often flow into environment variables or runtime configuration generated by the service templates.

Configs tab¶

The Configs tab lets you view default configs and override them for this app service.

Tokens tab¶

The Tokens tab lets you add or remove tokens that can be used in environment variables and other generated configuration.

Tokens can be plain or secret-backed. Secret-backed token values are revealed only on demand in the dashboard.

Annotations tab¶

The Annotations tab lets you add custom annotations to the app service.

Like env vars, annotations can come from several sources:

the service
the stack
Wodby system defaults

Inherited annotations are shown in the list, and app-level annotations can override them.