Ecode2254/replit-alternative

1# 🚀 Replit Alternative — Free Self-Hosted Coding Environment2 3> A fully free, self-hosted coding platform combining the best features from **Replit**, **Gitpod**, **GitHub Codespaces**, and more. Run your own cloud IDE with AI assistance, instant deployments, and collaborative features.4 5---6 7## ✨ Features8 9| Feature | What You Get |10|---------|-------------|11| 🖥️ **Browser IDE** | Full VS Code in your browser (code-server) |12| 🤖 **AI Coding Assistant** | Local LLM-powered autocomplete & chat (Continue.dev + Ollama) |13| 🚀 **One-Click Deploy** | Self-hosted PaaS for instant deployments (Coolify) |14| 📦 **Instant Environments** | Pre-configured devcontainers for Python, Node, Go, Rust, Java |15| 🔒 **Auto SSL** | Automatic HTTPS with Let's Encrypt (Traefik) |16| 📁 **File Manager** | Web-based file browser |17| 📊 **Monitoring** | Uptime monitoring for all your services |18| 🐳 **Docker Management** | Visual Docker container management (Portainer) |19| 💰 **100% Free** | Zero subscription fees, runs on your hardware |20 21---22 23## 🏗️ Architecture24 25```26┌─────────────────────────────────────────────────────────────┐27│                    YOUR SERVER / VPS                         │28├─────────────────────────────────────────────────────────────┤29│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────┐  │30│  │   Traefik    │  │   Coolify    │  │   code-server    │  │31│  │  (SSL/Proxy) │  │  (PaaS)      │  │  (VS Code)       │  │32│  └──────────────┘  └──────────────┘  └──────────────────┘  │33│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────┐  │34│  │   Ollama     │  │  Filebrowser │  │   Uptime Kuma    │  │35│  │  (Local LLM) │  │  (Files)     │  │   (Monitoring)   │  │36│  └──────────────┘  └──────────────┘  └──────────────────┘  │37└─────────────────────────────────────────────────────────────┘38```39 40---41 42## 🚀 Quick Start43 44### Option 1: One-Command Install (Recommended)45 46```bash47curl -fsSL https://raw.githubusercontent.com/yourusername/replit-alternative/main/install.sh | bash48```49 50### Option 2: Manual Install51 52```bash53# 1. Clone the repo54git clone https://github.com/yourusername/replit-alternative.git55cd replit-alternative56 57# 2. Configure environment58cp .env.example .env59# Edit .env with your domain and passwords60 61# 3. Start everything62make install63```64 65---66 67## 📋 Requirements68 69- **Server**: Any Linux machine (VPS, old PC, Raspberry Pi)70  - Minimum: 2 CPU, 4GB RAM71  - Recommended: 4 CPU, 8GB+ RAM (for AI models)72- **OS**: Ubuntu 20.04+, Debian 11+, or any Docker-capable Linux73- **Domain**: Optional (use `*.localhost` for local testing)74- **Docker**: Will be auto-installed if missing75 76### Free VPS Options77- [Oracle Cloud Free Tier](https://www.oracle.com/cloud/free/) — 2x AMD instances forever free78- [Hetzner CX21](https://www.hetzner.com/cloud/) — €4.51/mo (very cheap)79- [GitHub Codespaces](https://github.com/codespaces) — Free tier available80- Your old laptop/PC at home81 82---83 84## 🎮 Usage85 86### Start/Stop Services87 88```bash89make start      # Start all services90make stop       # Stop all services91make restart    # Restart all services92make status     # Check service status93make logs       # View all logs94```95 96### Access Your Services97 98| Service | Local URL | With Domain |99|---------|-----------|-------------|100| VS Code IDE | http://localhost:8443 | https://code.yourdomain.com |101| Coolify Deploy | http://localhost:8000 | https://deploy.yourdomain.com |102| File Manager | http://localhost:8080 | https://files.yourdomain.com |103| Monitoring | http://localhost:3001 | https://status.yourdomain.com |104| Docker UI | http://localhost:9000 | https://docker.yourdomain.com |105| Ollama API | http://localhost:11434 | — |106 107### AI Coding Assistant Setup108 1091. Open VS Code at `http://localhost:8443`1102. Install the **Continue** extension from the marketplace1113. It will automatically connect to your local Ollama instance1124. Start coding with AI autocomplete and chat!113 114### Pull AI Models115 116```bash117make pull-models118# Or manually:119docker compose exec ollama ollama pull codellama:7b-code120docker compose exec ollama ollama pull qwen2.5-coder:7b121```122 123### Using Devcontainers124 125Pre-configured environments for:126- 🐍 **Python** — Python 3.11 + Jupyter + Black127- 🟢 **Node.js** — Node 20 + TypeScript + Prettier128- 🔵 **Go** — Go 1.21 + gopls129- 🦀 **Rust** — Rust + rust-analyzer130- ☕ **Java** — Java 21 + Maven + Gradle131- 🌐 **Full-Stack** — Node + Python + PostgreSQL132 133Use them in VS Code: `Ctrl+Shift+P` → `Dev Containers: Open Folder in Container`134 135---136 137## ⚙️ Configuration138 139### Environment Variables (`.env`)140 141| Variable | Description | Default |142|----------|-------------|---------|143| `CODE_DOMAIN` | Domain for VS Code IDE | `code.localhost` |144| `DEPLOY_DOMAIN` | Domain for Coolify | `deploy.localhost` |145| `CODE_SERVER_PASSWORD` | Password for VS Code | Auto-generated |146| `CODE_SERVER_SUDO_PASSWORD` | Sudo password | Auto-generated |147| `ACME_EMAIL` | Email for SSL certs | `admin@localhost` |148 149### Custom Domains150 1511. Point DNS A records to your server IP:152   - `code.yourdomain.com` → Your Server IP153   - `deploy.yourdomain.com` → Your Server IP154   - `files.yourdomain.com` → Your Server IP155 1562. Update `.env` with your domains157 1583. Restart: `make restart`159 160Traefik will automatically obtain SSL certificates via Let's Encrypt.161 162---163 164## 🔒 Security165 166- All services behind Traefik reverse proxy with auto-SSL167- Code-server password protected168- Coolify has its own authentication169- Ollama only accessible internally (not exposed publicly)170- Filebrowser requires login171 172**⚠️ Important**: Change default passwords in `.env` before exposing to the internet!173 174---175 176## 🛠️ Advanced177 178### Add Daytona (Dev Environment Manager)179 180```bash181# Install Daytona CLI182curl -fsSL https://get.daytona.io | bash183 184# Create workspace from any Git repo185daytona create https://github.com/your/project186```187 188### GPU Support (NVIDIA)189 190Uncomment the `deploy` section in `docker-compose.yml` for the `ollama` service:191 192```yaml193deploy:194  resources:195    reservations:196      devices:197        - driver: nvidia198          count: 1199          capabilities: [gpu]200```201 202### Backup & Restore203 204```bash205make backup     # Create backup206# Restore from backup:207docker run --rm -v replit-alternative_code-server-data:/data -v $(pwd)/backups:/backup alpine sh -c "cd /data && tar xzf /backup/replit-backup-XXXX.tar.gz"208```209 210---211 212## 📁 Project Structure213 214```215replit-alternative/216├── docker-compose.yml      # Main orchestration217├── .env.example            # Configuration template218├── install.sh              # One-command installer219├── Makefile                # Quick commands220├── README.md               # This file221├── continue-config/         # AI assistant settings222│   └── config.json223├── devcontainers/           # Pre-built environments224│   ├── python/225│   ├── nodejs/226│   ├── go/227│   ├── rust/228│   ├── java/229│   └── fullstack/230└── filebrowser.json        # File manager config231```232 233---234 235## 🤝 Contributing236 237Contributions welcome! Areas to improve:238- More devcontainer templates239- Better documentation240- Additional integrations241- Performance optimizations242 243---244 245## 📜 License246 247MIT License — use it, modify it, sell it, whatever. It's yours.248 249---250 251## 🙏 Credits252 253Built with amazing open-source projects:254- [code-server](https://github.com/coder/code-server) — VS Code in browser255- [Coolify](https://coolify.io/) — Self-hosted PaaS256- [Ollama](https://ollama.com/) — Local LLMs257- [Continue.dev](https://www.continue.dev/) — AI coding assistant258- [Traefik](https://traefik.io/) — Reverse proxy & SSL259- [Daytona](https://www.daytona.io/) — Dev environment manager260 261---262 263**Enjoy your free, self-hosted coding environment!** 🎉