Ecode2254/replit-alternative

🚀 Replit Alternative — Free Self-Hosted Coding Environment

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.

✨ Features

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                    YOUR SERVER / VPS                         │
├─────────────────────────────────────────────────────────────┤
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────┐  │
│  │   Traefik    │  │   Coolify    │  │   code-server    │  │
│  │  (SSL/Proxy) │  │  (PaaS)      │  │  (VS Code)       │  │
│  └──────────────┘  └──────────────┘  └──────────────────┘  │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────┐  │
│  │   Ollama     │  │  Filebrowser │  │   Uptime Kuma    │  │
│  │  (Local LLM) │  │  (Files)     │  │   (Monitoring)   │  │
│  └──────────────┘  └──────────────┘  └──────────────────┘  │
└─────────────────────────────────────────────────────────────┘

🚀 Quick Start

Option 1: One-Command Install (Recommended)

curl -fsSL https://raw.githubusercontent.com/yourusername/replit-alternative/main/install.sh | bash

Option 2: Manual Install

# 1. Clone the repo
git clone https://github.com/yourusername/replit-alternative.git
cd replit-alternative

# 2. Configure environment
cp .env.example .env
# Edit .env with your domain and passwords

# 3. Start everything
make install

📋 Requirements

• —Server: Any Linux machine (VPS, old PC, Raspberry Pi)
• —Minimum: 2 CPU, 4GB RAM
• —Recommended: 4 CPU, 8GB+ RAM (for AI models)
• —OS: Ubuntu 20.04+, Debian 11+, or any Docker-capable Linux
• —Domain: Optional (use *.localhost for local testing)
• —Docker: Will be auto-installed if missing

Free VPS Options

• —Oracle Cloud Free Tier — 2x AMD instances forever free
• —Hetzner CX21 — €4.51/mo (very cheap)
• —GitHub Codespaces — Free tier available
• —Your old laptop/PC at home

🎮 Usage

Start/Stop Services

make start      # Start all services
make stop       # Stop all services
make restart    # Restart all services
make status     # Check service status
make logs       # View all logs

Access Your Services

AI Coding Assistant Setup

1. 1.Open VS Code at http://localhost:8443
2. 2.Install the Continue extension from the marketplace
3. 3.It will automatically connect to your local Ollama instance
4. 4.Start coding with AI autocomplete and chat!

Pull AI Models

make pull-models
# Or manually:
docker compose exec ollama ollama pull codellama:7b-code
docker compose exec ollama ollama pull qwen2.5-coder:7b

Using Devcontainers

Pre-configured environments for:

• —🐍 Python — Python 3.11 + Jupyter + Black
• —🟢 Node.js — Node 20 + TypeScript + Prettier
• —🔵 Go — Go 1.21 + gopls
• —🦀 Rust — Rust + rust-analyzer
• —☕ Java — Java 21 + Maven + Gradle
• —🌐 Full-Stack — Node + Python + PostgreSQL

Use them in VS Code: Ctrl+Shift+P → Dev Containers: Open Folder in Container

⚙️ Configuration

Environment Variables (.env)

Custom Domains

1. 1.Point DNS A records to your server IP:
2. 2.code.yourdomain.com → Your Server IP
3. 3.deploy.yourdomain.com → Your Server IP
4. 4.files.yourdomain.com → Your Server IP

1. 1.Update .env with your domains

1. 1.Restart: make restart

Traefik will automatically obtain SSL certificates via Let's Encrypt.

🔒 Security

• —All services behind Traefik reverse proxy with auto-SSL
• —Code-server password protected
• —Coolify has its own authentication
• —Ollama only accessible internally (not exposed publicly)
• —Filebrowser requires login

⚠️ Important: Change default passwords in .env before exposing to the internet!

🛠️ Advanced

Add Daytona (Dev Environment Manager)

# Install Daytona CLI
curl -fsSL https://get.daytona.io | bash

# Create workspace from any Git repo
daytona create https://github.com/your/project

GPU Support (NVIDIA)

Uncomment the deploy section in docker-compose.yml for the ollama service:

deploy:
  resources:
    reservations:
      devices:
        - driver: nvidia
          count: 1
          capabilities: [gpu]

Backup & Restore

make backup     # Create backup
# Restore from backup:
docker 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"

📁 Project Structure

replit-alternative/
├── docker-compose.yml      # Main orchestration
├── .env.example            # Configuration template
├── install.sh              # One-command installer
├── Makefile                # Quick commands
├── README.md               # This file
├── continue-config/         # AI assistant settings
│   └── config.json
├── devcontainers/           # Pre-built environments
│   ├── python/
│   ├── nodejs/
│   ├── go/
│   ├── rust/
│   ├── java/
│   └── fullstack/
└── filebrowser.json        # File manager config

🤝 Contributing

Contributions welcome! Areas to improve:

• —More devcontainer templates
• —Better documentation
• —Additional integrations
• —Performance optimizations

📜 License

MIT License — use it, modify it, sell it, whatever. It's yours.

🙏 Credits

Built with amazing open-source projects:

• —code-server — VS Code in browser
• —Coolify — Self-hosted PaaS
• —Ollama — Local LLMs
• —Continue.dev — AI coding assistant
• —Traefik — Reverse proxy & SSL
• —Daytona — Dev environment manager

Enjoy your free, self-hosted coding environment! 🎉