Cosmos Port Prefixes

April 25, 2026 ยท View on GitHub

Rationale

Node operators in the Cosmos ecosystem often wants to run multiple Cosmos SDK-based nodes on the sames server to save cost.

The Cosmos SDK init command will generate config.toml and app.toml for each node. Without revision, the ports in these files will conflict with each other if multiple nodes are ran on the same server.

This project is an attempt to standardize these ports while avoiding port conflict. While any random non-conflicting ports can do, a standardized port prefix system can make the port assignment more predictable. Moreover, if two node operators follow the same system, they can easily exchange deployment scripts without breaking codes.

How to Use

The best way to use the port prefix system is to use Ansible deployment script.

You can also change these 9 ports (5 in config.toml and 4 in app.toml) manually. See below.

config.toml:
  'laddr = "tcp://0.0.0.0:26656"': 'laddr = "tcp://0.0.0.0:{{ custom_port_prefix }}56"' # also use this port for external_address
  'laddr = "tcp://127.0.0.1:26657"': 'laddr = "tcp://0.0.0.0:{{ custom_port_prefix }}57"'
  'proxy_app = "tcp://127.0.0.1:26658"': 'proxy_app = "tcp://127.0.0.1:{{ custom_port_prefix }}58"'
  'prometheus_listen_addr = ":26660"': 'prometheus_listen_addr = ":{{ custom_port_prefix }}61"'
  'pprof_laddr = "localhost:6060"': 'pprof_laddr = "localhost:{{ custom_port_prefix }}60"'
app.toml:
  'address = "tcp://0.0.0.0:1317"': 'address = "tcp://0.0.0.0:{{ custom_port_prefix }}17"'
  'address = ":8080"': 'address = ":{{ custom_port_prefix }}80"'
  'address = "0.0.0.0:9090"': 'address = "0.0.0.0:{{ custom_port_prefix }}90"'
  'address = "0.0.0.0:9091"': 'address = "0.0.0.0:{{ custom_port_prefix }}91"'

Supported Chains and Prefixes

Note: Please do not use 266 as port prefix because this is the default

NetworkPort Prefix
Test100
Hypersign109
Kyve110
Quicksilver111
Defund112
Gitopia113
Deweb114
Archway115
Celestia116
Terra2117
Kujira118
Sei119
Echelon120
Paloma121
Stride122
Cudos123
Althea124
Osmosis125
Juno126
Nomic127
Akash128
Chihuahua129
Bitcanna130
Comdex131
Sifchain132
Konstellation133
Evmos134
Kichain135
Umee136
Stargaze137
Cerberus138
Kava139
Certik140
Sommelier141
Gravity142
Injective143
Agoric144
Crescent145
Assetmantle146
Meme147
Galaxy148
Cosmos149
Androma150
Axelar151
FetchHub152
Nym153
Persistence154
Canto155
Passage156
Craft157
Source158
Teritori159
Bitsong160
Cheqd161
Desmos162
Dig163
Firmachain164
IDEP165
Impacthub166
Lum167
Odin168
Omniflix169
Vidulum170
Secret171
Rebus172
Nois173
Empower174
Jackal175
axone176
SGE Network177
loyal178
ICS Apollo179
ICS Sputnik180
Ollo181
Quasar182
Joe183
Humans184
Mars185
interchain186
interchain_topn_one187
ICS RESERVED 3188
ICS RESERVED 4189
ICS RESERVED 5190
neutron191
ICS RESERVED 7192
Alliance193
Pylons194
Heimdall195
Carbon196
Nolus197
Nibiru198
Lava199
Namada200
XPLA201
Crypto.com202
Planq203
Uptick204
Dymension205
Babylon206
Whitewhale(migaloo)207
Alliance ordos208
Alliance corrino209
Alliance harkonnen210
Alliance atreides211
Andromeda212
eightball213
BlockX214
Noble215
Ojo216
Aura217
Stratos218
Penumbra219
Elys220
Noria221
Picasso222
Xion223
TENET224
Zetachain225
IRISnet226
Regen227
Arkeo228
Band229
Vega230
Duality231
UnUniFi232
Orai233
Decentr234
Qwoyn235
Cronos236
Router237
Dydx238
Sentinel239
Haqq240
Temporal241
Functionx242
Selfchain243
Coreum244
Stafi Hub245
Union246
Fairyring247
Pryzm248
Saga249
SwapLand250
Mantrachain251
Soarchain252
Dora253
Berachain254
Aether255
Terra Classic256
Initia257
SEDA258
Wormhole259
Cross Finance260
Pundix261
Rizon262
Bitway263
Swisstronik264
GovGen265
RESERVED266
Allora267
Hedgeblock268
Furya269
Provenance270
UNDISCLOSED271
Chain4Energy272
Warden273
Galactica274
AlignedLayer275
Kopi276
Ethos277
Artela278
Synternet279
CosmosTheta280
Nillion281
dHealth282
Sunrise283
OG Network284
Settlus285
Shido286
Int3face287
Fiamma288
Titan289
Empe290
Symphony291
Story292
Laconic293
Symbiotic294
Zenrock295
Fuel296
Tabi297
Prysm298
AtomOne299
xrplevm300
Pell301
Mezo302
Aaron303
Echos304
Medas Digital305
Native Network306
Lumera307
Sphinx308
Medibloc309
Likecoin310
Intento311
ZkCloud312
Odiseo313
Joltify314
Kiichain315
Torram316
Airchains317
Hippo318
Milkyway319
Sahara320
Tac321
Qubetics322
BounceBit323
LayerEdge324
Gnoland325
Xos326
Safrochain327
Zigchain328
BitBadges329
Push Chain330
Republic331
Interval332
Monolythium333
Pocket334
....
Initia Yominet400
Initia Civitia401

JSON API

Here is the JSON API.