Compare commits
3 Commits
db4be32b54
...
6206ed49ff
Author | SHA1 | Date | |
---|---|---|---|
|
6206ed49ff | ||
|
478af79158 | ||
|
6f9d0ae7df |
6
.gitattributes
vendored
6
.gitattributes
vendored
@ -73,8 +73,12 @@
|
||||
|
||||
#
|
||||
# Exclude files from exporting
|
||||
# only export helper scripts
|
||||
#
|
||||
|
||||
.gitattributes export-ignore
|
||||
.gitignore export-ignore
|
||||
.vscode/* export-ignore
|
||||
.vscode export-ignore
|
||||
.idea export-ignore
|
||||
build export-ignore
|
||||
README.md export-ignore
|
||||
|
2
.gitignore
vendored
2
.gitignore
vendored
@ -10,4 +10,4 @@
|
||||
ab-nginx.params
|
||||
|
||||
# don't track checksums -- no point
|
||||
checksums.sha256*
|
||||
checksums.sha256*
|
||||
|
43
README.md
43
README.md
@ -4,23 +4,23 @@ # ab-nginx
|
||||
|
||||
## Contents
|
||||
|
||||
[Alternate repository](#alternate-repository)
|
||||
[Documentation and scripts](#documentation-and-scripts)
|
||||
[Permissions](#permissions)
|
||||
[Container layout](#container-layout)
|
||||
[Content directory](#content-directory)
|
||||
[Configuration directory](#configuration-directory)
|
||||
[Quick-start](#quick-start)
|
||||
[Mounting content](#mounting-content)
|
||||
[Mounting configurations](#mounting-configurations)
|
||||
[Mounting server-blocks](#mounting-server-blocks)
|
||||
[TLS](#tls)
|
||||
[Environment variables](#environment-variables)
|
||||
[Shell mode](#shell-mode)
|
||||
[Drop to shell before NGINX loads](#drop-to-shell-before-nginx-loads)
|
||||
[Enter a running container](#enter-a-running-container)
|
||||
[Logs](#logs)
|
||||
[Final thoughts](#final-thoughts)#final-thoughts)
|
||||
[Alternate repository](#alternate-repository)<br>
|
||||
[Documentation and scripts](#documentation-and-scripts)<br>
|
||||
[Permissions](#permissions)<br>
|
||||
[Container layout](#container-layout)<br>
|
||||
[Content directory](#content-directory)<br>
|
||||
[Configuration directory](#configuration-directory)<br>
|
||||
[Quick-start](#quick-start)<br>
|
||||
[Mounting content](#mounting-content)<br>
|
||||
[Mounting configurations](#mounting-configurations)<br>
|
||||
[Mounting server-blocks](#mounting-server-blocks)<br>
|
||||
[TLS](#tls)<br>
|
||||
[Environment variables](#environment-variables)<br>
|
||||
[Shell mode](#shell-mode)<br>
|
||||
[Drop to shell before NGINX loads](#drop-to-shell-before-nginx-loads)<br>
|
||||
[Enter a running container](#enter-a-running-container)<br>
|
||||
[Logs](#logs)<br>
|
||||
[Final thoughts](#final-thoughts)
|
||||
|
||||
## Alternate repository
|
||||
|
||||
@ -34,9 +34,13 @@ ## Permissions
|
||||
|
||||
The container does **NOT** run under the root account. It runs under a user named *www-docker* with a UID of 8080. **This means any files you mount into the container need to be readable (and/or writable depending on your use-case) by UID 8080**. This does not mean just content files, it also includes configurations, server-blocks and *certificates*! Before mounting your files, ensure this is the case. There are more detailed instructions in the [wiki](https://git.asifbacchus.app/ab-docker/ab-nginx/wiki) if you need help setting file permissions.
|
||||
|
||||
This is a significant change versus most other NGINX implementations/containers where the main process is run as root and the *worker processes* run as a limited user. In those cases, permissions don’t matter since NGINX can always use the root account to read any files (and especially certificates!) it needs. Please understand this difference.
|
||||
This is a significant change versus most other NGINX implementations/containers where the main process is run as root
|
||||
and the *worker processes* run as a limited user. In those cases, permissions don’t matter since NGINX can always use
|
||||
the root account to read any files (and especially certificates!) it needs. Please understand this difference.
|
||||
|
||||
If you need to change the UID, then you’ll need to rebuild the container using the [Dockerfile in the git repo](#https://git.asifbacchus.app/ab-docker/ab-nginx). The process would be something like this:
|
||||
If you need to change the UID, then you’ll need to rebuild the container using
|
||||
the [Dockerfile in the git repo](https://git.asifbacchus.app/ab-docker/ab-nginx). The process would be something like
|
||||
this:
|
||||
|
||||
```bash
|
||||
# clone the repo
|
||||
@ -249,4 +253,3 @@ ## Final thoughts
|
||||
If I've forgotten anything, you find any bugs or you have suggestions, please file an issue either on my private [git server ](https://git.asifbachus.app/ab-docker/ab-nginx) or on [github](https://github.com/asifbacchus/ab-nginx). Also, I am *not* affiliated with NGINX in any way, so please **do not** bother them with any issues you find with this container. Bother me instead, I actually enjoy it!
|
||||
|
||||
**All the best and have fun!**
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user