Server Configuration Reference

This page documents all ServerConfig fields and environment variables for running a Multiforum instance.

ServerConfig Fields

The ServerConfig type in the database stores server-wide settings.

Basic Information

Field	Type	Description
serverName	String!	Unique identifier for the server (must match VITE_SERVER_NAME)
serverDescription	String	Public description shown on the homepage
serverIconURL	String	URL to server icon/logo image
rules	JSON	Server-wide rules (Markdown supported)

Feature Toggles

Field	Type	Default	Description
enableDownloads	Boolean	true	Allow downloadable file attachments
enableEvents	Boolean	true	Allow event creation

File Settings

Field	Type	Description
allowedFileTypes	[String]	List of allowed file extensions (e.g., [".stl", ".zip"])

Plugin Settings

Field	Type	Description
pluginRegistries	[String]	URLs to plugin registry endpoints
pluginPipelines	JSON	Pipeline configuration for plugin execution

Relationships

Relationship	Target	Description
Admins	[User]	Server administrators
Moderators	[ModerationProfile]	Server-level moderators
PendingAdminInvites	[User]	Pending admin invitations
PendingModInvites	[User]	Pending moderator invitations
SuspendedUsers	[Suspension]	Server-level suspended users
SuspendedMods	[Suspension]	Server-level suspended moderators
AllowedPlugins	[Plugin]	Allowed plugins
InstalledVersions	[PluginVersion]	Installed plugin versions

Role Relationships

Relationship	Target	Description
DefaultServerRole	ServerRole	Default permissions for all users
DefaultModRole	ModServerRole	Default moderator permissions
DefaultElevatedModRole	ModServerRole	Elevated moderator permissions
DefaultSuspendedRole	ServerRole	Permissions for suspended users
DefaultSuspendedModRole	ModServerRole	Permissions for suspended moderators

Backend Environment Variables

Required

Variable	Description
NEO4J_URI	Neo4j connection URI (e.g., bolt://localhost:7687)
NEO4J_USER	Neo4j username
NEO4J_PASSWORD	Neo4j password
AUTH0_DOMAIN	Auth0 tenant domain
AUTH0_CLIENT_ID	Auth0 client ID

Server Settings

Variable	Default	Description
PORT	4000	Server port

File Storage

Variable	Description
GCS_BUCKET_NAME	Google Cloud Storage bucket name
GOOGLE_CREDENTIALS_BASE64	Base64-encoded GCP service account JSON

Email

Variable	Default	Description
EMAIL_PROVIDER	resend	Email provider: "resend" or "sendgrid"
RESEND_API_KEY	-	Resend API key (if using Resend)
SENDGRID_API_KEY	-	SendGrid API key (if using SendGrid)
EMAIL_FROM	-	Sender email address
SUPPORT_EMAIL	-	Support contact email

Plugins

Variable	Description
PLUGIN_SECRET_ENCRYPTION_KEY	Encryption key for plugin secrets

Monitoring

Variable	Description
SLACK_WEBHOOK_URL	Slack webhook for mutation logging

Testing

Variable	Description
E2E_MOCK_AUTH	Enable mock auth for testing
PLAYWRIGHT_MOCK_AUTH	Enable mock auth for Playwright
GENERATE_OGM_TYPES	Set to "true" to generate OGM types

Frontend Environment Variables

Required

Variable	Description
VITE_GRAPHQL_URL	GraphQL API endpoint
VITE_SERVER_NAME	Server name (must match backend ServerConfig)
VITE_AUTH0_DOMAIN	Auth0 tenant domain
VITE_AUTH0_CLIENT_ID	Auth0 client ID
VITE_AUTH0_CLIENT_SECRET	Auth0 client secret
VITE_AUTH0_AUDIENCE	Auth0 API audience
VITE_AUTH0_CALLBACK_URL	Auth0 callback URL
VITE_LOGOUT_URL	Logout redirect URL

Application Settings

Variable	Description
VITE_BASE_URL	Base URL for the frontend
VITE_SERVER_DISPLAY_NAME	User-facing server name
VITE_ENVIRONMENT	Environment: development, staging, production
VITE_ENABLE_LANGUAGE_PICKER	Enable language selection

Authentication

Variable	Description
VITE_AUTH0_SCOPE	Auth0 permission scopes
VITE_AUTH0_URL	Auth0 token endpoint

External Services

Variable	Description
VITE_GOOGLE_MAPS_API_KEY	Google Maps API key
VITE_GOOGLE_MAP_ID	Google Maps Map ID (for styling)
VITE_OPEN_CAGE_API_KEY	OpenCage geocoding API key
VITE_GOOGLE_CLOUD_STORAGE_BUCKET	GCS bucket for uploads
VITE_OPEN_GRAPH_API_KEY	OpenGraph API key
VITE_LIGHTGALLERY_LICENSE_KEY	Lightgallery license

Error Tracking

Variable	Description
VITE_SENTRY_DSN	Sentry Data Source Name
VITE_SENTRY_AUTH_TOKEN	Sentry authentication token

Deployment

Variable	Description
NITRO_PRESET	Deployment preset (vercel, netlify, node-server)
GRAPHQL_URL_FOR_TYPES	GraphQL URL for codegen

Testing

Variable	Description
VITE_AUTH0_USERNAME	Test user username
VITE_AUTH0_PASSWORD	Test user password
VITE_AUTH0_USERNAME_2	Secondary test username
VITE_AUTH0_PASSWORD_2	Secondary test password

ServerRole Permissions

Default permissions for user roles:

Permission	Description
canCreateChannel	Create new channels
canCreateDiscussion	Post discussions
canCreateEvent	Create events
canCreateComment	Comment on content
canUpvoteDiscussion	Upvote discussions
canUpvoteComment	Upvote comments
canUploadFile	Upload files
canGiveFeedback	Give feedback comments

ModServerRole Permissions

Default permissions for moderator roles:

Permission	Description
canReport	Report content
canGiveFeedback	Give feedback
canHideComment	Archive comments
canHideDiscussion	Archive discussions
canHideEvent	Archive events
canEditComments	Edit others' comments
canEditDiscussions	Edit others' discussions
canEditEvents	Edit others' events
canSuspendUser	Suspend users
canLockChannel	Lock channels
canOpenSupportTickets	Open support issues
canCloseSupportTickets	Close support issues
canArchiveImage	Archive images
canPermanentlyRemoveImage	Permanently delete images
canDeleteWiki	Delete wiki pages

Initial Setup

When setting up a new server, create the ServerConfig:

CREATE (s:ServerConfig {
  serverName: "your-server-name",
  serverDescription: "Your server description",
  enableDownloads: true,
  enableEvents: true
})

Add the first admin:

MATCH (u:User {username: "your-username"})
MATCH (s:ServerConfig {serverName: "your-server-name"})
CREATE (u)-[:ADMIN_OF_SERVER]->(s)

Create default roles (via admin panel or directly in database).