Containered Server

Private server based on containers and compose

Disclaimer:

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Repo Structure

• ./services Service definitions
  One subfolder per service with:
  • docker-compose.yml for this service and its direct dependencies (e.g. db)
  • Additional config files, possibly as template (see below)
• ./setup Host setup
  Setup information about a possible alpine host system
• ./tasks Task definitions
  • common.yml: Base tasks used by other tasks
  • compose.yml: Container related tasks e.g. starting, updating, or reading logs
  • hot.yml: Tasks related to host system maintenance
  • services.yml: Tasks for specific services

Requirements

• envsubst, most likely via gettext package. Refer to your distros docs.
• docker
• docker-compose

Data Persistence

All data SHALL BE stored in $BASE_DIR (defaults to /srv), one subfolder per service.

Secrets & Configuration

Copy from .env.sample and fill in your values.

Deploy

./task compose:up

List other tasks

./task -l

Templating

Filename pattern: *.template.*

Files matching the pattern are copied with the ".template." infix removed (e.g. forgejo.template.ini -> forgejo.ini).
Variables are replaced using shell substitution syntax (${VARIABLE_NAME_HERE}) using the current environment and values from .env.

Host Setup

A possible alpine based host setup is described in alpine-setup.