From ffe6608c0175b00dacfc9663c8608b656f590697 Mon Sep 17 00:00:00 2001 From: James Lu Date: Sun, 1 Mar 2020 13:49:20 -0800 Subject: [PATCH] Add LICENSE and usage instructions --- LICENSE | 5 +++++ README.md | 24 +++++++++++++++++++++++- 2 files changed, 28 insertions(+), 1 deletion(-) create mode 100644 LICENSE diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..8b34d73 --- /dev/null +++ b/LICENSE @@ -0,0 +1,5 @@ +Copyright 2020 James Lu + +Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. + +THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. diff --git a/README.md b/README.md index 0611a44..6b040c9 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,26 @@ # atheme-docker -Unofficial Docker image for [Atheme IRC Services](https://github.com/atheme/atheme), based off Alpine. +[![Build Status](https://drone.overdrivenetworks.com/api/badges/overdrivenetworks/atheme-docker/status.svg)](https://drone.overdrivenetworks.com/overdrivenetworks/atheme-docker) +This is an unofficial Docker image for [Atheme IRC Services](https://github.com/atheme/atheme), based off of Alpine and rebuilt weekly. + +## Usage + +First, write your desired `atheme.conf` and copy `services.db` (if you have one) into an empty directory. Make sure it is writable by **UID 10000** (or rebuild the image with your desired UID - see Build Arguments below) + +``` +$ docker run -v /path/to/services/data:/atheme/etc ovdnet/atheme +``` + +### Supported tags + +- You can use the `latest` tag (which points to the [latest release built from this repository](/.drone.yml)), or pin to a specific version (e.g. `7.2.10-r2`, `7.2`, `7`) +- Builds with contrib modules are also available: `contrib` (latest release), as well as pins to specific versions (e.g. `7.2.10-r2-contrib`, `7.2-contrib`, `7-contrib`) + +## Build arguments + +For those who want to create customized builds, here are options exposed by the Dockerfile: + +- `ATHEME_UID`: sets the UID for the Atheme user to run as. Defaults to 10000. +- `ATHEME_VERSION`: Atheme version to pull from Git +- `BUILD_CONTRIB_MODULES`: if set to a non-empty value, enables building contrib modules.