{"id":50816989,"url":"https://github.com/PayRam/payram-scripts","last_synced_at":"2026-06-30T18:00:42.018Z","repository":{"id":278601490,"uuid":"936043270","full_name":"PayRam/payram-scripts","owner":"PayRam","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-18T12:19:42.000Z","size":437,"stargazers_count":151,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-06-18T14:17:07.050Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PayRam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-20T12:43:43.000Z","updated_at":"2026-06-18T12:19:54.000Z","dependencies_parsed_at":"2025-02-20T17:37:02.773Z","dependency_job_id":"b1dcec28-66d9-494d-9ef2-86d475bab167","html_url":"https://github.com/PayRam/payram-scripts","commit_stats":null,"previous_names":["payram/payram-scripts"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/PayRam/payram-scripts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PayRam%2Fpayram-scripts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PayRam%2Fpayram-scripts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PayRam%2Fpayram-scripts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PayRam%2Fpayram-scripts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PayRam","download_url":"https://codeload.github.com/PayRam/payram-scripts/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PayRam%2Fpayram-scripts/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34977672,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-30T02:00:05.919Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-13T10:05:23.184Z","updated_at":"2026-06-30T18:00:42.012Z","avatar_url":"https://github.com/PayRam.png","language":"Shell","funding_links":[],"categories":["Full-Stack Payment Gateways"],"sub_categories":["PayRam"],"readme":"# PayRam Self-Hosted Crypto Payment Gateway\n\nChoose one of two paths:\n\n- **Standard setup** (full install + UI)\n- **Agent setup** (single CLI flow for AI agents automation)\n\n**Agent One-Line Setup** - Copy, paste, and run:\n\n```bash\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/PayRam/payram-scripts/main/setup_payram_agents.sh)\"\n```\n\n🚀 **Standard One-Line Setup** - Copy, paste, and run:\n\n```bash\nbash \u003c(curl -fsSL https://payram.com/setup_payram.sh)\n```\n\nIf you see a permissions error, rerun with:\n\n```bash\nsudo bash -c 'bash \u003c(curl -fsSL https://payram.com/setup_payram.sh)'\n```\n\n💡 **One-Line with Arguments** - Use the same pattern with flags:\n\n```bash\n# Fresh installation (default)\nbash \u003c(curl -fsSL https://payram.com/setup_payram.sh)\n\n# Update existing installation\nsudo bash -c 'bash \u003c(curl -fsSL https://payram.com/setup_payram.sh) --update'\n\n# Complete reset (removes all data)\nsudo bash -c 'bash \u003c(curl -fsSL https://payram.com/setup_payram.sh) --reset'\n\n# Testnet deployment\nsudo bash -c 'bash \u003c(curl -fsSL https://payram.com/setup_payram.sh) --testnet'\n\n# Specific Docker image tag\nsudo bash -c 'bash \u003c(curl -fsSL https://payram.com/setup_payram.sh) --tag=latest'\n\n# Help and usage\nsudo bash -c 'bash \u003c(curl -fsSL https://payram.com/setup_payram.sh) --help'\n```\n\n## 💎 What is PayRam?\n\nPayRam 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.\n\n## ✨ Key Features\n\n- 🏛️ **Universal OS Support**: Ubuntu, Debian, CentOS, RHEL, Fedora, Arch Linux, Alpine, macOS\n- 🐳 **Docker-Based**: Containerized deployment with automatic dependency management\n- 🔐 **Security First**: Keys not stored on server for fund collection, AES-256 encryption, secure credential storage, SSL/TLS support\n- 🌐 **Let's Encrypt Integration**: Automatic SSL certificate management\n- 📊 **PostgreSQL Support**: External database integration with connection validation\n- 🎨 **Enhanced UX**: Beautiful ASCII art banners and guided setup experience\n- ⚡ **Quick Setup**: Complete gateway deployment in minutes\n\n## 🚀 Quick Start\n\n### Option 1: Direct Install (Recommended)\n```bash\nbash \u003c(curl -fsSL https://payram.com/setup_payram.sh)\n```\n\n### Option 2: One-Line with Arguments\n```bash\n# If the script asks for root privileges, rerun with sudo at the beginning\nsudo bash -c 'bash \u003c(curl -fsSL https://payram.com/setup_payram.sh) --update'\n```\n\n### Option 3: Download and Run\n```bash\ncurl -O https://raw.githubusercontent.com/PayRam/payram-scripts/main/setup_payram.sh\nchmod +x setup_payram.sh\nsudo ./setup_payram.sh\n```\n\n### Option 4: Clone Repository\n```bash\ngit clone https://github.com/PayRam/payram-scripts.git\ncd payram-scripts\nsudo ./setup_payram.sh\n```\n\n## 🛠️ Advanced Usage\n\n### Command Line Options\n\n#### Local Script Execution:\n```bash\n# Fresh installation (default)\nsudo ./setup_payram.sh\n\n# Update existing installation\nsudo ./setup_payram.sh --update\n\n# Testnet deployment\nsudo ./setup_payram.sh --testnet\n\n# Specific Docker image tag\nsudo ./setup_payram.sh --tag=latest\n\n# Complete reset (removes all data)\nsudo ./setup_payram.sh --reset\n\n# Help and usage\nsudo ./setup_payram.sh --help\n```\n\n#### One-Line Remote Execution:\n```bash\n# Fresh installation (default)\nbash \u003c(curl -fsSL https://payram.com/setup_payram.sh)\n\n# Update existing installation\nsudo bash -c 'bash \u003c(curl -fsSL https://payram.com/setup_payram.sh) --update'\n\n# Testnet deployment  \nsudo bash -c 'bash \u003c(curl -fsSL https://payram.com/setup_payram.sh) --testnet'\n\n# Specific Docker image tag\nsudo bash -c 'bash \u003c(curl -fsSL https://payram.com/setup_payram.sh) --tag=latest'\n\n# Complete reset (removes all data)\nsudo bash -c 'bash \u003c(curl -fsSL https://payram.com/setup_payram.sh) --reset'\n```\n\n### Environment Variables\n\n```bash\n# Specify Docker image tag\nPAYRAM_TAG=latest sudo ./setup_payram.sh\n\n# Skip interactive prompts (use defaults)\nPAYRAM_AUTO=true sudo ./setup_payram.sh\n```\n\n## 📋 Requirements\n\n### System Requirements\n- **OS**: Ubuntu 18.04+, Debian 9+, CentOS 7+, RHEL 7+, Fedora 30+, Arch Linux, Alpine Linux, macOS 10.14+\n- **RAM**: 2GB minimum, 4GB recommended\n- **Storage**: 5GB minimum, 10GB recommended\n- **Network**: Internet connection for Docker images and dependencies\n\n### Automatic Dependencies\nThe script automatically installs:\n- Docker \u0026 Docker Compose\n- PostgreSQL client tools\n- SSL certificate utilities\n- Required system packages\n\n## 🔧 Configuration\n\n### Database Options\n1. **External PostgreSQL** (Recommended)\n   - Better performance and reliability\n   - Automatic connection testing\n   - Backup and scaling capabilities\n\n2. **Internal Database**\n   - Quick setup for testing\n   - Single container deployment\n\n### SSL Certificate Options\n1. **Let's Encrypt** (Recommended)\n   - Free SSL certificates\n   - Automatic renewal\n   - Domain validation\n\n2. **Custom Certificates**\n   - Bring your own SSL certs\n   - Enterprise CA support\n\n3. **Skip SSL**\n   - For development/testing\n   - Behind load balancer/proxy\n\n## 🔐 Security Features\n\n- **AES-256 Encryption**: Hot wallet and sensitive data protection\n- **Secure Storage**: Configuration files with restricted permissions (600)\n- **Privilege Separation**: Root access only when necessary\n- **Database Security**: Encrypted connection strings and .pgpass files\n- **SSL/TLS**: HTTPS encryption with automatic certificate management\n\n## 📁 File Structure\n\n```\n/home/$USER/.payraminfo/          # Configuration directory\n├── config.env                   # Main configuration file\n├── aes/                         # AES encryption keys\n└── ssl/                         # SSL certificates\n\n/home/$USER/.payram-core/         # Application data\n├── data/                        # Persistent application data\n└── logs/                        # Application logs\n```\n\n## 🚨 Troubleshooting\n\n### Common Issues\n\n**One-Line Command Arguments**: Use process substitution so the interactive menu still works:\n```bash\n# Correct syntax for one-liner with arguments\nsudo bash -c 'bash \u003c(curl -fsSL https://payram.com/setup_payram.sh) --reset'\n\n# Incorrect (won't work)\ncurl -fsSL https://payram.com/setup_payram.sh | bash\n```\n\n**Permission Denied**: Rerun with `sudo` at the beginning\n```bash\nsudo bash -c 'bash \u003c(curl -fsSL https://payram.com/setup_payram.sh)'\n```\n\n**Docker Not Found**: Script will install Docker automatically\n```bash\n# Manual Docker installation check\ndocker --version\n```\n\n**Port Conflicts**: Check if ports 80, 443, 8080, 8443 are available\n```bash\nsudo netstat -tlnp | grep ':80\\|:443\\|:8080\\|:8443'\n```\n\n**SSL Certificate Issues**: Verify domain DNS points to your server\n```bash\ndig +short yourdomain.com\n```\n\n### Log Files\n- **Setup Log**: `/tmp/payram-setup.log`\n- **Application Logs**: `/home/$USER/.payram-core/logs/`\n- **Docker Logs**: `docker logs payram-core`\n\n\n## 🤖 Agent / Headless CLI\n\n\u003e **For AI agents and automated workflows only.** These scripts are currently in testing and are not intended for regular client use.\n\nIf you are an AI agent (or building agent-based integrations), the following scripts provide a headless CLI for PayRam operations:\n\n| Script | Purpose |\n|--------|---------|\n| `setup_payram_agents.sh` | Single agent entrypoint for install and headless operations |\n\n### Quick Start (Agents)\n\n```bash\n# 1. Start PayRam locally (one-step flow)\n./setup_payram_agents.sh\n\n# 2. Sign in or set up\n./setup_payram_agents.sh setup      # first time\n./setup_payram_agents.sh signin     # subsequent times\n\n# 3. Create a payment link\n./setup_payram_agents.sh create-payment-link\n```\n\nFor full agent documentation, see [`docs/PAYRAM_HEADLESS_AGENT.md`](docs/PAYRAM_HEADLESS_AGENT.md).\n\n## 🛍️ Shopify Integration (Optional)\n\nAccept crypto payments directly on your Shopify store. The Shopify connector is an **optional add-on** — install Payram first, then run the Shopify installer separately.\n\n**One-Line Setup:**\n\n```bash\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/PayRam/payram-scripts/main/setup_payram_shopify.sh)\"\n```\n\nThe installer only requires Docker. It handles Shopify CLI authentication, deploys the checkout UI extension, and starts the connector container automatically.\n\n**Reset an existing installation:**\n\n```bash\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/PayRam/payram-scripts/main/setup_payram_shopify.sh)\" --reset\n```\n\nFor the full setup walkthrough, environment variables reference, architecture diagram, and update instructions, see [`docs/PAYRAM_SHOPIFY_CONNECTOR.md`](docs/PAYRAM_SHOPIFY_CONNECTOR.md).\n\n---\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Test on multiple OS distributions\n5. Submit a pull request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🆘 Support\n\n- **GitHub Issues**: [Report bugs and request features](https://github.com/PayRam/payram-scripts/issues)\n- **Documentation**: [Full setup guide](https://docs.payram.com)\n- **Community**: [Discord server](https://discord.gg/payram)\n\n---\n\n**PayRam** - Empowering businesses with decentralized payment infrastructure. No middleman, no fees, complete control. 🚀💎\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPayRam%2Fpayram-scripts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPayRam%2Fpayram-scripts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPayRam%2Fpayram-scripts/lists"}