   _____ _                 _ _           _     
  / ____| |               | | |         | |    
 | |    | | ___  _   _  __| | |     __ _| |__  
 | |    | |/ _ \| | | |/ _` | |    / _` | '_ \ 
 | |____| | (_) | |_| | (_| | |___| (_| | |_) |
  \_____|_|\___/ \__,_|\__,_|______\__,_|_.__/

Self-hosted Web Development
Environment

Turn any computer into a remote development environment with Jupyter Lab, VS Code Server, SSH Terminal, Web Dashboard, and Cloudflare Tunnels

By Sakib Dalal Go 1.21+ MIT License v1.2.0

NEW in v1.2.0 📊 Web Dashboard - Manage everything from your browser

Get Started View on GitHub

Quick Install

git clone https://github.com/Sakib-Dalal/cloudlab.git && cd cloudlab && ./build.sh

✨ Features

Everything you need for remote development in one powerful CLI tool

Jupyter Lab & Notebook

Full Python notebook environment for data science and development

VS Code Server

Browser-based code editor with full extension support

SSH Terminal

Web-based terminal access via ttyd - no SSH client needed

NEW

Web Dashboard

Manage all services, view URLs, and control everything from browser

Cloudflare Tunnels

Free public URLs - no Cloudflare account required!

Email Notifications

Receive all tunnel URLs automatically via email

Kernel Management

Add/remove Jupyter kernels with different Python versions

Environment Management

Create and manage Python virtual environments easily

MPS/CUDA Support

GPU acceleration for Apple Silicon and NVIDIA cards

🆕 What's New in v1.2.0

Major update with Web Dashboard

📊 Web Dashboard

Manage everything from your browser! No more command line needed for basic operations.

Service Control - Start/stop with one click

Status Overview - See all services at once

Copy URLs - Quick access to tunnel URLs

Credentials - View passwords instantly

# Start the dashboard
cloudlab start dashboard

# Access at http://localhost:3000

# Or start everything including dashboard
cloudlab start all

SSH Terminal (v1.1.0)

Browser-based terminal via ttyd with Cloudflare tunnel support

Email Notifications

All 4 service URLs now included in email notifications

NEW in v1.2.0

📊 Web Dashboard

Manage everything from your browser at http://localhost:3000

CloudLab Dashboard

Jupyter

Port 8888

https://xyz.trycloudflare.com

VS Code

Port 8080

https://abc.trycloudflare.com

SSH

Port 7681

https://def.trycloudflare.com

Dashboard

Port 3000

https://ghi.trycloudflare.com

Service Control

Start, stop, and restart any service with a single click

Quick Copy URLs

Copy tunnel URLs to clipboard instantly

View Credentials

See all passwords and access credentials

Dashboard Commands

Command	Description
`cloudlab start dashboard`	Start web dashboard
`cloudlab stop dashboard`	Stop dashboard
`cloudlab dashboard start`	Start dashboard (alternative)
`cloudlab dashboard stop`	Stop dashboard (alternative)
`cloudlab dashboard status`	Show dashboard status
`cloudlab logs dashboard`	View dashboard logs

🖥️ Screenshots

📋 Prerequisites

Install Go on your system before getting started

macOS

Terminal

brew install go

Linux (Ubuntu/Debian)

Terminal

                                
sudo rm -rf /usr/local/go

Terminal

                                
wget https://go.dev/dl/go1.21.5.linux-amd64.tar.gz

Terminal

                                
sudo tar -C /usr/local -xzf go1.21.5.linux-amd64.tar.gz

Terminal

                                
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc

Terminal

                                
source ~/.bashrc

Windows (beta)

PowerShell (Admin)

winget install GoLang.Go

🚀 Quick Start

Get up and running in minutes

Clone the repository

Terminal

git clone https://github.com/Sakib-Dalal/cloudlab.git
cd cloudlab

Build the CLI

Terminal

chmod +x build.sh
./build.sh

Initialize (interactive setup)

Terminal

cloudlab init

Install all components

Terminal

cloudlab install all

Start everything

Terminal

cloudlab start all

This starts Jupyter, VS Code, SSH Terminal, Dashboard, and all tunnels!

Check status

Terminal

cloudlab status

📖 Commands Reference

Complete list of all available commands

Service Commands

Command	Description
`cloudlab start all`	Start all services + tunnels
`cloudlab start jupyter`	Start Jupyter Lab
`cloudlab start notebook`	Start Jupyter Notebook
`cloudlab start vscode`	Start VS Code Server
`cloudlab start ssh`	Start SSH Terminal
`cloudlab start dashboard`	Start Web Dashboard NEW
`cloudlab stop all`	Stop all services
`cloudlab restart all`	Restart all services
`cloudlab status`	Show status and URLs
`cloudlab logs <service>`	View service logs

Tunnel Commands

Command	Description
`cloudlab tunnel start`	Start all tunnels, get public URLs
`cloudlab tunnel stop`	Stop all tunnels
`cloudlab tunnel restart`	Get new URLs
`cloudlab tunnel status`	Show current URLs

SSH Terminal Commands

Command	Description
`cloudlab ssh start`	Start SSH terminal
`cloudlab ssh stop`	Stop SSH terminal
`cloudlab ssh config`	Configure SSH settings
`cloudlab ssh status`	Show SSH status

Email Commands

Command	Description
`cloudlab email setup`	Configure email (Gmail, Outlook, etc.)
`cloudlab email test`	Send test email
`cloudlab email send`	Send all tunnel URLs via email

Kernel Commands

Command	Description
`cloudlab kernel list`	List Jupyter kernels
`cloudlab kernel add <name> <version>`	Add kernel with Python version
`cloudlab kernel remove <name>`	Remove kernel

Environment Commands

Command	Description
`cloudlab env list`	List Python environments
`cloudlab env create <name> <version>`	Create new environment
`cloudlab env remove <name>`	Remove environment
`cloudlab env install <package>`	Install package

Configuration Commands

Command	Description
`cloudlab config`	Show current configuration
`cloudlab config set <key> <value>`	Set configuration value
`cloudlab config reset`	Reset to defaults

⚙️ Configuration Options

Customize CloudLab to your needs

All Settings

Key	Description	Default
`jupyter_port`	Jupyter port	8888
`vscode_port`	VS Code port	8080
`ssh_port`	SSH Terminal port	7681
`dashboard_port`	Dashboard port NEW	3000
`jupyter_mode`	`lab` or `notebook`	lab
`python_version`	Python version	3.11
`working_directory`	Project directory	~
`jupyter_password`	Jupyter password	Auto-generated
`vscode_password`	VS Code password	Auto-generated
`ssh_user`	SSH username	Current user
`email_address`	Notification email	-

Configuration Examples

# Change Jupyter mode

cloudlab config set jupyter_mode notebook

# Change working directory

cloudlab config set working_directory /path/to/projects

# Change dashboard port

cloudlab config set dashboard_port 4000

# Change SSH port

cloudlab config set ssh_port 7777

🏗️ Architecture

How CloudLab components work together

🌐 Tunnel URLs

After starting tunnels, you'll get four public URLs:

Jupyter

:8888

VS Code

:8080

SSH

:7681

Dashboard

:3000

📧 Email Setup

Configure email notifications to receive all tunnel URLs

Gmail

1 Go to myaccount.google.com/apppasswords
2 Create an App Password for "Mail"
3 Use this password with cloudlab email setup

Outlook / Hotmail

1 Go to account.microsoft.com/security
2 Enable Two-Factor Authentication
3 Create an App Password

📬 Email Contents

When you run cloudlab email send, you'll receive:

Jupyter URL

VS Code URL

SSH URL

Dashboard URL

📁 File Locations

Where CloudLab stores its data

~/.cloudlab/
├── config.json          # Configuration
├── venv/                # Main Python environment
├── envs/                # Additional environments
│   └── <name>/          # Named environments
├── logs/
│   ├── jupyter.log
│   ├── vscode.log
│   ├── ssh.log
│   ├── dashboard.log    # Dashboard logs (NEW!)
│   └── tunnel_*.log
├── pids/
│   ├── jupyter.pid
│   ├── vscode.pid
│   ├── ssh.pid
│   ├── dashboard.pid    # Dashboard PID (NEW!)
│   └── tunnel_*.pid
├── vscode-data/         # VS Code user data
├── dashboard.html       # Web dashboard (NEW!)
└── server.py            # Dashboard server (NEW!)

🔧 Troubleshooting

Common issues and solutions

# Check logs
cloudlab logs jupyter
cloudlab logs vscode
cloudlab logs ssh

# Reinstall
cloudlab install jupyter
cloudlab install vscode
cloudlab install ssh

# Restart tunnels
cloudlab tunnel restart

# Check tunnel logs
cloudlab logs tunnel_jupyter
cloudlab logs tunnel_vscode
cloudlab logs tunnel_ssh
cloudlab logs tunnel_dashboard

# Test email config
cloudlab email test

# Re-setup email
cloudlab email setup

cloudlab stop all
cloudlab config reset
cloudlab init

🌐 How Tunnels Work

CloudLab uses Cloudflare Quick Tunnels (TryCloudflare)

Benefits

No Cloudflare account required
Creates temporary public URLs
Free to use
Secure HTTPS connections
All 4 services get their own tunnel

Note

URLs change when you restart tunnels
URLs are random like: random-words.trycloudflare.com

# To get new URLs:

cloudlab tunnel restart
cloudlab email send  # Send new URLs to your email

Self-hosted Web Development Environment

✨ Features

Jupyter Lab & Notebook

VS Code Server

SSH Terminal

Web Dashboard

Cloudflare Tunnels

Email Notifications

Kernel Management

Environment Management

MPS/CUDA Support

🆕 What's New in v1.2.0

📊 Web Dashboard

SSH Terminal (v1.1.0)

Email Notifications

📊 Web Dashboard

Service Control

Quick Copy URLs

View Credentials

Dashboard Commands

🖥️ Screenshots

📋 Prerequisites

macOS

Linux (Ubuntu/Debian)

Windows (beta)

🚀 Quick Start

Clone the repository

Build the CLI

Initialize (interactive setup)

Install all components

Start everything

Check status

📖 Commands Reference

Service Commands

Tunnel Commands

SSH Terminal Commands

Email Commands

Kernel Commands

Environment Commands

Configuration Commands

⚙️ Configuration Options

All Settings

Configuration Examples

🏗️ Architecture

🌐 Tunnel URLs

📧 Email Setup

Gmail

Outlook / Hotmail

📬 Email Contents

📁 File Locations

🔧 Troubleshooting

🌐 How Tunnels Work

Benefits

Note

Self-hosted Web Development
Environment