33 lines
2.0 KiB
Plaintext
33 lines
2.0 KiB
Plaintext
= Docker or Podman
|
|
|
|
include::partial$install/container.adoc[]
|
|
|
|
include::partial$install/container_registries.adoc[]
|
|
|
|
If you prefer to use docker-compose, then follow the xref:install/docker_compose.adoc[docker-compose] installation instructions>>.
|
|
|
|
The standard container setup just needs **port 1337** forwarded for web traffic, and a volume **to store the configuration file**. Note that OliveTin containers expect the config to be in `/config/` inside the container, but it doesn't really matter where this directory is mounted from on the host. This documention uses the convention of `/etc/OliveTin` on the host, but `/dockerStuff/OliveTin/` or similar would be fine.
|
|
|
|
[source, shell]
|
|
.Create the container (but don't start it yet)
|
|
....
|
|
user@host: mkdir /etc/OliveTin/
|
|
user@host: # ie: Your config file is /etc/OliveTin/config.yaml on the host machine. We'll create this in the post-installation step.
|
|
user@host: docker pull jamesread/olivetin
|
|
user@host: docker create --name olivetin -p 1337:1337 -v /etc/OliveTin/:/config:ro docker.io/jamesread/olivetin
|
|
....
|
|
|
|
NOTE: The OliveTin container is built using fedora-minimal, which doesn't use customizations that some people may be familiar with from popular projects like LSIO, or debian-based containers. The two top misunderstandings are xref:troubleshooting/puid-pgid.adoc[PUID and PGID are ignored]. Please see the instructions below if you're not familiar with changing users or timezones.
|
|
|
|
[#container-user]
|
|
== Container user
|
|
|
|
OliveTin does not need to be run as a root, and does not need any special capabilities. If you want to change the user that OliveTin runs as, use `--user` when creating the container. OliveTin ignores xref:troubleshooting/puid-pgid.adoc[PUID and PGID].
|
|
|
|
[#container-timezone]
|
|
== Container timezone
|
|
|
|
To change the xref:advanced_configuration/timezones.adoc[changing the timezone requires a bound-mount] from the host. Olivetin ignores the TZ variable as it is non-standard.
|
|
|
|
include::partial$install/post_container.adoc[]
|