base-vnc/Readme.md
merith-tk 9dd9a8320a
All checks were successful
Build Docker Image on Commit / build-and-publish (push) Successful in 9s
Update Readme.md
2025-06-05 17:20:26 +01:00

1.3 KiB

🧱 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.