mirror of
https://notabug.org/halcyon-suite/halcyon
synced 2024-12-23 00:10:37 +01:00
Convert the example file to a proper readme with examples and additional details
This commit is contained in:
parent
96267eb2fd
commit
030e89d239
56
docker/README.md
Normal file
56
docker/README.md
Normal file
@ -0,0 +1,56 @@
|
||||
# Halcyon Docker
|
||||
|
||||
This Docker setup for Halcyon includes just Halcyon, php-fpm and the necessary locales for internationalization support in Halcyon.
|
||||
|
||||
You'll need to use the main repo's nginx/apache/caddy configs for reverse proxy to the container. traefik will likely work but is untested.
|
||||
|
||||
# Build Halcyon Container
|
||||
|
||||
``` sh
|
||||
|
||||
cd /opt/halcyon/docker
|
||||
docker build -t halcyon/halcyon:latest .
|
||||
|
||||
```
|
||||
|
||||
# Configuration
|
||||
|
||||
The container has the official example configs stored at ```/var/www/html/config``` inside the image. You can copy the examples from the container to the server via a temporary container and volume.
|
||||
|
||||
The configs must be adjusted ahead of running the container for production use.
|
||||
|
||||
Please note: The container build will checkout the latest release of Halcyon which may *not* match the current master brach HEAD. It's advisable to use the below to copy the configs so you're using the same config examples as the version deployed in the container.
|
||||
|
||||
Example:
|
||||
|
||||
``` sh
|
||||
|
||||
cd /opt/halcyon
|
||||
mkdir config
|
||||
docker run --rm -it \
|
||||
--entrypoint /bin/sh \
|
||||
-v /opt/halcyon/config:/var/www/html/config \
|
||||
halcyon/halcyon:latest
|
||||
cp /var/www/html/config.example/* /var/www/html/config/
|
||||
exit
|
||||
|
||||
```
|
||||
|
||||
# Running
|
||||
|
||||
An example for running the container is below.
|
||||
|
||||
``` sh
|
||||
|
||||
docker run \
|
||||
--name halcyon \
|
||||
--restart unless-stopped \
|
||||
--net docker-private \
|
||||
--ip 172.30.12.13 \
|
||||
-e TZ=UTC \
|
||||
-e DEBUG=1 \
|
||||
-v /opt/halcyon/config:/var/www/html/config \
|
||||
halcyon/halcyon:latest
|
||||
|
||||
```
|
||||
|
@ -1,12 +0,0 @@
|
||||
docker build -t halcyon/halcyon:latest .
|
||||
docker run --rm -it -p 9081:80 -v ${PWD}/config:/var/www/html/config test/halcyon:latest
|
||||
docker run \
|
||||
--name halcyon \
|
||||
--restart unless-stopped \
|
||||
--net docker-private \
|
||||
--ip 172.30.12.13 \
|
||||
-e TZ=UTC \
|
||||
-e DEBUG=1 \
|
||||
-v /opt/halcyon/config:/var/www/html/config \
|
||||
test/halcyon:latest
|
||||
|
Loading…
Reference in New Issue
Block a user