Config Converter

Convert the .env configuration file of g0v0-server v1 into the set of config/*.json files required by g0v0 server v2, with a one-click bundled download.

The whole conversion runs locally in your browser — your configuration (including database passwords, JWT secrets and other sensitive values) is never uploaded anywhere.

1. Paste your g0v0-server v1 .env content

Everything is converted locally in your browser — no data is uploaded.

general.json

Use the v1 MySQL (legacy) database

realtime.json

Save spectator replays

Replay uploader concurrencyMax concurrent started scoresHost playlist item limitGuest playlist item limitDisconnect grace period (hh:mm:ss)Tournament room retention (hh:mm:ss)Sentry environment tagSentry trace sample rate (0–1)

Send default PII to Sentry

chat.json (optional)

Channel list limitMessage length limitAnnouncement length limitPublic backlog hoursActivity timeout (seconds)Recent messages attachedPublic messages per windowPublic rate window (seconds)Private messages per windowPrivate rate window (seconds)

2. Generated v2 config files

Put these files into the config/ directory of your g0v0 server v2 (e.g. g0v0.Server.Realtime).

Paste or upload your v1 .env above — the defaults below are used for missing values.

{
  "UseLegacyDatabase": true,
  "MySqlHost": "localhost",
  "MySqlPort": "3306",
  "MySqlDatabase": "osu_api",
  "MySqlUsername": "osu_api",
  "MySqlPassword": "password",
  "PostgresqlConnectionString": "Host=localhost;Port=5432;Username=g0v0;Password=password;Database=g0v0",
  "RedisHost": "localhost:6379",
  "JwtSecretKey": "your_jwt_secret_here",
  "JwtAlgorithm": "HS256",
  "JwtAudience": "5",
  "JwtIssuer": null,
  "OsuClientId": 5,
  "OsuClientSecret": "FGc9GAtyHzeQDshWP5Ah7dega8hJACAJpQtw6OXk",
  "OsuWebClientId": 6,
  "OsuWebClientSecret": "your_osu_web_client_secret_here",
  "FetcherClientId": 0,
  "FetcherClientSecret": "",
  "FetcherBeatmapRawCacheExpireHours": 24,
  "ServerUrl": "http://localhost:8000"
}

{
  "EnableRelax": false,
  "EnableAutopilot": false,
  "EnableAllBeatmapLeaderboard": false
}

{
  "SaveReplays": true,
  "ReplayUploaderConcurrency": 4,
  "MaxStartedScores": 2,
  "HostPlaylistLimit": 50,
  "GuestPlaylistLimit": 3,
  "MultiplayerDisconnectGracePeriod": "00:00:30",
  "TournamentRoomRetentionPeriod": "00:30:00",
  "Sentry": {
    "Dsn": "",
    "Environment": "",
    "TracesSampleRate": 0.1,
    "SendDefaultPii": false
  }
}

{
  "ChannelLimit": 10000,
  "MessageLengthLimit": 450,
  "AnnounceMessageLengthLimit": 1024,
  "PublicBacklogLimitHours": 24,
  "ActivityTimeoutSeconds": 60,
  "RecentMessageLimit": 50,
  "PublicMessageLimit": 1,
  "PublicMessageWindowSeconds": 1,
  "PrivateMessageLimit": 1,
  "PrivateMessageWindowSeconds": 1
}

chat.json is optional in v2 and has no v1 equivalent — the values start from the upstream (osu-web) defaults and can be changed in “Other v2 settings”.

{
  "Type": "Local",
  "Options": {
    "local_storage_path": "./storage"
  }
}

Converted variables

v1 .env variable	v2 target
MYSQL_HOST	general.json → MySqlHost
MYSQL_PORT	general.json → MySqlPort
MYSQL_DATABASE	general.json → MySqlDatabase
MYSQL_USER	general.json → MySqlUsername
MYSQL_PASSWORD	general.json → MySqlPassword
REDIS_URL	general.json → RedisHost
JWT_SECRET_KEY	general.json → JwtSecretKey
JWT_ALGORITHM	general.json → JwtAlgorithm
JWT_AUDIENCE	general.json → JwtAudience
JWT_ISSUER	general.json → JwtIssuer
OSU_CLIENT_ID	general.json → OsuClientId
OSU_CLIENT_SECRET	general.json → OsuClientSecret
OSU_WEB_CLIENT_ID	general.json → OsuWebClientId
OSU_WEB_CLIENT_SECRET	general.json → OsuWebClientSecret
FETCHER_CLIENT_ID	general.json → FetcherClientId
FETCHER_CLIENT_SECRET	general.json → FetcherClientSecret
BEATMAP_CACHE_EXPIRE_HOURS	general.json → FetcherBeatmapRawCacheExpireHours
SERVER_URL	general.json → ServerUrl
ENABLE_RX / ENABLE_OSU_RX	game.json → EnableRelax
ENABLE_AP / ENABLE_OSU_AP	game.json → EnableAutopilot
ENABLE_ALL_BEATMAP_LEADERBOARD	game.json → EnableAllBeatmapLeaderboard
SENTRY_DSN	realtime.json → Sentry.Dsn
STORAGE_SERVICE	storage.json → Type
STORAGE_SETTINGS	storage.json → Options

Usage

1. Paste the content of your v1 server's .env into the input box above, or use "Upload file" to pick the .env file (you can also click "Load sample" to try it out first).
2. Review the generated JSON files (general.json, game.json, realtime.json, chat.json, storage.json).
3. Click "Download all (.zip)", then extract the config/ directory into the working directory of your v2 server (e.g. g0v0.Server.Realtime).

Missing variables fall back to the v2 defaults automatically. v1 variables that have no v2 counterpart are listed below the converter so you can review them one by one.

Notes

• UseLegacyDatabase in general.json defaults to true (keep using the v1 MySQL database). If you want to switch to the new v2 PostgreSQL database, untick the option in the "Other v2 settings" section and fill in PostgresqlConnectionString.
• REDIS_URL is converted into the host:port format that v2 expects (the redis:// scheme and any embedded password are stripped).
• v2-only settings (such as the replay upload concurrency and multiplayer room limits in realtime.json, or the chat limits in chat.json) are generated with their defaults and can be tuned in the collapsible "Other v2 settings" section below the input box. See the g0v0.Server.Realtime README for the full field reference.
• config/chat.json is optional: when the file is absent, all chat limits use the defaults from osu-web.

Working with other v2 services

The configuration generated on this page applies to the g0v0 server v2 series. All v2 services share the database, JWT and storage settings from config/general.json, so make sure every service uses the same general.json and storage.json when migrating.