Instance Settings

Self-host admin surface

This page is for the solo self-host path. Hosted Vivd workspaces are managed by the Vivd platform and do not require these install-wide settings.

Instance Settings is the install-wide admin workspace for a self-hosted Vivd instance. Use it when you need to change how the whole install behaves, not just one project.

For a standard solo self-host install, this is where you adjust the main public host, HTTPS handling, and other defaults that affect every project on the instance.

If you just finished installing the self-host bundle, start here with Network first. That is where you set the install’s public host, choose whether HTTPS is handled by bundled Caddy or an external proxy, and enter the ACME email when bundled Caddy owns certificate management.

Instance-wide, not project-wide

Changes here affect the whole install. Project-specific plugin setup, publish targets, and content editing still happen inside each project workspace.

What belongs here

• active install status and routing shape
• main public host and HTTPS mode
• default usage and project limits

Related admin surfaces live nearby but are separate:

• Plugins controls whether plugins are enabled instance-wide
• Email controls transactional email identity and deliverability policy
• domain registration and publish-target behavior are covered separately in launch/admin workflows

General

The General section shows the active install status and routing shape.

For the public self-host path, Vivd favors one main public host and the simpler instance-first workflow. The screen shows the resolved self-host profile as status information, not as a UI-managed setting.

The repo LICENSE Additional Use Grant covers solo and substantially similar single-tenant deployments used for your own internal business operations and websites. Using Vivd to deliver websites or projects for third-party clients, or running shared-control-plane and other multi-tenant SaaS setups, requires separate commercial licensing.

Network

The Network section is the most important part for a normal self-host install. For most fresh installs, this is the first admin screen to configure.

Public host

Set the hostname or IP that Vivd should treat as the main public entrypoint. Enter only the host, not http:// or https://.

Examples:

• example.com
• www.example.com
• 203.0.113.10
• localhost

Vivd uses this value to resolve the public origin used by the control plane and other runtime paths for a normal solo install.

HTTPS handled by

Choose how TLS should work:

• Bundled Caddy: Vivd’s bundled Caddy obtains and renews certificates itself
• External proxy: TLS is terminated by Dokploy, Traefik, or another upstream proxy
• Plain HTTP: no TLS inside the Vivd stack

Typical choices:

• Use Bundled Caddy on a VPS with a real public hostname and ports 80 and 443
• Use External proxy when another platform already owns the certificates
• Use Plain HTTP for local or internal-only testing

ACME email

Set the ACME email only when Bundled Caddy manages certificates directly. Vivd passes this through to Caddy for certificate issuance and renewal.

What happens after save

For the bundled self-host stack, saving network settings updates Vivd’s runtime view of the install and rewrites the bundled self-host Caddy config when UI-managed Caddy mode is active.

In practice, that means:

• install-script / direct-bundle VPS deploys can switch the public host and stay on bundled Caddy from this screen
• Dockploy / Traefik style deploys should keep the public host here but use External proxy
• localhost or raw internal testing can stay on Plain HTTP

If the public host changes, expect the current browser session on the old origin to stop working. Open the new URL and sign in again there.

Deployment overrides still win

If you explicitly set advanced deployment-level host overrides such as VIVD_APP_URL, BETTER_AUTH_URL, or CONTROL_PLANE_HOST, those remain authoritative. In that case, the saved UI value acts as fallback state until the override is removed.

Change network settings deliberately

After changing the public host or TLS mode, re-check both the public site and /vivd-studio on the intended URL before treating the change as complete. If the host changed, do that verification from the new domain after signing in again there.

Capabilities

On normal solo self-host installs, advanced tenancy capability controls stay fixed and are not part of the public self-host workflow. The main public host still acts as a publish target, and additional registered custom publish domains can still be used without turning on tenant-host style routing.

Instance Limits

Instance Limits defines install-wide defaults for resource and project limits. These defaults sit above raw env bootstrap values and below any more specific overrides.

Current defaults include:

• daily, weekly, and monthly credit limits
• image generation limit per month
• warning threshold
• max projects

Use these values when you want a consistent baseline across the install without editing every organization or project individually.

If org-level overrides are enabled, more specific org settings can still replace these instance defaults.

Related settings you may also need

Plugins

Plugin availability is controlled separately in Plugins, not inside Instance Settings. Use that surface to enable or disable plugins instance-wide before configuring project-level plugin details.

Read Plugins Overview if the next step is Contact Form or Analytics setup.

Email

Transactional email footer/identity and deliverability policy are controlled in Email. Use that area when you need to:

• set the email display name, support email, or legal footer links
• review bounce and complaint suppression behavior
• configure email feedback webhook endpoints

This is separate from the ACME email in Network:

• Network -> ACME email is only for HTTPS certificate issuance/renewal with bundled Caddy
• Email is for Vivd’s own outgoing transactional email identity and deliverability

The self-hosting guide covers the env bootstrap side in Self-Hosting.

Domains & publishing

Project launch domains, organization domain registration, and publish-target verification are related but separate concerns.

Read Domains & Publish Targets if the next question is which domain can actually be published or why a live domain is blocked.

Recommended workflow

1. Set the main public host and TLS mode first.
2. If Bundled Caddy is selected, fill in the ACME email before treating HTTPS setup as complete.
3. If the public host changed, continue on the new URL and sign in again there.
4. Confirm the public site and /vivd-studio both resolve correctly.
5. Configure Email if you want transactional email identity, support/footer details, or feedback webhooks.
6. Set instance limits before onboarding more projects or users.
7. Then move to Domains & Publish Targets, Plugins Overview, and Publish Your Site.