gns3/base-vnc
1
0
Fork 0
generated from oci/template
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
12 commits 1 branch 2 tags 37 KiB
Shell 60%
Dockerfile 40%
Find a file
merith-tk 9dd9a8320a
All checks were successful
Build Docker Image on Commit / build-and-publish (push) Successful in 9s
Details
Update Readme.md
2025-06-05 17:20:26 +01:00
.forgejo/workflows Initial commit 2025-06-02 23:24:55 +01:00
Dockerfile enable DHCP on gns3 use 2025-06-05 05:46:45 +00:00
i3.config make it smol. 2025-06-05 05:26:41 +00:00
Readme.md Update Readme.md 2025-06-05 17:20:26 +01:00
vnc.sh enable DHCP on gns3 use 2025-06-05 05:46:45 +00:00

Readme.md

🧱 i3 Base Image for GNS3 (VNC)

Base for: vnc-template
Minimal Alpine-based Docker image with i3 window manager for GNS3 VNC appliances.

🛠 Core Features

  • <50MB Alpine base with i3 window manager
  • Automatic DHCP configuration (udhcpc)
  • Extensible design for lab environments

🏷️ Image Tags

Tag Description
latest Stable release (vX.X.X)
nightly Latest main branch commit
<commit> Immutable build (e.g. 427726ea)

▶️ Usage with vnc-template

  1. Reference this image in your Dockerfile:
FROM git.merith.xyz/gns3/vnc-template
  1. Add custom tools and configs in vnc-template:
RUN apk add firefox wireshark
COPY my-configs /etc/
  1. Auto start programs by adding your own entrypoint
COPY custom-entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh

⚠️ Do not add an ENTRYPOINT line in your Dockerfile.
The base image already defines the required entrypoint for proper operation in GNS3.

See vnc-template repository for full appliance creation guide.