{"id":15314282,"url":"https://github.com/barelyhuman/dokcli","last_synced_at":"2025-10-08T23:33:28.582Z","repository":{"id":101912971,"uuid":"340034083","full_name":"barelyhuman/dokcli","owner":"barelyhuman","description":"Setup dokku apps with generated scripts","archived":true,"fork":false,"pushed_at":"2021-06-14T08:26:31.000Z","size":937,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-10-02T08:44:56.090Z","etag":null,"topics":["automation","dokku","go","scripts"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/barelyhuman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":"reaper","issuehunt":null,"otechie":null,"custom":["https://barelyhuman.dev/donate"]}},"created_at":"2021-02-18T11:50:48.000Z","updated_at":"2023-01-28T00:11:15.000Z","dependencies_parsed_at":"2023-05-21T17:45:46.383Z","dependency_job_id":null,"html_url":"https://github.com/barelyhuman/dokcli","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barelyhuman%2Fdokcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barelyhuman%2Fdokcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barelyhuman%2Fdokcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barelyhuman%2Fdokcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/barelyhuman","download_url":"https://codeload.github.com/barelyhuman/dokcli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235775522,"owners_count":19043180,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","dokku","go","scripts"],"created_at":"2024-10-01T08:44:57.436Z","updated_at":"2025-10-08T23:33:23.235Z","avatar_url":"https://github.com/barelyhuman.png","language":"Go","funding_links":["https://liberapay.com/reaper","https://barelyhuman.dev/donate"],"categories":[],"sub_categories":[],"readme":"# dokcli\n\n[![Binary Builds](https://github.com/barelyhuman/dokcli/actions/workflows/create-binaries.yml/badge.svg)](https://github.com/barelyhuman/dokcli/actions/workflows/create-binaries.yml)\n[![Go Report Card](https://goreportcard.com/badge/github.com/barelyhuman/dokcli)](https://goreportcard.com/report/github.com/barelyhuman/dokcli)\n\n## Motivation\n\nI use [dokku](https://github.com/dokku/dokku) a for most deployments and while their cli is pretty extensive a certain set of operations could be better in terms of creating an App.\n\nThere's always predefined steps for various apps and hence I'd like to have a cli that can act as a wrapper around dokku to make it easier for me to create apps.\n\n## Key Features (For now)\n\n- [x] Create a New App\n  - [x] Enter app name\n  - [x] Select database plugin\n  - [x] link database to app\n  - [x] Add domain to the app\n  - [x] Add Let's encrypt\n- [ ] Delete App\n  - [ ] Unlink all the above\n  - [ ] clean up un-used images\n\n## Roadmap\n\n- Cli for creation and deletion of app\n- Lightweight Web-UI for the same\n\n## Installation\n\nDownload the binary from releases from the browser or using curl\n\n```bash\n# For linux / unix, make sure wget is installed\ncurl -s https://api.github.com/repos/barelyhuman/dokcli/releases/latest | grep browser_download_url | grep linux-amd64 | cut -d '\"' -f 4 | wget -qi -\ntar -xvzf dokcli-linux-amd64.tar.gz\n```\n\ncopy it to `/usr/local/bin` and make sure it's added to your PATH\n\n```bash\ncp dokcli /usr/local/bin\nexport PATH=$PATH:/usr/local/bin\n```\n\n## Usage\n\n**Note: Make sure you have dokku installed**\n\nFor now the cli just creates a script for you to setup a dokku as needed.\n\n(**Step 0 is optional**), the cli will ask you the needed information.\n\n0. Create a yml file named `dokku-gen.yml`. You can use the provided template  [dokku-gen.template.yml](dokku-gen.template.yml)\n\n1. Run `dokcli` on the system to create the app on.\n2. A script with the app name will be generated for you (screenshot below) with the name of `dokku-setup-\u003capp-name\u003e.sh`\n3. `chmod +x ./dokku-setup-\u003capp-name\u003e.sh`\n4. `./dokku-setup-\u003capp-name\u003e.sh` to run the generated script.\n\n**Example of a generated script**\n\n\u003cimg src=\"/.github/assets/script.png\" height=\"400\"  /\u003e\n\n## Dev\n\nMake sure you have a minimum of `go 1.5`\n_Run_\n\n```bash\ngo run .\n```\n\n_Build_\n\n```bash\ngo build .\n```\n\n## Contribution\n\nCheck the issues for things you can pick up and send through a PR for\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbarelyhuman%2Fdokcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbarelyhuman%2Fdokcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbarelyhuman%2Fdokcli/lists"}