Local Development

Tips and tools to make local development with Zoneless easier — from funding test wallets to inspecting your database and debugging Docker containers.

Test funds

When running in test mode (LIVEMODE=false), you can add test funds to your Solana wallet directly from the platform dashboard. You'll need both SOL (for transaction fees) and USDC (for transfers and payouts).

Adding test SOL

  • Click the Add Funds button on the platform dashboard.
  • Click Get test SOL to open the Solana faucet.
  • Paste your wallet address and request an airdrop. You can request SOL twice per day and must link your GitHub account.
  • Back on the dashboard, click Details next to your balance to verify the funds arrived.

Adding test USDC

  • In the Add Funds panel, click Get test USDC to open the USDC faucet.
  • Select Solana devnet as the network and paste your wallet address.
  • Go back to the Add Funds panel and click I've sent my funds.
  • Wait for the USDC to be detected and reflected in your balance.
Live mode. Set LIVEMODE=true to switch to Solana mainnet. In live mode, you'll fund your wallet with real SOL and USDC.

Viewing the database

Zoneless ships with Mongo Express, a web-based MongoDB admin interface. Use it to inspect the raw data in your local database — useful for debugging and verifying API behavior.

  • Open localhost:8082 in your browser.
  • Log in with username admin and password admin123.
  • Browse collections to see accounts, payouts, transfers, and other data for your local instance.
Local only. These default credentials are for local development. If you expose Mongo Express in production, change the credentials in your environment configuration.

Webhooks with Docker

When testing webhooks locally inside Docker, your webhook handler running on the host machine isn't reachable at localhost from inside a container. Docker maps localhost to the container itself, not your host machine.

Use http://host.docker.internal instead of http://localhost when registering your webhook endpoint URL. This special hostname resolves to your host machine from inside Docker containers.

Webhook URL in Docker
# Instead of this:
http://localhost:4242/webhook

# Use this when running inside Docker:
http://host.docker.internal:4242/webhook

Following API logs

Tail the API container logs to see incoming requests, errors, and debug output from your local Zoneless instance in real time.

Tail API logs
docker logs --follow zoneless-api