refactor: consolidated updates 2026-01-12

Author: ahze

.github/workflows/build.yml .github/workflows/build.yaml.github/workflows/build.yml renamed to .github/workflows/build.yaml

@@ -14,6 +14,7 @@ LABEL org.opencontainers.image.title="base" \
     org.opencontainers.image.vendor="daemonless" \
     org.opencontainers.image.authors="daemonless" \
     io.daemonless.type="base" \
+    io.daemonless.category="Base" \
     io.daemonless.packages="${PACKAGES}"
 
 ENV ASSUME_ALWAYS_YES=yes

.woodpecker.yml .woodpecker.yaml.woodpecker.yml renamed to .woodpecker.yaml

@@ -1,54 +1,64 @@
-# base-image
+# Base
 
-The core base image for all native FreeBSD OCI containers in the Daemonless project.
+FreeBSD base image with s6 supervision.
 
-## Overview
+| | |
+|---|---|
+| **Registry** | `ghcr.io/daemonless/base` |
+| **Source** | [https://github.com/freebsd/freebsd-src](https://github.com/freebsd/freebsd-src) |
+| **Website** | [https://www.freebsd.org/](https://www.freebsd.org/) |
 
-This image provides a minimal FreeBSD environment optimized for containers. It includes a custom initialization system based on **s6** to manage process lifecycle and environment configuration.
+## Deployment
 
-## Features
+### Podman Compose
 
-- **s6 Supervision**: Standardized process management and reaping.
-- **PUID/PGID Support**: Map the internal `bsd` user to your host user IDs for seamless volume permissions.
-- **VNET Ready**: Configured to work with Virtual Network stacks.
-- **Multiple OS Support**: Variants available for FreeBSD 14 and 15.
-- **Package Selection**: Supports both `latest` and `quarterly` FreeBSD package branches.
+```yaml
+services:
+  base:
+    image: ghcr.io/daemonless/base:latest
+    container_name: base
+    environment:
+    volumes:
+    ports:
+    restart: unless-stopped
+```
 
-## Environment Variables
+### Podman CLI
 
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `PUID` | 1000 | User ID for the `bsd` user. |
-| `PGID` | 1000 | Group ID for the `bsd` user. |
-| `TZ` | UTC | Container timezone. |
+```bash
+podman run -d --name base \
+  ghcr.io/daemonless/base:latest
+```
 
-## Usage (for Image Developers)
+### Ansible
 
-Use this as the base for your own FreeBSD images:
+```yaml
+- name: Deploy base
+  containers.podman.podman_container:
+    name: base
+    image: ghcr.io/daemonless/base:latest
+    state: started
+    restart_policy: always
+```
 
-```dockerfile
-FROM ghcr.io/daemonless/base-image:15
+## Configuration
 
-# Install your app
-RUN pkg install -y myapp
+### Environment Variables
 
-# Add your init scripts
-COPY root/ /
+| Variable | Default | Description |
+|----------|---------|-------------|
 
-# Enable your service
-RUN ln -sf /etc/services.d/myapp/run /run/s6/services/myapp/run
-```
+### Volumes
+
+| Path | Description |
+|------|-------------|
 
-## Directory Structure
+### Ports
 
-- `/init`: The main entrypoint script.
-- `/etc/cont-init.d/`: Place initialization scripts here (executed once at startup).
-- `/etc/services.d/`: Place service definitions here (supervised by s6).
-- `/custom-cont-init.d/`: Mount a volume here to run your own startup scripts without rebuilding the image.
+| Port | Protocol | Description |
+|------|----------|-------------|
 
-## Variants
+## Notes
 
-- `ghcr.io/daemonless/base-image:15` (FreeBSD 15.x)
-- `ghcr.io/daemonless/base-image:14` (FreeBSD 14.x)
-- Suffix `-quarterly` for images using the stable quarterly package branch.
-<!-- Trigger build -->
+- **User:** `root` (UID/GID set via PUID/PGID)
+- **Base:** Built on `ghcr.io/daemonless/base` (FreeBSD)

15/Containerfile

@@ -0,0 +1,15 @@
+name: base
+
+x-daemonless:
+  title: "Base"
+  icon: ":simple-freebsd:"
+  category: "Base"
+  description: "FreeBSD base image with s6 supervision."
+  upstream_url: "https://github.com/freebsd/freebsd-src"
+  web_url: "https://www.freebsd.org/"
+  user: "root"
+  upstream_binary: false
+  
+  docs: {}
+
+services: {}