{"id":32667395,"url":"https://github.com/pagcoinbr/robosats-gateway","last_synced_at":"2026-05-02T22:36:46.716Z","repository":{"id":319713328,"uuid":"1079405168","full_name":"pagcoinbr/robosats-gateway","owner":"pagcoinbr","description":"🔒 Self-hosted RoboSats client gateway for private Bitcoin trading. One-command automated installation with Docker, Tor integration, and complete management tools.","archived":false,"fork":false,"pushed_at":"2026-03-16T11:50:53.000Z","size":83,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-02T22:36:36.608Z","etag":null,"topics":["automation","bitcoin","docker","federation","gateway","lightning","privacy","robosats","self-hosted","tor"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pagcoinbr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-10-19T18:32:59.000Z","updated_at":"2026-03-16T11:50:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"bc51d55c-2439-4425-9f1f-d90dd729f939","html_url":"https://github.com/pagcoinbr/robosats-gateway","commit_stats":null,"previous_names":["pagcoinbr/robosats-gateway"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/pagcoinbr/robosats-gateway","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pagcoinbr%2Frobosats-gateway","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pagcoinbr%2Frobosats-gateway/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pagcoinbr%2Frobosats-gateway/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pagcoinbr%2Frobosats-gateway/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pagcoinbr","download_url":"https://codeload.github.com/pagcoinbr/robosats-gateway/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pagcoinbr%2Frobosats-gateway/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32552376,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T22:28:24.418Z","status":"ssl_error","status_checked_at":"2026-05-02T22:28:14.225Z","response_time":132,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["automation","bitcoin","docker","federation","gateway","lightning","privacy","robosats","self-hosted","tor"],"created_at":"2025-11-01T02:01:07.523Z","updated_at":"2026-05-02T22:36:46.711Z","avatar_url":"https://github.com/pagcoinbr.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RoboSats Gateway - Automated Installation\n\n🔒 **Self-hosted RoboSats client gateway for private Bitcoin trading**\n\nA complete automated installation system for setting up your own RoboSats federation gateway. Connect to the RoboSats network through your own private, Tor-enabled gateway without needing to run a Lightning node.\n\n## 🚀 Quick Start\n\n```bash\n# Clone and install\ngit clone https://github.com/pagcoinbr/robosats-gateway.git\ncd robosats-gateway\n./install-robosats-gateway.sh\n```\n\n**That's it!** Your RoboSats gateway will be running on `http://localhost:80`\n\n## ✨ Features\n\n- 🔒 **Privacy via Tor** - All coordinator connections through Tor\n- 🌐 **Federation Access** - Connect to multiple RoboSats coordinators  \n- 🏠 **Self-hosted** - Your own private entrance to RoboSats\n- ⚡ **No Lightning Node Required** - Uses existing coordinators\n- 🐳 **Docker-based** - Easy deployment and management\n- 🛠️ **Management Scripts** - Simple commands for all operations\n- 📚 **Complete Documentation** - Detailed guides and troubleshooting\n\n## 🎯 What This Provides\n\nInstead of using public RoboSats instances, you get:\n- Your own private gateway to the RoboSats federation\n- Enhanced privacy through your own Tor routing\n- Full control over your trading interface\n- No dependence on third-party hosted instances\n- Direct connection to multiple coordinators\n\n## 📋 Requirements\n\n- Linux system (Ubuntu/Debian recommended)\n- Docker and Docker Compose\n- 2GB RAM minimum\n- Internet connection\n- Ports 80, 12596 available\n\n## 🛠️ Installation Options\n\n### Standard Installation\n```bash\n./install-robosats-gateway.sh\n```\n\n### Advanced Options\n```bash\n# Force reinstall (overwrites existing)\n./install-robosats-gateway.sh --force\n\n# Clean existing containers first\n./install-robosats-gateway.sh --cleanup\n\n# Install to custom directory\n./install-robosats-gateway.sh --dir my-custom-gateway\n\n# View all options\n./install-robosats-gateway.sh --help\n```\n\n## 🎮 Management\n\nAfter installation, manage your gateway:\n\n```bash\ncd robosats-gateway\n\n./start.sh    # Start the gateway\n./stop.sh     # Stop the gateway  \n./status.sh   # Check status\n./logs.sh     # View logs\n./logs.sh -f  # Follow logs live\n./update.sh   # Update to latest\n```\n\n## 🌐 Access Points\n\n- **Direct Access**: `http://localhost:12596`\n- **Nginx Proxy**: `http://localhost:80`\n- **Network Access**: `http://[your-ip]:80`\n\n## 🏗️ Architecture\n\n```\nUser ←→ Nginx (Port 80) ←→ RoboSats Client (Port 12596) ←→ Tor ←→ Federation Coordinators\n```\n\nYour gateway acts as a private bridge to the RoboSats federation:\n- **Nginx**: Reverse proxy for clean URLs and SSL termination\n- **RoboSats Client**: Federation client connecting to multiple coordinators\n- **Tor Integration**: All coordinator traffic routed through Tor for privacy\n- **Docker Orchestration**: Containerized services for easy management\n\n## 📁 Generated Structure\n\nThe installer creates a complete, self-contained gateway:\n\n```\nrobosats-gateway/\n├── docker-compose.yml         # Service orchestration\n├── Dockerfile                # Nginx container\n├── nginx/conf/nginx.conf      # Reverse proxy config\n├── robosats-client-data/      # Persistent data\n├── start.sh                  # Start services\n├── stop.sh                   # Stop services\n├── status.sh                 # Health checks\n├── logs.sh                   # Log viewer\n├── update.sh                 # Update services\n└── README.md                 # Detailed documentation\n```\n\n## 🔧 Customization\n\n### SSL/HTTPS Setup\nThe installation includes certbot for SSL certificates:\n\n1. Update `nginx/conf/nginx.conf` with your domain\n2. Run certbot to obtain certificates  \n3. Enable HTTPS in nginx configuration\n\n### Environment Variables\nCustomize the RoboSats client by editing environment variables in `docker-compose.yml`.\n\n### Custom Coordinators\nThe client automatically discovers and connects to federation coordinators. No manual configuration needed.\n\n## 🛟 Troubleshooting\n\n### Services Won't Start\n```bash\n# Check requirements\ndocker --version\ndocker-compose --version\n\n# Check port usage\nsudo netstat -tlnp | grep -E \":(80|12596)\"\n\n# View detailed logs\ncd robosats-gateway \u0026\u0026 ./logs.sh\n```\n\n### Tor Connection Issues\n```bash\n# Check Tor service\nsudo systemctl status tor\n\n# Restart Tor\nsudo systemctl restart tor\n\n# Check Tor ports\nnetstat -tlnp | grep 9050\n```\n\n### Container Issues\n```bash\n# Clean restart\ncd robosats-gateway\n./stop.sh\ndocker system prune -f\n./start.sh\n```\n\n## 🗑️ Uninstallation\n\nComplete removal with one command:\n```bash\n./uninstall-robosats-gateway.sh\n```\n\nOr force removal:\n```bash\n./uninstall-robosats-gateway.sh --force\n```\n\n## 🤝 Contributing\n\nContributions welcome! Please:\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Test the installation process\n5. Submit a pull request\n\n## 📖 Documentation\n\n- **[Installation Guide](INSTALL.md)** - Detailed setup instructions\n- **[Scripts Overview](scripts-menu.sh)** - All available commands\n- **[RoboSats Learn](https://learn.robosats.org)** - Official RoboSats documentation\n\n## 🔐 Security\n\n- All coordinator communications via Tor\n- Self-hosted eliminates third-party dependencies  \n- Regular security updates recommended\n- Keep Docker and system packages updated\n\n## 📞 Support\n\n- **Issues**: [GitHub Issues](../../issues)\n- **RoboSats Community**: [Telegram](https://t.me/robosats)\n- **Documentation**: [learn.robosats.org](https://learn.robosats.org)\n\n## 📄 License\n\nThis project is licensed under the same terms as RoboSats - check the [LICENSE](LICENSE) file for details.\n\n## ⚡ Quick Commands Reference\n\n```bash\n# Installation\ngit clone https://github.com/pagcoinbr/robosats-gateway.git\ncd robosats-gateway\n./install-robosats-gateway.sh\n\n# Management  \ncd robosats-gateway\n./start.sh \u0026\u0026 ./status.sh\n\n# Monitoring\n./logs.sh -f\n\n# Updates\n./update.sh\n\n# Removal\n./uninstall-robosats-gateway.sh\n```\n\n---\n\n**Ready to start private Bitcoin trading with your own RoboSats gateway? Clone and run the installer now!**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpagcoinbr%2Frobosats-gateway","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpagcoinbr%2Frobosats-gateway","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpagcoinbr%2Frobosats-gateway/lists"}