selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

zoneless logo

Self-host zoneless

v0.1.0

Open-source payments platform for stablecoins

BetaOpen SourceApache-2.0
Updated5 months ago
LanguageTypescript
Setup difficultyModerate
Stars
573
RAM
2 GB
Ports
3333 (API), 80 (Dashboard)
Requires
MongoDB, Solana RPC
Install with Docker Compose
Zoneless payments platform overviewPlatform dashboard showing payments, customers, products, subscriptionsHosted checkout for USDC paymentsPayment activity and transactions viewSubscriptions management interfaceSeller onboarding flow with wallet connectionIdentity verification (KYC) dashboardSeller Express dashboard for earnings and payouts

What is zoneless?

Zoneless is an open-source payments platform built around USDC stablecoins. It delivers checkout flows, recurring billing, marketplace seller onboarding, identity verification, and payouts through an API that mirrors Stripe's design. Operators control everything from a dashboard covering transactions, clients, catalog items, recurring plans, linked accounts, and balances. Under the hood it runs an Express.js API, Angular frontend, MongoDB database, and settles on Solana. You deploy it with Docker Compose and a setup wizard that creates platform accounts and API keys.

Should you self-host zoneless?

zoneless scores 50/100 on selfhost.directory (how scoring works) and ranks #4 of 10 in E-commerce. It has 573 GitHub stars.

It shipped 1 stable release in the past year. The latest, v0.1.0, came out on 23 March 2026.

Setup is moderate: expect some configuration beyond a single command. It is Apache-2.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is BTCPay Server (76/100, 7 860 stars). It scores higher overall, so compare the two before you pick. See zoneless vs BTCPay Server side by side.

Features

  • Identity Verification (KYC)
  • Marketplace Payouts
  • Node.js SDK
  • Platform Dashboard
  • Seller dashboard
  • Stripe-Compatible API
  • Subscriptions
  • Test Mode with Simulated USDC
  • USDC Checkout
  • Webhooks

zoneless README

How to install zoneless

Install zoneless with Docker Compose

Environment variables
DASHBOARD_URL, DASHBOARD_PORT, API_PORT, MONGODB_URI, APP_SECRET, SINGLE_TENANT, OPERATOR_API_KEY, SOLANA_RPC_URL, LIVEMODE, SETTLEMENT_RAIL, SUBSCRIPTION_OPERATOR_KEY, TRANSACTION_FEE_PAYER_KEY, BILLING_MONITOR_ENABLED, BILLING_POLL_INTERVAL_MS, ZONELESS_TELEMETRY, CHECKOUT_URL, PAYMENT_LINK_URL

git clone https://github.com/zonelessdev/zoneless.git cd zoneless docker compose up -d

Full-stack Docker setup with API, dashboard, and MongoDB

How to configure zoneless

  • API_PORT3333Port used by the API.

    Port used by the API.

  • APP_SECRETSecret key for signing JWTs and encrypting data.

    Secret key for signing JWTs and encrypting data.

  • BILLING_MONITOR_ENABLEDfalseSubscription billing: in-process poller (single-instance Docker / local only).

    Subscription billing: in-process poller (single-instance Docker / local only).

    values: true,false

  • BILLING_POLL_INTERVAL_MS60000Billing poll interval in milliseconds.

    Billing poll interval in milliseconds.

  • CHECKOUT_URLOptional dedicated checkout origin.

    Optional dedicated checkout origin.

  • DASHBOARD_PORT80Host port used by the Docker dashboard.

    Host port used by the Docker dashboard.

  • DASHBOARD_URLPublic dashboard URL. Required in production.

    Public dashboard URL. Required in production.

  • LIVEMODEfalseLIVEMODE=true uses Solana mainnet (real USDC). Unset/false is test mode.

    LIVEMODE=true uses Solana mainnet (real USDC). Unset/false is test mode.

    values: true,false

  • MONGODB_URIMongoDB connection string.

    MongoDB connection string.

  • OPERATOR_API_KEYOperator mode (managed hosting): set a long random secret to enable.

    Operator mode (managed hosting): set a long random secret to enable.

  • PAYMENT_LINK_URLOptional dedicated payment-link origin.

    Optional dedicated payment-link origin.

  • SETTLEMENT_RAILsimulatedHow test mode settles money: simulated (default) or onchain (Solana Devnet).

    How test mode settles money: simulated (default) or onchain (Solana Devnet).

    values: simulated,onchain

  • SINGLE_TENANTtrueSingle-tenant mode: only one platform can be created.

    Single-tenant mode: only one platform can be created.

    values: true,false

  • SOLANA_RPC_URLSolana RPC endpoint (required for live / on-chain settlement).

    Solana RPC endpoint (required for live / on-chain settlement).

  • SUBSCRIPTION_OPERATOR_KEYBase58 secret key that owns on-chain subscription plans and signs pulls.

    Base58 secret key that owns on-chain subscription plans and signs pulls.

  • TRANSACTION_FEE_PAYER_KEYOptional base58 secret key that sponsors Solana checkout network fees / rent.

    Optional base58 secret key that sponsors Solana checkout network fees / rent.

  • ZONELESS_TELEMETRYAnonymous usage telemetry (opt-in via setup/settings; off by default).

    Anonymous usage telemetry (opt-in via setup/settings; off by default).

zoneless releases & version history

More in E-commerce

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…