Thank you very much for your work; at the moment I am out of the office,
I think for this week. (I need to finish a project by mid-September, I
will try to escape my earring at night)
As soon as I get it, I restore/cleanup the VM/Debian to test it.
On 8/9/21 10:46 PM, IGnatius T Foobar wrote:
All right people, grab your favorite 64-bit AMD/Intel Linux machine
and try this.
First, install Docker. (On a Debian or Ubuntu host it's "apt install
docker.io")
Then, do this:
*docker run --name citadel -it --rm --network host --mount
type=volume,source=citadel-data,target=/citadel-data
citadeldotorg/citadel*
You'll see it download, then start up the server (in the foreground).
Citadel and WebCit are up and running. That's really all there is to it!
Now if you want to play around with the options, you can download the
"run-citadel.sh" script from https://tinyurl.com/yjvmgjg7
<https://tinyurl.com/yjvmgjg7> which does a few more things. Let me
explain what some of these options are:
* "-it" basically means "run it in the foreground" (interactively,
on a tty). You'll use this while testing, maybe not in production.
* "--rm" means "delete the container when it exits". Yes, you want
this. It deletes the container, not the container /image/. You
don't want a bunch of dead containers lying around.
* "--network host" makes Docker bind the container's exposed ports
directly to the host's network interface, so you don't have to map
ports manually.
* Within the container, Citadel Server will look for a directory
called "/citadel-data" for its persistent databases.
"--mount type=volume,source=citadel-data,target=/citadel-data"
tells Docker to mount a native Docker volume to that mount point
inside the container. If you want to use an existing Citadel
database, you could do "--mount
type=bind,source=/usr/local/citadel,target=/citadel-data" instead.
* "citadeldotorg/citadel" is the repository and container name.
Theoretically, every time you run the above command, it ought to
check for updates and download a newer version if it is
available. I haven't tried this yet but it ought to work.
If you do not trust Docker Hub, you can go to
https://code.citadel.org/?p=citadel-docker.git;a=summary
<https://code.citadel.org/?p=citadel-docker.git;a=summary> and build
the container yourself, which isn't actually all that much more work
because it pulls in all of the required bits on its own. It's
basically Easy Install with guaranteed system compatibility.
Try it! I'll have ARM images out soon.
