|
1 | | -# nginx-base-image |
| 1 | +# Nginx-Base |
2 | 2 |
|
3 | | -An extended base image pre-configured with **nginx** and s6 supervision for serving web applications on FreeBSD. |
4 | 3 |
|
5 | | -## Overview |
6 | 4 |
|
7 | | -This image extends `base-image` by adding a pre-configured nginx installation. It is designed to be a "ready-to-go" platform for PHP, PHP-FPM, or static web applications. |
| 5 | +| | | |
| 6 | +|---|---| |
| 7 | +| **Registry** | `ghcr.io/daemonless/nginx-base` | |
| 8 | +| **Source** | []() | |
8 | 9 |
|
9 | | -## Features |
| 10 | +## Deployment |
10 | 11 |
|
11 | | -- **Inherits all `base-image` features** (s6, PUID/PGID, VNET). |
12 | | -- **Pre-configured nginx**: Service is defined and ready to serve files from `/usr/local/www/html`. |
13 | | -- **Automatic Permissions**: Logs and web directories are correctly permissioned at startup. |
| 12 | +### Podman Compose |
14 | 13 |
|
15 | | -## Usage (for Image Developers) |
| 14 | +```yaml |
| 15 | +services: |
| 16 | + nginx-base: |
| 17 | + image: ghcr.io/daemonless/nginx-base:latest |
| 18 | + container_name: nginx-base |
| 19 | + environment: |
| 20 | + volumes: |
| 21 | + ports: |
| 22 | + restart: unless-stopped |
| 23 | +``` |
16 | 24 |
|
17 | | -Use this if your application requires a web server: |
| 25 | +### Podman CLI |
18 | 26 |
|
19 | | -```dockerfile |
20 | | -FROM ghcr.io/daemonless/nginx-base-image:15 |
| 27 | +```bash |
| 28 | +podman run -d --name nginx-base \ |
| 29 | + ghcr.io/daemonless/nginx-base:latest |
| 30 | +``` |
21 | 31 |
|
22 | | -# Add your web files |
23 | | -COPY my-site/ /usr/local/www/html/ |
| 32 | +### Ansible |
24 | 33 |
|
25 | | -# Optional: Add custom nginx config |
26 | | -COPY my-nginx.conf /usr/local/etc/nginx/nginx.conf |
| 34 | +```yaml |
| 35 | +- name: Deploy nginx-base |
| 36 | + containers.podman.podman_container: |
| 37 | + name: nginx-base |
| 38 | + image: ghcr.io/daemonless/nginx-base:latest |
| 39 | + state: started |
| 40 | + restart_policy: always |
27 | 41 | ``` |
28 | 42 |
|
29 | | -## Exposed Ports |
| 43 | +## Configuration |
| 44 | +
|
| 45 | +### Environment Variables |
| 46 | +
|
| 47 | +| Variable | Default | Description | |
| 48 | +|----------|---------|-------------| |
| 49 | +
|
| 50 | +### Volumes |
| 51 | +
|
| 52 | +| Path | Description | |
| 53 | +|------|-------------| |
| 54 | +
|
| 55 | +### Ports |
30 | 56 |
|
31 | | -- `80`: Standard HTTP. |
32 | | -- `443`: HTTPS. |
| 57 | +| Port | Protocol | Description | |
| 58 | +|------|----------|-------------| |
33 | 59 |
|
34 | | -## Directory Structure |
| 60 | +## Notes |
35 | 61 |
|
36 | | -- `/usr/local/www/html`: Default web root. |
37 | | -- `/var/log/nginx`: nginx log directory. |
38 | | -- `/usr/local/etc/nginx`: nginx configuration files. |
39 | | -<!-- Trigger build --> |
| 62 | +- **User:** `` (UID/GID set via PUID/PGID) |
| 63 | +- **Base:** Built on `ghcr.io/daemonless/base` (FreeBSD) |
0 commit comments