Skip to main content
This page explains how to configure a custom domain for your OpnForm instance.
This guide covers the instance-wide domain for your self-hosted OpnForm deployment. Workspace or form-level custom domains are configured separately inside OpnForm and are not the same as the instance URL.

​
Custom Domain Setup

To use a custom domain (or subdomain) with OpnForm:
  1. Purchase a domain (if needed)
  2. Configure DNS records to point to your OpnForm instance
  3. Update OpnForm configuration:
    • Set both APP_URL and FRONT_URL in api/.env
    • Set NUXT_PUBLIC_APP_URL and NUXT_PUBLIC_API_BASE in client/.env
  4. Secure with SSL certificate
For example, when the public URL is https://forms.example.com:
FRONT_URL is used by the backend when it creates frontend callback URLs, including OIDC callbacks. Keep it aligned with the public frontend URL. After changing these files, recreate the containers; a restart alone does not load new environment values. See Updating Environment Variables.
If an OIDC connection already exists, edit it afterwards, use Use current app URL to refresh its redirect URI, save it, and update the URI in your identity provider. Existing connections retain their previous redirect URI until you save a new one.
The easiest way to get started with OpnForm is through our official managed service in the Cloud. It takes just 1 minute to start building forms with the free plan, with high availability, backups, security, and maintenance all managed for you.