The Co-op Cloud command-line interface 🎩🐇
Go to file
decentral1se 36e470c8e7
Front-line that deprecation notice
2021-08-02 11:32:52 +02:00
bin Skip that repo too 2021-07-14 10:16:05 +02:00
completion Add Bash completion for `abra recipe ..` 2021-05-30 14:33:57 +02:00
deploy/ New patch release 2021-07-30 19:33:29 +02:00
tests `ensure_stack_deployed` is now somewhat more reliable 2021-06-27 21:03:24 +02:00
.drone.yml Install requirements via install script 2021-07-05 23:48:03 +02:00
.gitignore Drop the apps.json in the cwd 2021-06-05 08:26:43 +02:00 New patch release 2021-07-30 19:33:29 +02:00
Dockerfile Add mirroring script 2021-06-05 22:41:50 +02:00 Front-line that deprecation notice 2021-08-02 11:32:52 +02:00
abra New patch release 2021-07-30 19:33:29 +02:00
makefile Install requirements via install script 2021-07-05 23:48:03 +02:00


🔥 🔥 🔥 D E P R E C A T E D 🔥 🔥 🔥

abra served us well but we're porting it to Golang over in go-abra. To learn more about the reasons for that, see this blog post. This means this repository and tool are officially deprecated as of August 1rst 2021. We will still provide bug security fixes but no new features will be developed in abra. Feel free to go on using it and reporting issues against this issue tracker. Thanks for all the good times Bash.

🔥 🔥 🔥 D E P R E C A T E D 🔥 🔥 🔥

Build Status

The Co-op Cloud utility belt 🎩🐇

abra is a command-line tool for managing your own Co-op Cloud. It can provision new servers, create applications, deploy them, run backup and restore operations and a whole lot of other things. It is the go-to tool for day-to-day operations when managing a Co-op Cloud instance.

Change log

🔥 🔥 🔥 Please note, while we are still in public alpha, the abra release versioning scheme is not following semver conventions because we are still in the exploratory phases of building this tool. Please read the changes before upgrading your abra installation as there are most likely breaking changes coming each release. Sorry for any inconvenience caused, we're working hard to make this tool stable. Semver will be respected when we reach public beta. 🔥 🔥 🔥




  • curl
  • docker
  • bash >= 4


Install the latest stable release:

curl | bash

The source for this script is here.

You can pass options to the script like so (e.g. install the bleeding edge development version):

curl | bash -s -- --dev

Other options available are as follows:

  • --no-prompt: non-interactive installation
  • --no-deps: do not attempt to install requirements


An image is also provided.

docker run thecoopcloud/abra app ls


Run abra upgrade to automatically download and install the latest release version.

To update the development version, run abra upgrade --dev.


It's written in Bash version 4 or greater!

Install it via curl | bash -s -- --dev, then you can hack on the source in ~/.abra/src.

The command-line interface is generated via docopt. If you add arguments then you need to run make docopt ro regenerate the parser.

Please remember to update the CHANGELOG when you make a change.



  • Change the x.x.x header in to reflect new version and mark date
  • Update the version in abra
  • Update the version in deploy/
  • git commit the above changes and then tag it with git tag <your-new-version>
  • git push and git push --tags
  • Deploy a new installer script make release-installer
  • Tell the world (CoTech forum, Matrix public channel, Autonomic mastodon, etc.)