Settings

Navigate to Settings in the admin sidebar to access all platform configuration. Settings are organized into six tabs: Server, General, Game, Features, Cashier, and Agents.

Required permission: settings:view to read, settings:edit to update. The Cashier tab requires the cashier feature toggle. The Agents tab requires the agents feature toggle.

The Server, General, Game, and Agents tabs have Save Changes and Reset to Defaults buttons.

License status, plans, and server updates are on a separate page. See License & Updates.

Server Tab

Configuration for infrastructure-level settings: URLs, filesystem paths, email addresses, SMTP, and timezone.

Site URLs

SettingDescription
Base URLThe public-facing root URL of the site (e.g., https://poker.example.com). Used in links, emails, and redirects
CDN URLOptional CDN base URL for serving static assets. Leave blank to serve from the base URL
Force HTTPSRedirect all HTTP requests to HTTPS

Script Paths

SettingDescription
Public PathFilesystem path to the public/static assets directory
Upload PathWhere user-uploaded files (avatars, etc.) are stored
Temp PathTemporary file storage used during processing
Log PathDirectory where application logs are written

Email Addresses

These addresses are used as default senders and recipients for different email types:

SettingDescription
Admin EmailInternal notifications and alerts
Support EmailShown in player-facing support links
No-Reply EmailDefault From: address for automated emails
Security EmailUsed for security-related notifications (account blocks, 2FA changes)

Email Delivery (SMTP)

Configure the SMTP server used for all outgoing email. For full SMTP setup instructions see System Emails — SMTP Configuration.

SettingDescription
Enable SMTPMaster toggle for SMTP email delivery
Provider PresetOne-time action that fills in host, port, encryption, and timeout for a provider
HostSMTP server hostname
PortSMTP port
EncryptionConnection encryption
Timeout (ms)Connection timeout in milliseconds
Enable AuthenticationToggle SMTP authentication
Username / PasswordSMTP credentials
From Address / From NameSender identity shown in the From: header
Reply-To Address / Reply-To NameOptional reply-to override
Enable Rate LimitingMax Per Minute, Max Per Hour, and Max Per Day

Click Test Connection to check the SMTP settings.

Timezone

SettingDescription
Server TimezoneTimezone used for server-side scheduling and logging
Display TimezoneTimezone used in admin panel date displays
Use User TimezoneWhen enabled, player-facing timestamps use each player’s local timezone

General Tab

Branding and player-facing presentation settings.

Avatar Settings

SettingDescription
Enable AvatarsAllow players to have profile avatars
Allow Custom UploadsPlayers can upload their own avatar images
Max File Size (KB)Maximum size for uploaded avatars in kilobytes
Max Width (px)Maximum pixel width for uploaded avatars

Lobby Melody

SettingDescription
Enable Lobby MelodyPlay background music in the lobby
Auto PlayStart playing automatically when a player opens the lobby
Default Volume (%)Initial volume level

Performance Telemetry

SettingDescription
Web vitals sample rateShare of browser sessions that report runtime metrics. 0 disables reporting and 1 records every browser session

SEO Settings

SettingDescription
Site TitleThe <title> tag used on public pages (max 70 characters)
Site DescriptionMeta description used in search engine results (max 160 characters)
Twitter HandleUsed for Twitter/X card metadata
Google Analytics IDMeasurement ID for Google Analytics integration
Robots DirectiveControls search engine indexing (Index, Follow, No Index, Follow, Index, No Follow, or No Index, No Follow)

Game Tab

Gameplay timing, rake, virtual chips, bot behavior, chat, and currency display.

Move Time

SettingDescriptionRange
Default Move Time (sec)Seconds a player has to act before timing out5–300
Warning Time (sec)Seconds before timeout when the warning is shown0–30
Time Bank (sec)Total time bank available per player (0 to disable)0–600

Timeout Settings

SettingDescription
Disconnect Grace Period (sec)Seconds a disconnected player retains their seat before being sat out
Reconnect Window (sec)Seconds after a disconnect during which a reconnection is treated as a continuation
Sit Out After N TimeoutsNumber of consecutive timeouts before the player is automatically sat out
Auto Fold on TimeoutAutomatically fold the player’s hand when they time out
Sit Out on DisconnectAutomatically sit players out when they disconnect

Showdown Settings

SettingDescriptionRange
Showdown Delay (sec)Seconds to display cards at showdown before moving to the next hand1–30

Rake Settings

SettingDescription
Enable RakeCollect rake from pots
Default Rake (%)Percentage of the pot collected as rake
Max Rake (%)Upper cap on the rake percentage
Rake CapMaximum absolute chip amount taken from a single pot
Heads-Up Rake (%)Rake percentage for two-player pots
Rake Cap by StakesApply different rake caps based on the table’s blind level
No Flop No RakeDo not collect rake from pots where the hand ended pre-flop

Virtual Chips

SettingDescription
Enable Virtual ChipsAllow play-money games on the platform
Initial ChipsStarting chip count given to new players
Replenish AmountChips added when a player’s balance falls below the threshold
Replenish ThresholdChip balance below which replenishment is triggered

Bot Timing

SettingDescription
Enable Bot TimingApply realistic action delays to bot players
Min Delay (ms)Minimum milliseconds a bot waits before acting
Max Delay (ms)Maximum milliseconds a bot waits before acting

Chat Settings

SettingDescription
Enable ChatEnable the in-game chat feature

This is a per-game default. The chat feature toggle (under Features) controls whether chat is available platform-wide.

Currency Settings

SettingDescription
Default CurrencyCurrency code used for real-money tables (e.g., USD, EUR)
Decimal PlacesNumber of decimal places to display for chip/currency values
Display Symbol Before AmountDisplay the currency symbol before the number (e.g., $100 vs 100$)
Thousands SeparatorCharacter used to separate thousands (e.g., , for 1,000)
Decimal SeparatorCharacter used as the decimal point (e.g., . or ,)

Whatever you pick here is what the entire site renders — lobby, tables, cashier, tournaments and emails all read from this one setting.

Supported currencies: USD, EUR, GBP, CAD, AUD, JPY, CNY, MNT, BTC, ETH.

Mongolian tögrög (MNT)

The tögrög symbol is ₮. Mongolian convention writes it after the amount and without decimals, so pair the currency with these settings:

SettingValue
Default CurrencyMNT
Decimal Places0
Display Symbol Before AmountOff
Thousands Separator,
Decimal Separator.

That renders amounts as 5,000₮ and 1,250,000₮. The möngö subunit that ISO 4217 still lists for MNT has been out of circulation for decades, which is why 0 decimal places is the right choice rather than 2.

MNT also ships as a cashier currency with the same conventions built in. Its default USD exchange rate is a starting value, not a live rate — update it to the rate you intend to trade at before enabling multi-currency deposits.

Features Tab

A set of on/off toggles that control which platform features are available.

Changes take effect immediately — the toggle is saved as soon as you click it.

If the installation has signed license tier data, this tab also shows the current plan. Features outside the plan are locked, displayed below included features, and cannot be enabled from the UI or direct admin API calls. Each locked feature shows the minimum plan that includes it, and an Upgrade link appears next to the current plan.

When a verified license downgrade removes a feature from the plan, the server automatically turns that feature off and refreshes this tab through the live tier update event.

FeatureDescriptionMinimum plan
CashierEnable deposits and withdrawalsStarter
TournamentsEnable the tournament systemPro
Private GamesAllow players to create private tablesPro
ChatEnable in-game chatStarter
BonusesEnable the bonus and promotion systemPro
AffiliatesEnable the affiliate and referral systemEnterprise
AgentsEnable the agent program (also unlocks the Agents settings tab)Enterprise
Virtual ChipsAllow play-money gamesStarter
Real MoneyAllow real-money gamesStarter
RegistrationAllow new player registrationsStarter
Email VerificationRequire new players to verify their email before playingPro
Two-Factor AuthEnable TOTP-based 2FA for player accounts and require admin 2FA during loginPro
Maintenance ModePut the site into maintenance mode — players cannot log inStarter
BotsEnable AI bot players at tablesPro
Game HistoryEnable hand history and game replay for players (admin access is always available)Starter
Fraud AlertsEnable the fraud detection and alert systemPro
KYC VerificationEnable identity verification document submissionPro
AML ReviewsEnable anti-money laundering review workflowsEnterprise
ChargebacksEnable chargeback managementEnterprise
CouponsEnable coupon and promo code functionalityPro
Game SchedulerEnable the automated table management engineEnterprise
Developer APIEnable the third-party integration API for partnersEnterprise

Cashier Tab

Configure payment providers for deposits and withdrawals.

Required feature toggle: cashier

Provider Cards

The tab shows Total Providers, Deposits Active, and Withdrawals Active, followed by a card for each configured provider. Each card shows the provider name and type, whether deposits and withdrawals are enabled, Deposits and Withdrawals toggles, and a warning if an automated provider has no webhook signing secret.

Limits, Credentials, and Testing

Expand Limits Configuration to set Min Amount, Max Amount, Daily, Weekly, and Monthly values for deposits and withdrawals, then click Save Limits.

Click Add Provider to add one, and Test on a card to verify its credentials.

For the provider list, credential fields, and step-by-step setup, see Cashier and Payments.

Agents Tab

Configure the agent hierarchy system.

Required feature toggle: agents

Agent Profit

SettingDescription
Enable Agent ProfitsEnable the agent profit/commission system
Commission PercentagePercentage of rake given to agents as commission
Accrual ModeWhen agents accrue commission from player activity: Both (win & loss), Win Only, or Loss Only

Hierarchy

SettingDescription
Max Hierarchy DepthMaximum number of agent levels in the hierarchy (1–20)
Default Role TierThe role tier assigned to new agents by default

Transfer Policy

Agent-to-Agent Transfer Policy controls whether and how agents can transfer funds to each other:

ValueDescription
DisabledNo agent-to-agent transfers allowed
Same Parent OnlyTransfers only between agents with the same parent agent
Any AgentAny agent can transfer to any other agent
With ApprovalTransfers require admin approval

Feature Toggles

SettingDescription
Multi-Tree SupportAllow multiple independent agent hierarchies on the same platform
Cross-Tree Player SharingAllow players to be shared across different agent trees
Auto-run Scheduled SettlementsRun settlements automatically on their configured schedule
Commission Rate OverridesAllow managers to set custom rake share percentages on sub-agents
Try the live demo Pricing

Have questions about Poker Engine? We reply fast.