https://github.com/linuztx/proot-server
Proot Server is a script designed to install and run a Linux base system (Ubuntu, Alpine, Fedora or Debian) on servers or environments where root access is not available.
https://github.com/linuztx/proot-server
bash linux proot server serverless sudo terminal
Last synced: 10 months ago
JSON representation
Proot Server is a script designed to install and run a Linux base system (Ubuntu, Alpine, Fedora or Debian) on servers or environments where root access is not available.
- Host: GitHub
- URL: https://github.com/linuztx/proot-server
- Owner: linuztx
- License: other
- Created: 2024-05-29T16:14:48.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-13T02:25:34.000Z (over 1 year ago)
- Last Synced: 2025-04-03T00:24:36.074Z (10 months ago)
- Topics: bash, linux, proot, server, serverless, sudo, terminal
- Language: Shell
- Homepage:
- Size: 36.1 KB
- Stars: 4
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Proot Server: Linux Server Installer Pro
[](https://github.com/linuztx/proot-server/blob/main/LICENSE)
## Overview
Proot Server is a powerful shell script that enables you to install and run various Linux distributions (Ubuntu, Alpine, Debian, or Fedora) in a proot environment. This tool is particularly useful for setting up Linux environments on systems where you don't have root access or in situations where you need isolated Linux instances.
## Features
- **Multiple Distribution Support**: Choose from Ubuntu 20.04 Focal Fossa, Alpine 3.19, Debian 12 Bookworm, or Fedora 40.
- **Architecture Compatibility**: Supports x86_64 (amd64) and aarch64 (arm64) architectures.
- **Proot Integration**: Utilizes proot for creating a chroot-like environment without requiring root privileges.
- **Persistent Installation**: Installed distributions can be reused in subsequent runs.
- **Automatic Dependency Handling**: Downloads and sets up proot if not already installed.
- **DNS Configuration**: Automatically sets up DNS resolution using Cloudflare's DNS servers.
## Prerequisites
- `curl`: For downloading distribution files and proot.
- `tar`: For extracting downloaded files.
- Internet connection for downloading necessary files.
## Usage
1. **Clone the Repository**:
```
git clone https://github.com/linuztx/proot-server.git
cd proot-server
```
2. **Run the Script**:
```
./run.sh
```
3. **Choose a Distribution**:
- Select from options 1-4 to install a new distribution.
- Choose option 5 to use an already installed distribution.
4. **Installation Process**:
- The script will download the selected distribution's rootfs.
- It will extract the files and set up the environment.
5. **Proot Setup**:
- If not present, the script will download and configure proot.
6. **Entering the Environment**:
- After setup, you'll be automatically entered into the proot environment.
- Use `su` to switch to root user within the environment.
7. **Exiting the Environment**:
- Type `exit` twice to fully exit the proot environment.
## Supported Distributions and Versions
- Ubuntu 20.04 Focal Fossa
- Alpine 3.19
- Debian 12 Bookworm
- Fedora 40
## Directory Structure
The script creates directories for each installed distribution:
- `./ubuntu` for Ubuntu
- `./alpine` for Alpine
- `./debian` for Debian
- `./fedora` for Fedora
## Network Configuration
The script automatically sets up `/etc/resolv.conf` with Cloudflare's DNS servers (1.1.1.1 and 1.0.0.1).
## Limitations
- While proot provides a chroot-like environment, it does not offer full system isolation.
- Some operations requiring true root access may not function as expected.
## Troubleshooting
- If downloads fail, the script will retry up to 10 times with a 1-second delay between attempts.
- Ensure you have a stable internet connection for successful downloads.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.