🐝 Quick Start: Boundless Prover on QuickPod

Last updated: July 16, 2025

What You’ll Need

Before you begin, make sure you have:

• 10 USDC in your wallet (on the correct network)
• An RPC URL, for example: https://eth-sepolia.g.alchemy.com/v2/A1bC23dEfG456hiJkLmnOpQRsTuvWxYz
• Your wallet’s private key, like: 5f6a2b8790ac134d47fe28bcad6150eb7f426b8d60a743dc5b0940fbea29c6d1
• A NETWORK value that matches the network you're using (see below)

Supported Networks

Network	NETWORK Value
Base Mainnet	base
Base Sepolia	base-sepolia
Ethereum Sepolia	eth-sepolia

Warning

Make sure your USDC, wallet, and RPC endpoint are all on the same network

If you don't know what any of this means, please read the Account Setup Guide first.

---

🚀 Step-by-Step: Launching on QuickPod

1. Create Your Pod

1. Go to QuickPod Templates

2. Search for boundless and Clone the template

3. In the Docker Options edit the following

Warning

Replace the placeholder values below with your actual values from the prerequisites step:

Placeholder	Replace With
YOUR_PRIVATE_KEY_GOES_HERE	Your actual wallet private key
YOUR_RPC_URL_HERE	Your actual RPC URL
eth-sepolia	Your chosen network value (see supported networks table above)

Then hit Save.

5. Launch a machine using your new template.

Step 2: Stake 10 USDC

Note

You can skip this step if you’ve already staked from this wallet.

Once your pod is running:

1. SSH into the container.

2. Run the staking command:

   boundless account deposit-stake 10

You should see a message confirming the stake was successful.

Verify Your Stake

You can verify your stake by visiting the appropriate explorer:

Network Type	Explorer URL
Testnet	https://explorer.testnet.beboundless.xyz/balances
Mainnet	https://explorer.beboundless.xyz/balances

Step 3: Restart the Services

Note

Skip this if services are already running from a previous stake.

After staking, restart the services:

supervisorctl restart all

This ensures the prover loads with the updated state.

Step 4: Check the Broker Logs

Open your browser and go to:

You should see the Boundless broker UI showing your prover’s status.

FAQ

1. Where is the docker-compose.yml file? This setup does not use Docker or docker-compose. Instead, services are managed using Supervisor. You can configure which services run by editing:

   /app/supervisord.conf
   

   After making changes, restart all services with:

   supervisorctl restart all

2. How do I restart a specific service (like the broker)? Use this command format:

   supervisorctl restart <service-name>

   For example, to restart the broker service:

   supervisorctl restart broker

3. Where can I edit the broker.toml configuration? The file is located at:

   /app/broker.toml
   

   You can edit it using a text editor:

   • With nano (beginner-friendly):

     nano /app/broker.toml

   • Or with vi (more advanced):

     vi /app/broker.toml

4. How can I check logs? Logs for all services are in:

   /app/logs
   

   You can view them using:

   • To view the full log:

     cat /app/logs/<filename>.log

   • To scroll through:

     less /app/logs/<filename>.log

   • To follow logs in real time:

     tail -f /app/logs/<filename>.log

5. How do I increase the number of exec_agents? You can add the following option when starting the container:

   -e AGENTS=<number>

   By default, it runs with 2 agents. For example, to run 4 agents:

   -e AGENTS=4 ...

6. How do I update CPU or memory limits? Currently, there is no built-in way to limit resource usage. All processes will share the available CPU and memory of the container.

7. What settings should I use for my GPU? Update your docker options with the proper segement size based on the table below:

-e SEGMENT_SIZE=16

GPU Memory	Recommended Segment Size	Memory Used	Cycles	Performance	Common GPU Models
1-2GB	16	~512MB	65K	Basic	GTX 1050, RTX 3050 (4GB)
2-4GB	17	~1GB	131K	Good	GTX 1060, RTX 3060 Ti
4-6GB	18	~2GB	262K	Better	GTX 1070, RTX 3060
6-8GB	19	~4GB	524K	Great	GTX 1080, RTX 3070
8-12GB	20	~6GB	1M	Excellent	RTX 3080, RTX 4070
12GB+	21 (default)	~7GB	2M	Maximum	RTX 3080 Ti, RTX 3090, RTX 4080, RTX 4090
16GB+	22	~12GB	4M	Overkill	RTX 3090, 4090, A100
24GB+	23	~20GB	8M	Enterprise	RTX 6000, A100