Skip to main content
payram-setup Deploy and configure your PayRam self-hosted crypto payment gateway server with web dashboard. Install on VPS via setup_payram.sh, set up PostgreSQL database, configure root account, node details, wallets, and hot wallets through the web UI. Complete deployment and onboarding in under 10 minutes. No signup required — fully self-hosted. For CLI-only deployment optimized for AI agents without web UI, see payram-agent-onboarding. Use when deploying PayRam with dashboard interface, setting up server infrastructure with web-based configuration, or requiring manual wallet management UI.
설치로 이동 Skills Marketplace 커뮤니티가 만든 AI 스킬을 발견하고 탐색하세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/PayRam/payram-mcp --skill payram-setup명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
Zip 다운로드 다운로드 중... name payram-setup description Deploy and configure your PayRam self-hosted crypto payment gateway server with web dashboard. Install on VPS via setup_payram.sh, set up PostgreSQL database, configure root account, node details, wallets, and hot wallets through the web UI. Complete deployment and onboarding in under 10 minutes. No signup required — fully self-hosted. For CLI-only deployment optimized for AI agents without web UI, see payram-agent-onboarding. Use when deploying PayRam with dashboard interface, setting up server infrastructure with web-based configuration, or requiring manual wallet management UI.
PayRam Setup
This is the deployment and onboarding guide for PayRam. Deploy the PayRam server on your VPS and configure the dashboard before integrating payments into your application.
What is PayRam?
PayRam is a self-hosted crypto payment gateway. You deploy it on your own server — no signup, no KYC, no third-party custody. Accept USDT, USDC, Bitcoin, and ETH across Ethereum, Base, Polygon, and Tron.
Need CLI-only deployment for AI agents? See payram-agent-onboarding
Part 1: Deploy PayRam Server
Prerequisites
Server Requirements:
CPU : minimum 2 cores (recommended 4 cores)RAM : minimum 6 GB (recommended 8 GB)Storage : 15 GB+ diskOS : Ubuntu 22.04Ports : 80, 443, 8080, 8443, 5432
Database Requirements:
Engine : PostgreSQLvCPUs : 2 CPU cores
Memory : 8 GB
Storage : 15 GB+ diskRecommended VPS Providers: AWS, Google Cloud, Azure, Hetzner, Hostinger
Agent Onboarding Setup (No Web UI - For AI Agents Only) Use this method when you need agent-only PayRam setup for AI agents without the web dashboard.
This automated script deploys a PayRam instance optimized for AI agents (Claude, Copilot, custom MCP clients, n8n). No web UI is installed — only the API backend and MCP server.
Connect to your VPS via SSH
Run the agent onboarding setup script:
/bin/bash -c "$(curl -fsSL https://payram.com/setup_payram_agents.sh) "
Follow interactive prompts:
PostgreSQL connection details
Domain/IP address configuration
MCP server endpoint configuration
API credentials generation
Copy the generated MCP config from the output:
{
"mcpServers" : {
"payram" : {
"url" : "https://your-domain.com/mcp" ,
"apiKey" : "your-generated-api-key"
}
}
}
Paste config into your agent's settings (Claude Desktop, Copilat, or custom MCP client) What the agent onboarding setup includes:
PayRam API backend (no web UI)
MCP server for agent integration
Database setup and migrations
Docker container orchestration
API key generation
Agent configuration file generation
Web dashboard UI
Manual wallet configuration UI
Payment link browser interface
Total setup time: ~15 minutes
Use case: Pure agent-to-agent payments, programmatic treasury management, automated payment processing without human interaction.
Quick Setup (Manual - 10 Minutes) Use this method for standard deployments without AI agent integration.
Connect to your VPS via SSH
Choose network (mainnet or testnet)
Run the installation script:
bash <(curl -fsSL https://payram.com/setup_payram.sh)
Follow the interactive prompts:
Enter PostgreSQL connection details
Set encryption keys
Configure domain/IP address
Choose SSL certificate options
Wait for installation to complete (~5-10 minutes)
The script automatically:
Installs dependencies
Sets up Docker containers
Configures database connections
Generates SSL certificates (if using Let's Encrypt)
Starts PayRam services
Note: For AI agent integration, use the automated agent setup above instead.
Advanced Setup (Docker) For manual Docker deployment with custom configurations:
git clone https://github.com/PayRam/payram-server.git
cd payram-server
Configure environment variables: cp .env.example .env
nano .env
Start with Docker Compose:
Verify services are running: For detailed Docker setup instructions, see the PayRam deployment documentation.
Part 2: Onboard Your PayRam Instance After the server is installed and running, complete the onboarding configuration through the dashboard.
Step 1: Create Root Account
Navigate to signup page:
Open http://<your-ip-address>/signup in your browser
Replace <your-ip-address> with your server's IP or domain
Set root email:
Enter your admin email (you'll use this to log in)
This becomes your root/administrator account
Set root password:
Create a strong password and store it securely
You can change it later in dashboard settings
Create your first project:
Enter a project name (e.g., "My E-commerce Store")
Projects represent different products/websites using PayRam
Step 2: Configure Node Details After logging in, configure blockchain node connections:
Go to Settings → Node Details
For each chain you want to support:
Enter RPC endpoint URLs (public or private)
Recommended: Use dedicated node providers for production
Example providers: Alchemy, Infura, QuickNode, GetBlock
Test connections to verify nodes are accessible
Ethereum (Mainnet/Testnet)
Base (Mainnet/Testnet)
Polygon (Mainnet/Testnet)
Tron (Mainnet/Testnet)
Bitcoin (Mainnet/Testnet)
Step 3: Configure Wallets Set up your wallet infrastructure:
Go to Settings → Wallets
For each chain, configure:
Sweep Contract Address (deploy once per chain)Cold Wallet Address (where funds are swept to)Hot Wallet (for gas fees and instant payouts)
Deploy sweep contracts using the provided scripts in the dashboard
Fund hot wallets with native tokens:
ETH for Ethereum/Base
MATIC for Polygon
TRX for Tron
BTC for Bitcoin
Step 4: Set Up Hot Wallets Configure hot wallets for paying gas fees:
Go to Settings → Hot Wallets
For each chain:
Generate a hot wallet or import an existing one
Fund it with enough native tokens for gas
Set auto-refill thresholds (optional)
Recommended Hot Wallet Balances:
Ethereum: 0.5-1 ETH
Base: 0.1-0.5 ETH
Polygon: 100-500 MATIC
Tron: 1000-5000 TRX
Step 5: Configure Funds Sweeping Set up automatic fund sweeping to your cold wallet:
Go to Settings → Sweeping Configuration
Configure sweep rules:
Minimum balance threshold before sweep
Sweep schedule (e.g., every 6 hours)
Gas price limits
Enable auto-sweep for each chain
Test sweep with a small payment to verify everything works
Step 6: Generate API Keys Create API keys for your application:
Go to Settings → API Keys
Generate a new API key for your project
Copy and securely store:
PAYRAM_API_KEY (for authentication)PAYRAM_BASE_URL (your server's URL)
Use these in your application's .env file
Part 3: Test Your Setup After completing deployment and onboarding, verify everything works:
Test Payment Link
Go to Payment Links in the dashboard Create a test payment (e.g., $1 USD)Complete the checkout flow Verify payment appears in dashboardCheck funds swept to cold wallet
Verify API Access curl -X POST https://your-server.com/api/v1/payment \
-H "API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"customerEmail": "test@example.com",
"customerId": "test-123",
"amountInUSD": 1
}'
{
"reference_id" : "ref_..." ,
"url" : "https://your-server.com/checkout/..." ,
"host" : "your-server.com"
}
Troubleshooting Setup Issues Issue Cause Fix Can't access dashboard Firewall blocking ports Open ports 80, 443, 8080, 8443 Database connection error Wrong credentials Check PostgreSQL connection string in .env SSL certificate error Domain not configured Use HTTP for testing, or configure Let's Encrypt Node RPC failing Invalid endpoint Verify RPC URL and API key with provider Sweep not working Hot wallet empty Fund hot wallet with native tokens API 401 error Wrong API key Regenerate in Settings → API Keys
Next Steps After your PayRam server is deployed and configured, start integrating it into your application:
For AI Agent Onboarding Setup:
Your MCP server is ready — no manual configuration needed
Test agent capabilities using natural language commands
See payram-crypto-payments skill for MCP tool documentation
Agents can manage payments programmatically without web UI
See payram-agent-onboarding for CLI commands
For Full Setup with Dashboard:
Complete onboarding: root account, wallets, hot wallets (see Part 2 above)
Integrate payments into your app → payram-payment-integrationComplete checkout implementation → payram-checkout-integrationHandle webhooks → payram-webhook-integrationSend payouts → payram-payoutsLearn about stablecoin payments → payram-stablecoin-payments
MCP Server Tools For automated setup assistance, use the PayRam MCP server:
Tool Purpose generate_env_templateCreate .env with all required variables generate_setup_checklistStep-by-step deployment runbook test_payram_connectionValidate API connectivity
All PayRam Skills Skill What it covers payram-setupDeploy PayRam server, configure dashboard, wallets, and hot wallets payram-agent-onboardingAgent onboarding — CLI-only deployment for AI agents, no web UI payram-analyticsAnalytics dashboards, reports, and payment insights via MCP tools payram-crypto-paymentsArchitecture overview, why PayRam, MCP tools payram-payment-integrationIntegrate payments into your application code payram-self-hosted-payment-gatewayDeep dive into PayRam infrastructure and deployment payram-checkout-integrationBuild complete checkout flows in 6 frameworks payram-webhook-integrationHandle payment webhooks in Express, Next.js, FastAPI, etc. payram-stablecoin-paymentsAccept USDT/USDC across EVM chains and Tron payram-bitcoin-paymentsBitcoin payments with HD wallets and mobile signing payram-payoutsSend crypto payouts and manage referral programs payram-no-kyc-crypto-paymentsNo-KYC, no-signup, permissionless payment acceptance
Need help? Message the PayRam team on Telegram: @PayRamChat
이 저장소의 다른 Skills Set up and operate PayRam - a private, self-hosted crypto payment gateway (payment links, hosted checkout, USDC/BTC/ETH deposits, sweeps to a cold wallet you control). No signup, no KYB. Use this skill when a user wants to accept crypto payments, set up a payment gateway, create payment links, or integrate PayRam into an application.
payram-checkout-integration Integrate PayRam checkout flow into web applications. Generate payment links, embed payment pages, handle redirects, and process payment confirmations. Supports Express, Next.js, FastAPI, Laravel, Gin, Spring Boot. Use when adding crypto checkout to e-commerce, building payment forms, implementing deposit flows, or creating hosted payment pages for crypto acceptance.
The end-to-end map for an agent standing up PayRam and taking it live — install (merchant OR operator), deposit wallets, gas + sweep operations, app integration, and testing. Routes every stage to the right tool or skill and covers both install roles. Use this FIRST when asked to "set up PayRam", "get PayRam ready to take payments", "which PayRam tool/skill do I use for X", or when planning a full deployment.
