This repository has been archived on 2021-07-22. You can view files and clone it, but cannot push or open issues or pull requests.
docs.coopcloud.tech/uncategorised/index.md

2.3 KiB

title
Welcome

Coöp Cloud (working title; abbreviated CoCl) is a container-based, platform-agnostic, free software registry for small service providers.

  • Production-ready apps in minutes: Wordpress & Nextcloud instances, mail-servers, and more.
  • Simple Docker-based framework for continuous deployment of your custom apps.

List of CoCl apps{: .md-button }

HOWTOs:

!!! warning "A note about ARM" Not all applications currently support all ARM computers (like PINE64 and Raspberry Pi): e.g. Traefik will work on ARMv6 & ARM64, the official MariaDB app doesn't work on any ARM boards. It might be possible to use third-party ARM images with separate compose.yml files, but we haven't exlplored this rabbit-hole much yet.

Definitions

CoCl is a philosophy.

  • To get started, you create a server, e.g. a new VPS, including your local configuration to connect to it...
  • then you install an app like wordpress or nextcloud, which is made up of multiple services...
  • .. and configure your app.

Technical description

Software-wise, CoöpCloud is:

  • coop-cloud, a collection of Docker "swarm mode" configurations for popular web apps
  • abra, a simple tool for Docker swarm management
  • a recommended default set of stacks:
    • Traefik for SSL & routing
    • postfix-relay for outgoing email

Principles / features:

  • Security by default
  • Zero-downtime deployments (for apps with healthchecks defined)
  • Continuous integration testing using Drone and our stack-ssh-deploy plugin
  • Low maintenance overhead:
    • Automatic tracking of upstream Docker images using renovate-bot
    • Avoiding custom Docker images as far as possible