[ZK Stack] - Example of production ready setup for a rollup

[nktaushanov]

Team or Project

No response

Module Affected

• System contracts (era-system-contracts)
• Smart contracts (era-contracts)
• zkEVM (era-zk_evm)
• Server (zksync-era)
• Prover (era-boojum)
• Fee withdrawer (era-fee-withdrawer)
• Block Explorer (clock-explorer)
• Portal - Wallet + Bridge (dapp-portal)
• Other (please specify below)

Rust Version

1.82.0

Operating System

• Ubuntu
• MacOS
• Windows
• Other (Please specify below)

Issue Description

I find your documentation extremely helpful and very detailed! Thank you for putting all the work into this. I hope I'm not missing some obvious here but I'm trying to find the steps for creating a more production ready rollup spin up, not just local setup.
I have an issue spinning up a local stack - #888 but my ultimate goal is to spin up a testnet rollup using docker-compose (which I will then migrate to a k8s deployment) which settles on sepolia. I found the local-node docker example here https://github.com/matter-labs/local-setup/tree/main but I would to experiment with a production ready setup. A couple of questions arise from this:

1. Do you have examples of a more production ready setup with different components running separately?
2. Is there a prebuilt docker images I can use instead of building them myself as described here https://github.com/matter-labs/zksync-era/blob/main/docs/src/guides/build-docker.md?
3. How can I generate the configuration about these images? For example I found this server docker image that you provide https://github.com/orgs/matter-labs/packages/container/package/server-v2 but I was not able to find a documentation on how to configure the containers - what env vars to pass or if there is a way to generate these? Also the image seems to be built only for linux-amd64 and I was not able to run it natively on my macos, am I looking at the wrong image? I found this template - https://github.com/matter-labs/zksync-era/blob/main/etc/hyperchains/docker-compose-hyperchain-template.hbs but was not able to generate the actual values as I'm not able to build infrasturecture/zk (yarn build gives me missing utils error).

Expected Behavior

Current Behavior

Repository Link (if applicable)

No response

Additional Details

No response

Prior Research

• Yes, I searched for similar issues and did not find any matching ones.

[popzxc]

Hello! Right now, the documentation and infrastructure for running ZKsync networks in production is under development.
In general, the architecture is built for k8s using helm charts. The charts, however, are not open-source yet.

Docker images can currently be found on dockerhub, we're working on migrating to ghcr fully, but it's WIP.
There is a tag for each release that was pushed to testnet, you can query it as 2.0-v<version>, e.g. here's an image for release v25.4.0.
Prover images can be found there as well, they follow the different release schedule.

The information on releases can be found on the releases page.

Now, onto the configuration. Currently, we're using file-based configuration system, so configuring it is very similar to running the system locally via zkstack CLI. One option would be to mount a volume with files and provide path to it. Another option would be to use k8s to map configuration to files (if running in k8s).

To see how to pass arguments to the server binary, you can run it directly after compiling, e.g. ./target/release/zksync_server --help.