Argo Server

v2.5 and after

The Argo Server is a server that exposes an API and UI for workflows. You’ll need to use this if you want to offload large workflows or the workflow archive.

You can run this in either “hosted” or “local” mode.

It replaces the Argo UI.

Hosted Mode

Use this mode if:

  • You want a drop-in replacement for the Argo UI.
  • If you need to prevent users from directly accessing the database.

Hosted mode is provided as part of the standard manifests, specifically in argo-server-deployment.yaml .

Local Mode

Use this mode if:

  • You want something that does not require complex set-up.
  • You do not need to run a database.

This is the most common use case for development especially

To run locally:

argo server

This will start a server on port 2746 which you can view at http://localhost:2746.


Auth Mode

See auth.

Managed Namespace

See managed namespace.

Base href

If the server is running behind reverse proxy with a subpath different from / (for example, /argo), you can set an alternative subpath with the --base-href flag or the BASE_HREF environment variable.

You probably now should read how to set-up an ingress

Transport Layer Security

See TLS.


See SSO.

Access the Argo Workflows UI

By default, the Argo UI service is not exposed with an external IP. To access the UI, use one of the following:

kubectl port-forward

kubectl -n argo port-forward svc/argo-server 2746:2746

Then visit:

Expose a LoadBalancer

Update the service to be of type LoadBalancer.

kubectl patch svc argo-server -n argo -p '{"spec": {"type": "LoadBalancer"}}'

Then wait for the external IP to be made available:

kubectl get svc argo-server -n argo
NAME          TYPE           CLUSTER-IP     EXTERNAL-IP   PORT(S)          AGE
argo-server   LoadBalancer    2746:30008/TCP   18h


You can get ingress working as follows:

Update service/argo-server spec with type: LoadBalancer:

    - name: web
      port: 2746
      targetPort: 2746
  type: LoadBalancer

Add BASH_HREF as environment variable to deployment/argo-server :

        - name: argo-server
          image: argoproj/argocli:latest
          args: [server]
            - name: BASE_HREF
              value: /argo/

Create a ingress, with the annotation /:

kind: Ingress
  name: argo-server
  annotations: /
    - http:
          - backend:
              serviceName: argo-server
              servicePort: 2746
            path: /argo

Learn more