PayRam Self-Hosted Crypto Payment Gateway

☁️ Deploy on DigitalOcean — 1-click deploy, no terminal needed. PayRam comes preinstalled on the droplet:

DigitalOcean 1-Click deployment guide

Or install onto a server you already have:

• Standard setup (full install + UI)
• Agent setup (single CLI flow for AI agents automation)

Agent One-Line Setup - Copy, paste, and run:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/PayRam/payram-scripts/main/setup_payram_agents.sh)"

🚀 Standard One-Line Setup - Copy, paste, and run:

bash <(curl -fsSL https://payram.com/setup_payram.sh)

If you see a permissions error, rerun with:

sudo bash -c 'bash <(curl -fsSL https://payram.com/setup_payram.sh)'

💡 One-Line with Arguments - Use the same pattern with flags:

# Fresh installation (default)
bash <(curl -fsSL https://payram.com/setup_payram.sh)

# Update existing installation
sudo bash -c 'bash <(curl -fsSL https://payram.com/setup_payram.sh) --update'

# Complete reset (removes all data)
sudo bash -c 'bash <(curl -fsSL https://payram.com/setup_payram.sh) --reset'

# Testnet deployment
sudo bash -c 'bash <(curl -fsSL https://payram.com/setup_payram.sh) --testnet'

# Specific Docker image tag
sudo bash -c 'bash <(curl -fsSL https://payram.com/setup_payram.sh) --tag=latest'

# Help and usage
sudo bash -c 'bash <(curl -fsSL https://payram.com/setup_payram.sh) --help'

💎 What is PayRam?

PayRam is a self-hosted cryptocurrency payment gateway that enables businesses to accept crypto payments directly - no middleman, no charge back, complete control. Perfect for e-commerce, APIs, subscriptions, and any business wanting to embrace the future of payments.

✨ Key Features

• 🏛️ Universal OS Support: Ubuntu, Debian, CentOS, RHEL, Fedora, Arch Linux, Alpine, macOS
• 🐳 Docker-Based: Containerized deployment with automatic dependency management
• 🔐 Security First: Keys not stored on server for fund collection, AES-256 encryption, secure credential storage, SSL/TLS support
• 🌐 Let's Encrypt Integration: Automatic SSL certificate management
• 📊 PostgreSQL Support: External database integration with connection validation
• 🎨 Enhanced UX: Beautiful ASCII art banners and guided setup experience
• ⚡ Quick Setup: Complete gateway deployment in minutes

🚀 Quick Start

Option 1: DigitalOcean 1-Click Droplet (Easiest)

The quickest way to get PayRam running. DigitalOcean provisions a droplet with PayRam already installed — nothing to compile, configure, or paste into a terminal.

What the 1-click deploy does:

• Click the button above — it opens the PayRam listing on the DigitalOcean Marketplace, then takes you to the droplet create page with the PayRam image already selected.
• Choose a region and plan, then click Create Droplet. That is the whole install — no setup script, no SSH, no manual Docker steps.
• Give it 5-10 minutes. On first boot the droplet pulls the PayRam Docker image and starts the service, so the dashboard is not reachable the instant the droplet turns green.
• Open http://<your_droplet_ip> in a browser to reach the PayRam dashboard.
• Want shell access? ssh root@<your_droplet_ip> — optional, only if you need it.
• Finish setup with the PayRam onboarding guide.

Full walkthrough: DigitalOcean 1-Click deployment guide

Runs on Ubuntu 24.04 LTS. Marketplace listing: https://marketplace.digitalocean.com/apps/payram

Option 2: Direct Install (Recommended for existing servers)

bash <(curl -fsSL https://payram.com/setup_payram.sh)

Option 3: One-Line with Arguments

# If the script asks for root privileges, rerun with sudo at the beginning
sudo bash -c 'bash <(curl -fsSL https://payram.com/setup_payram.sh) --update'

Option 4: Download and Run

curl -O https://raw.githubusercontent.com/PayRam/payram-scripts/main/setup_payram.sh
chmod +x setup_payram.sh
sudo ./setup_payram.sh

Option 5: Clone Repository

git clone https://github.com/PayRam/payram-scripts.git
cd payram-scripts
sudo ./setup_payram.sh

🛠️ Advanced Usage

Command Line Options

Local Script Execution:

# Fresh installation (default)
sudo ./setup_payram.sh

# Update existing installation
sudo ./setup_payram.sh --update

# Testnet deployment
sudo ./setup_payram.sh --testnet

# Specific Docker image tag
sudo ./setup_payram.sh --tag=latest

# Complete reset (removes all data)
sudo ./setup_payram.sh --reset

# Help and usage
sudo ./setup_payram.sh --help

One-Line Remote Execution:

# Fresh installation (default)
bash <(curl -fsSL https://payram.com/setup_payram.sh)

# Update existing installation
sudo bash -c 'bash <(curl -fsSL https://payram.com/setup_payram.sh) --update'

# Testnet deployment  
sudo bash -c 'bash <(curl -fsSL https://payram.com/setup_payram.sh) --testnet'

# Specific Docker image tag
sudo bash -c 'bash <(curl -fsSL https://payram.com/setup_payram.sh) --tag=latest'

# Complete reset (removes all data)
sudo bash -c 'bash <(curl -fsSL https://payram.com/setup_payram.sh) --reset'

📋 Requirements

System Requirements

• CPU: 2 cores
• RAM: 4 GB
• Storage: 50 GB SSD — the installer refuses to continue below 5 GB free and recommends 10 GB
• OS: Ubuntu 22.04, or another supported distribution — Debian, CentOS, RHEL, Fedora, Arch, Alpine, macOS
• Network: Internet connection for Docker images and dependencies

Automatic Dependencies

The script automatically installs:

• Docker
• PostgreSQL client tools
• SSL certificate utilities
• Required system packages

🔧 Configuration

Database Options

1. External PostgreSQL (Recommended)

   • Better performance and reliability
   • Automatic connection testing
   • Backup and scaling capabilities

2. Internal Database

   • Quick setup for testing
   • Single container deployment

SSL Certificate Options

1. Let's Encrypt (Recommended)

   • Free SSL certificates
   • Automatic renewal
   • Domain validation

2. Custom Certificates

   • Bring your own SSL certs
   • Enterprise CA support

3. Skip SSL

   • For development/testing
   • Behind load balancer/proxy

🔐 Security Features

• AES-256 Encryption: Hot wallet and sensitive data protection
• Secure Storage: Configuration files with restricted permissions (600)
• Privilege Separation: Root access only when necessary
• Database Security: Encrypted connection strings and .pgpass files
• SSL/TLS: HTTPS encryption with automatic certificate management

📁 File Structure

/home/$USER/.payraminfo/          # Configuration directory
├── config.env                   # Main configuration file
├── aes/                         # AES encryption keys
└── ssl/                         # SSL certificates

/home/$USER/.payram-core/         # Application data
├── db/postgres/                 # Internal database storage
└── log/supervisord/             # Application logs

🚨 Troubleshooting

Common Issues

One-Line Command Arguments: Use process substitution so the interactive menu still works:

# Correct syntax for one-liner with arguments
sudo bash -c 'bash <(curl -fsSL https://payram.com/setup_payram.sh) --reset'

# Incorrect (won't work)
curl -fsSL https://payram.com/setup_payram.sh | bash

Permission Denied: Rerun with sudo at the beginning

sudo bash -c 'bash <(curl -fsSL https://payram.com/setup_payram.sh)'

Docker Not Found: Script will install Docker automatically

# Manual Docker installation check
docker --version

Port Conflicts: PayRam publishes port 80, plus 443 when TLS terminates in the container. Check both are free:

sudo lsof -i :80 -i :443

SSL Certificate Issues: Verify domain DNS points to your server

dig +short yourdomain.com

Log Files

• Setup Log: /tmp/payram-setup.log (falls back to $HOME/payram-setup.log if /tmp is not writable)
• Application Logs: ~/.payram-core/log/supervisord/
• Docker Logs: docker logs payram

🤖 Agent / Headless CLI

For AI agents and automated workflows only. These scripts are currently in testing and are not intended for regular client use.

If you are an AI agent (or building agent-based integrations), the following scripts provide a headless CLI for PayRam operations:

Script	Purpose
setup_payram_agents.sh	Single agent entrypoint for install and headless operations

Quick Start (Agents)

# 1. Start PayRam locally (one-step flow)
./setup_payram_agents.sh

# 2. Sign in or set up
./setup_payram_agents.sh setup      # first time
./setup_payram_agents.sh signin     # subsequent times

# 3. Create a payment link
./setup_payram_agents.sh create-payment-link

For full agent documentation, see docs/PAYRAM_HEADLESS_AGENT.md.

🛍️ Shopify Integration (Optional)

Accept crypto payments directly on your Shopify store. The Shopify connector is an optional add-on — install Payram first, then run the Shopify installer separately.

One-Line Setup:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/PayRam/payram-scripts/main/setup_payram_shopify.sh)"

The installer only requires Docker. It handles Shopify CLI authentication, deploys the checkout UI extension, and starts the connector container automatically.

Reset an existing installation:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/PayRam/payram-scripts/main/setup_payram_shopify.sh)" --reset

For the full setup walkthrough, environment variables reference, architecture diagram, and update instructions, see docs/PAYRAM_SHOPIFY_CONNECTOR.md.

---

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test on multiple OS distributions
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

• GitHub Issues: Report bugs and request features
• Documentation: Full setup guide
• Community: Discord server

---

PayRam - Empowering businesses with decentralized payment infrastructure. No middleman, no fees, complete control. 🚀💎