Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/amhoba2014/alpine-fluxbox-novnc
A lightweight Alpine-based Docker container with VNC and noVNC, featuring Fluxbox for a simple Linux desktop environment.
https://github.com/amhoba2014/alpine-fluxbox-novnc
alpine docker fluxbox lightweight linux-desktop novnc remote-access vnc web-based-vnc x11vnc
Last synced: 27 days ago
JSON representation
A lightweight Alpine-based Docker container with VNC and noVNC, featuring Fluxbox for a simple Linux desktop environment.
- Host: GitHub
- URL: https://github.com/amhoba2014/alpine-fluxbox-novnc
- Owner: amhoba2014
- License: mit
- Created: 2024-12-21T17:57:44.000Z (28 days ago)
- Default Branch: main
- Last Pushed: 2024-12-21T18:36:11.000Z (27 days ago)
- Last Synced: 2024-12-21T18:36:38.745Z (27 days ago)
- Topics: alpine, docker, fluxbox, lightweight, linux-desktop, novnc, remote-access, vnc, web-based-vnc, x11vnc
- Language: Dockerfile
- Homepage:
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Alpine Fluxbox NoVNC
## Lightweight Alpine-based Docker Container with VNC and noVNC
This project provides a lightweight Docker container based on Alpine Linux, featuring a VNC server accessible on port `5900` and an HTML5-based noVNC client available on port `6900`. It uses the Fluxbox desktop environment for simplicity and efficiency, making it ideal for deploying a Linux sandbox quickly.
The base image size is approximately **1GB**.
---
## Features
- **Fluxbox**: Lightweight window manager.
- **Xvfb**: Virtual framebuffer for graphical applications.
- **x11vnc**: VNC server.
- **noVNC**: Web-based VNC client.
---
## How To Just Run
Just run the following commands to start using it right away (or move on to the next step to build it yourself):
```bash
docker pull ghcr.io/amhoba2014/alpine-fluxbox-novnc ;
docker run -d -p 5900:5900 -p 6900:6900 ghcr.io/amhoba2014/alpine-fluxbox-novnc:latest ;
```
## How to Use
### 1. Build the Docker Image
Run the following command to build the image from the Dockerfile:
```bash
docker build . -t alpine-fluxbox-novnc:latest
```
### 2. Run the Docker Container
#### Basic Usage
To expose the VNC service on port `5900` and noVNC on port `6900`:
```bash
docker run -d -p 5900:5900 -p 6900:6900 alpine-fluxbox-novnc:latest
```
#### With VNC Password
To secure the VNC connection with a password:
```bash
docker run -d -p 5900:5900 -p 6900:6900 -e VNC_PASSWORD="your_password" alpine-fluxbox-novnc:latest
```
### 3. Access the VNC Desktop
- **Using a VNC Client**:
Connect to `localhost:5900` using any VNC viewer.
- **Using noVNC**:
Open a web browser and navigate to `http://localhost:6900` to access the desktop through the noVNC client.
---
## Extending the Image
You can add additional packages by modifying the `Dockerfile`:
```Dockerfile
RUN apk add --no-cache
```
After editing the Dockerfile, rebuild the Docker image:
```bash
docker build . -t alpine-fluxbox-novnc:latest
```
---
## License
This project is released under the MIT License. See the LICENSE file for details.
---
## Contributions
Contributions are welcome! Feel free to submit issues or pull requests to improve this project.