Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

How do I actually run an Ink mainnet node right now?

Open
#87 1 comment 0 reactions 0 assignees View on GitHub

@Alicepoltora is already working on this.

Since Sep 27, 2026.

  • #93 by @Alicepoltora — open

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
25/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Quiet
Tech stack
shell

Research direction

Start with envs/ink-mainnet/op-node.env and verify the documented bootnodes and port 30305 against the current Ink mainnet setup. Check whether a working snapshot or reachable op-reth peers are identified; done means documenting a reproducible path to a synced mainnet node.

Written by the indexing model from the issue text.

Description

Trying to run an Ink mainnet node and hitting dead ends on every path:

  1. NODE_TYPE=archive fails — ink.snapshots.gelato.cloud doesn't resolve (NXDOMAIN),
    so no snapshot download.
  2. NODE_TYPE=full with op-geth technically syncs from genesis, but op-geth can't
    follow the chain post-Karst anyway.
  3. Tried migrating to op-reth manually (v2.2.5 + op-node v1.18.2) since that's the
    recommended path now, but it has zero P2P peers (using the bootnodes from
    envs/ink-mainnet/op-node.env, port 30305 — all unreachable) so it never
    backfills state.

What's the actual working way to bring up a synced mainnet node right now? Is there
a current snapshot, or working op-reth peers?

Dominant language
Shell
Stars
36.4k
Forks
643
PR merge metrics
No merged PRs in 30d

Getting set up

  • Ships a Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from inkonchain/node

All issues in inkonchain/node

Similar issues

More Shell/Bash issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.