Skip to main content

Self-Hosting Options

Serval supports two delivery models when you run it in your own infrastructure. The two axes that actually differ between them are (1) what you bring — a Linux host, or an AWS account — and (2) who operates it — Serval, your team, or (for the full application) either, your choice. Pick the model that matches both. This page is the starting point for evaluation; step-by-step deployment instructions are shared with customers during onboarding.
Most organizations should start with Hybrid Self-Hosted (smallest footprint, fastest setup). Choose the fully self-hosted model when regulatory or data-residency requirements demand that the entire application runs in your environment.

The two delivery models

Hybrid Self-Hosted

You run only the Serval worker in your infrastructure. Serval operates the backend in Serval Cloud. Integration credentials stay on your worker and are never shared with Serval. Smallest footprint, fastest to set up.

Managed in Your AWS

The full Serval application runs single-tenant in an AWS account you own, operated by your team or by Serval — your choice. Your AWS credentials never leave your environment.

Comparison

Does Serval need to reach private resources?

If Serval needs to talk to systems on your internal network — on-prem Active Directory, internal LDAP, self-hosted GitLab, internal APIs, etc. — the connectivity story differs per model. The Private Network Access page walks through the options for each.

Evaluating Serval self-hosting

Use these pages while you decide which model fits:

Hybrid Self-Hosted — overview

How Hybrid works, what runs where, prerequisites, and when to pick it over the fully self-hosted option.

Managed in Your AWS — overview

The operating modes (self-managed or Serval-managed) and what your team supplies either way.

Managed in Your AWS — prerequisites

The AWS account, DNS, and AI provider requirements before onboarding.

Private network access

Options for letting Serval reach resources on your internal network (on-prem AD, internal GitLab, etc.).

Ready to deploy?

Detailed installation steps, configuration references, integration setup, and operational runbooks live in a password-protected area of this site, which we share with customers and teams working through onboarding.

Deployment instructions

Installation, configuration, integration setup, and day-2 operations for Serval self-hosting.