Config Generator

Fill in the .env options of g0v0-server v1 or the config/*.json options of g0v0 server v2 by hand and generate the matching configuration files in one click.

Everything is generated locally in your browser — your configuration (including database passwords, JWT secrets and other sensitive values) is never uploaded anywhere.

Fill in the options below — both the v1 `.env` and the v2 `config/*.json` files are generated locally in your browser, so nothing (including passwords and secrets) is uploaded anywhere.

g0v0-server v1 configuration (.env)

Every option starts from the v1 default value; highlighted fields were changed.

MySQL Server AddressMYSQL_HOSTMySQL Server PortMYSQL_PORTMySQL Database NameMYSQL_DATABASEMySQL UsernameMYSQL_USERMySQL PasswordMYSQL_PASSWORDMySQL Root PasswordMYSQL_ROOT_PASSWORDRedis Connection URLREDIS_URL

JWT Signing KeyJWT_SECRET_KEYJWT AlgorithmJWT_ALGORITHMAccess Token Expiration Time (Min)ACCESS_TOKEN_EXPIRE_MINUTESRefresh Token Expiration Time (Min)REFRESH_TOKEN_EXPIRE_MINUTESJWT AudienceJWT_AUDIENCEJWT IssuerJWT_ISSUER

OAuth Client IDOSU_CLIENT_IDOAuth Client SecretOSU_CLIENT_SECRETWeb OAuth Client IDOSU_WEB_CLIENT_IDWeb OAuth Client SecretOSU_WEB_CLIENT_SECRET

Whether to enable Debug ModeDEBUGWhether to enable Rate LimitingENABLE_RATE_LIMIT

Server Listening AddressHOSTServer Listening PortPORTAdditional CORS allowed domain list (JSON format)CORS_URLS[]Server URLSERVER_URLFrontend URL, will redirect to this URL when accessing URL opened from game. Empty means no redirect.FRONTEND_URLTRUSTED_PROXIESTRUSTED_PROXIES["127.0.0.0/8","::1/128","10.0.0.0/8","172.16.0.0/12","192.168.0.0/16","fc00::/7"]TRUSTED_PROXY_SOURCESTRUSTED_PROXY_SOURCES[]TRUSTED_PROXY_REFRESH_MINUTESTRUSTED_PROXY_REFRESH_MINUTES

Fetcher is used to fetch data from osu! official API, using osu! official API OAuth 2.0 authentication

Fetcher Client IDFETCHER_CLIENT_IDFetcher Client SecretFETCHER_CLIENT_SECRET

Log LevelLOG_LEVEL

Whether to enable TOTP Two-Factor AuthenticationENABLE_TOTP_VERIFICATIONUse username instead of email in TOTP labelTOTP_USE_USERNAME_IN_LABELWhether to enable Cloudflare Turnstile Verification (Non-osu clients only)ENABLE_TURNSTILE_VERIFICATIONTurnstile Dev Mode (Skip verification, for local dev)TURNSTILE_DEV_MODEWhether to enable Email VerificationENABLE_EMAIL_VERIFICATIONWhether to enable Session Verification MiddlewareENABLE_SESSION_VERIFICATIONWhether to allow multi-device login simultaneouslyENABLE_MULTI_DEVICE_LOGIN

Issuer Name in TOTP AuthenticatorTOTP_ISSUERService Name displayed in TOTP AuthenticatorTOTP_SERVICE_NAMECloudflare Turnstile Secret KeyTURNSTILE_SECRET_KEYMax tokens per client per userMAX_TOKENS_PER_CLIENTDevice Trust Duration DaysDEVICE_TRUST_DURATION_DAYS

Configure the email provider and related parameters. If `EMAIL_PROVIDER` starts with `-`, the server will try to load the email provider implementation from the plugin corresponding to the id after it. If `EMAIL_PROVIDER` does not contain `.`, it is considered a built-in email provider name. Currently, there is one built-in provider: `smtp`. Otherwise, the server will try to load the email provider implementation from the module path specified by `EMAIL_PROVIDER`. ### smtp (Default) ```bash EMAIL_PROVIDER="smtp" EMAIL_PROVIDER_CONFIG='{ "smtp_server": "smtp.example.com", "smtp_port": 587, "smtp_username": "your_smtp_username", "smtp_password": "your_smtp_password", }' ```

Email ProviderEMAIL_PROVIDEREmail Provider Config (JSON)EMAIL_PROVIDER_CONFIGSender EmailFROM_EMAILSender NameFROM_NAME

Configure application monitoring options, such as Sentry and New Relic. Place newrelic.ini config file in the project root to automatically enable New Relic monitoring. If config file does not exist or newrelic package is not installed, New Relic initialization will be skipped.

Sentry DSN, empty to disable SentrySENTRY_DSNNew Relic Environment ID, set to "production" or "development"NEW_RELIC_ENVIRONMENT

GeoIP Database Storage DirectoryGEOIP_DEST_DIRGeoIP Weekly Update Day (0=Mon, 6=Sun)GEOIP_UPDATE_DAYGeoIP Weekly Update Hour (0-23)GEOIP_UPDATE_HOUR

Enable RX mod statisticsENABLE_RXEnable AP mod statisticsENABLE_APEnable supporter status for all new usersENABLE_SUPPORTER_FOR_ALL_USERSEnable leaderboards for all beatmapsENABLE_ALL_BEATMAP_LEADERBOARDAllow any beatmap to gain PPENABLE_ALL_BEATMAP_PPUse old mod multipliers (before [Mod Multipliers Rework](https://osu.ppy.sh/home/news/2026-06-03-mod-multipliers-survey-results))USE_OLD_SCORE_MULTIPLIER

Seasonal Background URL ListSEASONAL_BACKGROUNDS[]Minimum votes required for tags to be shown in result listBEATMAP_TAG_TOP_COUNTOld Score Processing Mode strict: delete all related scores, pp, stats, replays normal: delete pp and leaderboard scoresOLD_SCORE_PROCESSING_MODEstrictnormalScoring Mode: standardised or classicSCORING_MODEstandardisedclassicDisable score submission modsDISABLE_SUBMISSION_MODS[]

Configure performance calculator and its parameters. If `CALCULATOR` starts with `-`, the server will try to load the calculator implementation from the plugin corresponding to the id after it. If `CALCULATOR` does not contain `.`, it is considered a built-in calculator name. Currently, there are two built-in calculators: `performance_server` and `rosu`. Otherwise, the server will try to load the calculator implementation from the module path specified by `CALCULATOR`. ### [osu-performance-server](https://github.com/GooGuTeam/osu-performance-server) (Default) ```bash CALCULATOR="performance_server" CALCULATOR_CONFIG='{ "server_url": "http://localhost:5225" }' ``` ### rosu-pp-py ```bash CALCULATOR="rosu" CALCULATOR_CONFIG='{}' ```

Use simplified pp calculation as fallback when calculator doesn't support a modeFALLBACK_NO_CALCULATOR_PP

Performance CalculatorCALCULATORPerformance Calculator Config (JSON format), see above for detailsCALCULATOR_CONFIG{"server_url":"http://localhost:5225"}

Enable Beatmap Cache PreloadENABLE_BEATMAP_PRELOADEnable Leaderboard CacheENABLE_RANKING_CACHEEnable User Cache PreloadENABLE_USER_CACHE_PRELOAD

Beatmap Cache Expiration (Hours)BEATMAP_CACHE_EXPIRE_HOURSBeatmapset Cache Expiration (Seconds)BEATMAPSET_CACHE_EXPIRE_SECONDSLeaderboard Cache Expiration (Minutes)RANKING_CACHE_EXPIRE_MINUTESLeaderboard Cache Refresh Interval (Minutes)RANKING_CACHE_REFRESH_INTERVAL_MINUTESMax Cached PagesRANKING_CACHE_MAX_PAGESMax Cached Pages for Top ScoresTOP_SCORE_CACHE_MAX_PAGESCache Top N Country LeaderboardsRANKING_CACHE_TOP_COUNTRIESUser Cache Expiration (Seconds)USER_CACHE_EXPIRE_SECONDSUser Scores Cache Expiration (Seconds)USER_SCORES_CACHE_EXPIRE_SECONDSUser Beatmapsets Cache Expiration (Seconds)USER_BEATMAPSETS_CACHE_EXPIRE_SECONDSMax Preloaded UsersUSER_CACHE_MAX_PRELOAD_USERS

Enable Asset ProxyENABLE_ASSET_PROXY

Custom Asset DomainCUSTOM_ASSET_DOMAINCustom prefix for assets.ppy.shASSET_PROXY_PREFIXCustom prefix for a.ppy.shAVATAR_PROXY_PREFIXCustom prefix for b.ppy.shBEATMAP_PROXY_PREFIX

ENABLE_WIKIENABLE_WIKI

WIKI_REPOSITORYWIKI_REPOSITORYWIKI_BRANCHWIKI_BRANCHWIKI_CONTENT_ROOTWIKI_CONTENT_ROOTWIKI_RAW_BASE_URLWIKI_RAW_BASE_URLWIKI_LISTING_BASE_URLWIKI_LISTING_BASE_URLWIKI_GITHUB_TOKENWIKI_GITHUB_TOKENWIKI_FALLBACK_LOCALEWIKI_FALLBACK_LOCALEWIKI_CACHE_EXPIRE_SECONDSWIKI_CACHE_EXPIRE_SECONDSWIKI_RESOURCE_CACHE_EXPIRE_SECONDSWIKI_RESOURCE_CACHE_EXPIRE_SECONDSWIKI_REQUEST_TIMEOUT_SECONDSWIKI_REQUEST_TIMEOUT_SECONDS

ENABLE_CHANGELOGENABLE_CHANGELOGENABLE_NEWSENABLE_NEWS

CONTENT_REPOSITORYCONTENT_REPOSITORYCONTENT_BRANCHCONTENT_BRANCHCHANGELOG_CONTENT_ROOTCHANGELOG_CONTENT_ROOTNEWS_CONTENT_ROOTNEWS_CONTENT_ROOTCONTENT_RAW_BASE_URLCONTENT_RAW_BASE_URLCONTENT_LISTING_BASE_URLCONTENT_LISTING_BASE_URLCONTENT_GITHUB_TOKENCONTENT_GITHUB_TOKENCONTENT_WEB_BASE_URLCONTENT_WEB_BASE_URLCONTENT_CACHE_EXPIRE_SECONDSCONTENT_CACHE_EXPIRE_SECONDSCONTENT_LISTING_CACHE_EXPIRE_SECONDSCONTENT_LISTING_CACHE_EXPIRE_SECONDSCONTENT_INDEX_EXPIRE_SECONDSCONTENT_INDEX_EXPIRE_SECONDSCONTENT_REQUEST_TIMEOUT_SECONDSCONTENT_REQUEST_TIMEOUT_SECONDS

Enable Auto Beatmap SyncENABLE_AUTO_BEATMAP_SYNC

Auto Beatmap Sync Interval (Minutes)BEATMAP_SYNC_INTERVAL_MINUTES

Allow users to delete their own scoresALLOW_DELETE_SCORESCheck Custom Ruleset VersionCHECK_RULESET_VERSIONCheck Client VersionCHECK_CLIENT_VERSION

Banned Username ListBANNED_NAME["mrekk","vaxei","btmc","cookiezi","peppy","saragi","chocomint"]Client Version List URLs, see https://github.com/GooGuTeam/g0v0-client-versions to add your own clientCLIENT_VERSION_URLS["https://raw.githubusercontent.com/GooGuTeam/g0v0-client-versions/main/version_list.json"]

Used for storing replay files, avatars, etc. ### Local Storage (Recommended for Development) Local storage saves files in the server's local file system, suitable for development and small-scale deployment. ```bash STORAGE_SERVICE="local" STORAGE_SETTINGS='{"local_storage_path": "./storage"}' ``` ### Cloudflare R2 Storage (Recommended for Production) ```bash STORAGE_SERVICE="r2" STORAGE_SETTINGS='{ "r2_account_id": "your_cloudflare_account_id", "r2_access_key_id": "your_r2_access_key_id", "r2_secret_access_key": "your_r2_secret_access_key", "r2_bucket_name": "your_bucket_name", "r2_public_url_base": "https://your-custom-domain.com" }' ``` ### AWS S3 Storage ```bash STORAGE_SERVICE="s3" STORAGE_SETTINGS='{ "s3_access_key_id": "your_aws_access_key_id", "s3_secret_access_key": "your_aws_secret_access_key", "s3_bucket_name": "your_s3_bucket_name", "s3_region_name": "us-east-1", "s3_public_url_base": "https://your-custom-domain.com" }' ```

ENABLE_SCREENSHOT_CLEANUPENABLE_SCREENSHOT_CLEANUP

Storage Service Type: local, r2, s3STORAGE_SERVICElocalr2s3Storage Service Configuration (JSON)STORAGE_SETTINGS{"local_storage_path":"./storage"}SCREENSHOT_RETENTION_DAYSSCREENSHOT_RETENTION_DAYSSCREENSHOT_CLEANUP_BATCH_SIZESCREENSHOT_CLEANUP_BATCH_SIZE

Plugin Directory ListPLUGIN_DIRS["./plugins"]Disabled Plugin ListDISABLED_PLUGINS[]

Enable g0v0! v2 server Inter-Process Communication (IPC). This requires using g0v0! v2 Realtime implementation instead of spectator-server.ENABLE_V2_IPC

Generated .env

Save this as `.env` in the root directory of your g0v0-server v1 deployment.

# g0v0-server v1 configuration (.env)

# Database Settings
MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_DATABASE=osu_api
MYSQL_USER=osu_api
MYSQL_PASSWORD=password
MYSQL_ROOT_PASSWORD=password
REDIS_URL=redis://127.0.0.1:6379

# JWT Settings
JWT_SECRET_KEY=your_jwt_secret_here
JWT_ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=1440
REFRESH_TOKEN_EXPIRE_MINUTES=21600
JWT_AUDIENCE=5
JWT_ISSUER=

# OAuth Settings
OSU_CLIENT_ID=5
OSU_CLIENT_SECRET=FGc9GAtyHzeQDshWP5Ah7dega8hJACAJpQtw6OXk
OSU_WEB_CLIENT_ID=6
OSU_WEB_CLIENT_SECRET=your_osu_web_client_secret_here

# Server Settings
HOST=0.0.0.0
PORT=8000
DEBUG=false
CORS_URLS=[]
SERVER_URL=http://localhost:8000/
FRONTEND_URL=
ENABLE_RATE_LIMIT=true
TRUSTED_PROXIES=["127.0.0.0/8","::1/128","10.0.0.0/8","172.16.0.0/12","192.168.0.0/16","fc00::/7"]
TRUSTED_PROXY_SOURCES=[]
TRUSTED_PROXY_REFRESH_MINUTES=60

# Fetcher Settings
FETCHER_CLIENT_ID=
FETCHER_CLIENT_SECRET=

# Log Settings
LOG_LEVEL=INFO

# Verification Service Settings
ENABLE_TOTP_VERIFICATION=true
TOTP_ISSUER=
TOTP_SERVICE_NAME=g0v0! Lazer Server
TOTP_USE_USERNAME_IN_LABEL=true
ENABLE_TURNSTILE_VERIFICATION=false
TURNSTILE_SECRET_KEY=
TURNSTILE_DEV_MODE=false
ENABLE_EMAIL_VERIFICATION=false
ENABLE_SESSION_VERIFICATION=true
ENABLE_MULTI_DEVICE_LOGIN=true
MAX_TOKENS_PER_CLIENT=10
DEVICE_TRUST_DURATION_DAYS=30

# Email Service Settings
EMAIL_PROVIDER=smtp
EMAIL_PROVIDER_CONFIG=
FROM_EMAIL=noreply@example.com
FROM_NAME=osu! server

# Monitoring Settings
SENTRY_DSN=
NEW_RELIC_ENVIRONMENT=

# GeoIP Settings
GEOIP_DEST_DIR=./geoip
GEOIP_UPDATE_DAY=1
GEOIP_UPDATE_HOUR=2

# Game Settings
ENABLE_RX=false
ENABLE_AP=false
ENABLE_SUPPORTER_FOR_ALL_USERS=false
ENABLE_ALL_BEATMAP_LEADERBOARD=false
ENABLE_ALL_BEATMAP_PP=false
SEASONAL_BACKGROUNDS=[]
BEATMAP_TAG_TOP_COUNT=2
OLD_SCORE_PROCESSING_MODE=normal
SCORING_MODE=standardised
USE_OLD_SCORE_MULTIPLIER=false
DISABLE_SUBMISSION_MODS=[]

# Performance Calculation Settings
CALCULATOR=performance_server
CALCULATOR_CONFIG={"server_url":"http://localhost:5225"}
FALLBACK_NO_CALCULATOR_PP=false

# Cache Settings
ENABLE_BEATMAP_PRELOAD=true
BEATMAP_CACHE_EXPIRE_HOURS=24
BEATMAPSET_CACHE_EXPIRE_SECONDS=3600
ENABLE_RANKING_CACHE=true
RANKING_CACHE_EXPIRE_MINUTES=10
RANKING_CACHE_REFRESH_INTERVAL_MINUTES=10
RANKING_CACHE_MAX_PAGES=20
TOP_SCORE_CACHE_MAX_PAGES=3
RANKING_CACHE_TOP_COUNTRIES=20
ENABLE_USER_CACHE_PRELOAD=true
USER_CACHE_EXPIRE_SECONDS=300
USER_SCORES_CACHE_EXPIRE_SECONDS=60
USER_BEATMAPSETS_CACHE_EXPIRE_SECONDS=600
USER_CACHE_MAX_PRELOAD_USERS=200

# Asset Proxy Settings
ENABLE_ASSET_PROXY=false
CUSTOM_ASSET_DOMAIN=g0v0.top
ASSET_PROXY_PREFIX=assets-ppy
AVATAR_PROXY_PREFIX=a-ppy
BEATMAP_PROXY_PREFIX=b-ppy

# wiki
ENABLE_WIKI=true
WIKI_REPOSITORY=ppy/osu-wiki
WIKI_BRANCH=master
WIKI_CONTENT_ROOT=wiki
WIKI_RAW_BASE_URL=https://raw.githubusercontent.com
WIKI_LISTING_BASE_URL=https://api.github.com
WIKI_GITHUB_TOKEN=
WIKI_FALLBACK_LOCALE=en
WIKI_CACHE_EXPIRE_SECONDS=300
WIKI_RESOURCE_CACHE_EXPIRE_SECONDS=3600
WIKI_REQUEST_TIMEOUT_SECONDS=10

# content
ENABLE_CHANGELOG=true
ENABLE_NEWS=true
CONTENT_REPOSITORY=GooGuTeam/g0v0-news
CONTENT_BRANCH=main
CHANGELOG_CONTENT_ROOT=changelog
NEWS_CONTENT_ROOT=news
CONTENT_RAW_BASE_URL=https://raw.githubusercontent.com
CONTENT_LISTING_BASE_URL=https://api.github.com
CONTENT_GITHUB_TOKEN=
CONTENT_WEB_BASE_URL=https://github.com
CONTENT_CACHE_EXPIRE_SECONDS=300
CONTENT_LISTING_CACHE_EXPIRE_SECONDS=1800
CONTENT_INDEX_EXPIRE_SECONDS=600
CONTENT_REQUEST_TIMEOUT_SECONDS=10

# Beatmap Sync Settings
ENABLE_AUTO_BEATMAP_SYNC=false
BEATMAP_SYNC_INTERVAL_MINUTES=60

# Anti-Cheat Settings
BANNED_NAME=["mrekk","vaxei","btmc","cookiezi","peppy","saragi","chocomint"]
ALLOW_DELETE_SCORES=false
CHECK_RULESET_VERSION=true
CHECK_CLIENT_VERSION=true
CLIENT_VERSION_URLS=["https://raw.githubusercontent.com/GooGuTeam/g0v0-client-versions/main/version_list.json"]

# Storage Service Settings
STORAGE_SERVICE=local
STORAGE_SETTINGS={"local_storage_path":"./storage"}
ENABLE_SCREENSHOT_CLEANUP=false
SCREENSHOT_RETENTION_DAYS=30
SCREENSHOT_CLEANUP_BATCH_SIZE=200

# Plugin Settings
PLUGIN_DIRS=["./plugins"]
DISABLED_PLUGINS=[]

# g0v0! v2 Server Settings
ENABLE_V2_IPC=true

Usage

1. Pick the version you want to generate at the top of the page: "v1 config (.env)" or "v2 config (config/*.json)".
2. Expand the groups and fill in the options. Every option starts from its default value, and changed options are highlighted.
   • v1: if you already have a .env, click "Import .env", paste it and edit the values in the form.
   • v2: only adjust the options you care about and keep the rest as they are.
3. Review the result in the output section at the bottom, then use "Copy", "Download .env", "Download" or "Download all (.zip)" to save it.

Notes

• The .env generated by the v1 panel can be placed directly in the root directory of your g0v0-server v1 deployment. Always change the default secrets and passwords in production.
• The general.json, game.json, realtime.json, chat.json and storage.json generated by the v2 panel belong in the config/ directory of every v2 service (e.g. g0v0.Server.Realtime). All v2 services should share the same general.json and storage.json.
• When UseLegacyDatabase is true the v1 MySQL database is used; setting it to false switches to the PostgreSQL database described by PostgresqlConnectionString. The form only shows the options of the database that is in use (the generated general.json keeps both, so you can switch at any time).
• chat.json is optional: when the file is absent every chat limit falls back to the osu-web default.
• See Configurations for a description of every .env option, and v2 Configurations for the v2 fields.

Compared to the config converter

This page is for filling in and generating a configuration manually, which suits fresh deployments or small tweaks. If you already have a complete v1 .env and want all the v2 files converted automatically, use the Config Converter instead.