An open API service indexing awesome lists of open source software.

https://github.com/codestorm-official/ubuntu-on-browser

Deploy any Ubuntu version and access it through your browser! πŸš€πŸŒβœ¨
https://github.com/codestorm-official/ubuntu-on-browser

ubuntu ubuntu-server ubuntu1804 ubuntu2004 ubuntu2204 ubuntu2404

Last synced: 2 days ago
JSON representation

Deploy any Ubuntu version and access it through your browser! πŸš€πŸŒβœ¨

Awesome Lists containing this project

README

          

![Ubuntu](https://img.shields.io/badge/Ubuntu-Latest-E95420?logo=ubuntu)
![Ubuntu](https://img.shields.io/badge/Ubuntu-20.04-E95420?logo=ubuntu)
![Ubuntu](https://img.shields.io/badge/Ubuntu-22.04-E95420?logo=ubuntu)
![Ubuntu](https://img.shields.io/badge/Ubuntu-24.04-E95420?logo=ubuntu)
![Ubuntu](https://img.shields.io/badge/Other-Version-E95420?logo=ubuntu)
![Docker](https://img.shields.io/badge/Railway-Supported-blue?logo=railway)
![Docker](https://img.shields.io/badge/Docker-Supported-blue?logo=docker)

# 🐧 Ubuntu on Browser
**Repository Name:** ubuntu-on-browser

**Template Name:** Ubuntu

[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/ubuntu-1?referralCode=asepsp&utm_medium=integration&utm_source=template&utm_campaign=generic)

## πŸ“– Description
Want to try out Ubuntu or need a lightweight version of Linux available at all times? πŸš€

This project allows you to deploy a fully functional Ubuntu environment in the cloud, accessible directly via your web browser.

This project utilizes the Ubuntu Docker image to deploy a container that supports most CLI tools. It uses [ttyd](https://github.com/tsl0922/ttyd) to provide a seamless, browser-based terminal experience with built-in security.

![Ubuntu Home](./img/ubuntu_home.png)

---

### ✨ Key Features
- 🐧 **Dynamic Ubuntu Base:** Defaults to the `latest` version, but customizable to any version (20.04, 22.04, 24.04).
- πŸ”’ **Secure Access:** Password-protected web terminal via Basic Authentication.
- πŸ’» **Dev-Ready:** Neofetch display on login and pre-installed essential tools.
- 🌐 **Web-Accessible:** Use it from any device with a browserβ€”no SSH client needed.
- πŸ’Ύ **Persistence Ready:** Easily mount Railway Volumes to save your workspace.

---

## πŸ› οΈ Configuration & Variables

### Environment Variables
Configure these in the **Variables** tab of your Railway dashboard. These variables control both the installation version and your login security:

| Variable | Default | Description |
| :----------------- | :------- | :-------------------------------------------------------------------------------- |
| **UBUNTU_VERSION** | `latest` | **(Build)** Set this to `22.04`, `20.04`, etc., to deploy your preferred version. |
| **USERNAME** | `admin` | **(Runtime)** Your custom username to login to the web terminal. |
| **PASSWORD** | `admin` | **(Runtime)** Your secure password to login to the web terminal. |
| **PORT** | `8080` | **(System)** The port assigned by Railway. |

> **⚠️ SECURITY NOTE:** It is strongly advised to set a custom **USERNAME** and **PASSWORD** before deploying to prevent unauthorized access to your cloud terminal.

---

## πŸ“‚ Data Persistence (Recommended)
By default, Railway containers are ephemeral. To save your files permanently:
1. Create a **New Volume** in your Railway project.
2. Mount the volume to your Ubuntu service.
3. Set the **Mount Path** to `/root/workspace`.
4. All files inside this folder will persist even after a re-deploy!

---

## πŸš€ Why Deploy on Railway?
- **Instant Access:** Get a Linux terminal from any device in minutes.
- **Zero Setup:** No local installation, VirtualBox, or VM configuration required.
- **Testing Ground:** Perfect for learning Linux, testing scripts, or running Python automation.
- **Modern Infrastructure:** Automatic HTTPS/SSL and easy resource scaling.

## 🀝 Common Use Cases
- Testing shell scripts and automation workflows.
- Learning Linux command-line basics in a safe sandbox.
- Remote development environment for lightweight coding.
- Package and dependency testing for IT Middleware tasks.

---

## πŸ“¦ Tech Stack & Dependencies
- **Base OS:** Ubuntu (Flexible Versioning)
- **Terminal Engine:** `ttyd` (Shares terminal over HTTP)
- **Pre-installed Tools:** `wget`, `curl`, `git`, `python3`, `python3-pip`, `neofetch`.

---

## πŸ›‘οΈ License
Distributed under the **MIT License**. Copyright (c) 2023-2026 **ASEP SAPUTRA**.