A tool to publish, search and install apps using docker-compose. You can also search on ComposeHub using the web UI online https://composehub.com

The Docker hub is awesome to search for great images to build your own apps. However, for existing apps such as wordpress or gitlab, you need more than one container and linking them all together is no fun as it requires typing never-ending docker CLI commands. So you end up googling for a docker-compose.yml to solve your problem and end up copy/pasting the result in your own docker-compose.yml file, crossing fingers it works out. Composehub solves this problem by providing an easy way to search for docker-compose apps stored on git repos. You can also use it to publish your own public or private apps. Give it a try!

• Publish apps
• Search for apps
• Install apps in seconds
• Run apps on the fly

curl -L https://composehub.com/install/darwin > /usr/local/bin/ch && chmod +x /usr/local/bin/ch

curl -L https://composehub.com/install/linux > /usr/local/bin/ch && chmod +x /usr/local/bin/ch

curl -L https://composehub.com/install/windows > /usr/local/bin/ch

go get -u github.com/composehub/cli

• Search apps
• Install apps
• Run apps
• Manage your user account (optional)
  • Create an account
  • Update an account
  • Reset password
• Publish apps
  • Command
  • Config format

ch search gitlab

This will return a list of packages having gitlab in their name or description, ordered by most downloaded.

ch install gitlab && cd gitlab

Before installing an app, make sure your current directory is empty. Installing the app will clone the repo containing the docker-compose.yml file. Once the installation is done, just run the usual docker-compose up. If there are additional commands to execute before, they will be shown at the end of the install.

ch run wordpress

This will install wordpress in the current directory and run it automatically.

You only need an account if you want to publish your own apps.

ch adduser

You'll be asked to enter email, handle and password.

ch updateuser

Use this to update any of your user information.

ch resetpassword

Use this if you've forgotten your password.

ch init

This will create a composehub.yml file in the current directory.

---
name: package-name
blurb: 80 chars line blurb
description: |
  longer description
email: [email protected]
repo_url: http://github.com/foo/bar
tags: tag1,tag2
private: false
cmd: docker-compose up

The description will be displayed at the end of the install process of your package, use it to document any post-install required tasks. cmd is the command that will be ran when the user executes ch run <package>, it is optional and can just be left blank. private if you set private to true, only you will be able to install the app and it will not appear online or in search results, this requires you to have your composehub account configured on your host.