{"id":19197028,"url":"https://github.com/jitesoft/docker-keybase-sshca","last_synced_at":"2025-05-09T00:37:16.534Z","repository":{"id":76670188,"uuid":"206064902","full_name":"jitesoft/docker-keybase-sshca","owner":"jitesoft","description":"Docker image with Keybase \u0026 Keybase SSH CA Bot.","archived":false,"fork":false,"pushed_at":"2020-10-12T12:45:39.000Z","size":89,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-09T00:37:08.752Z","etag":null,"topics":["certificate-authority","docker","docker-image","dockerfile","hacktoberfest","jitesoft","keybase","keybase-ssh-ca","ssh"],"latest_commit_sha":null,"homepage":"https://github.com/keybase/bot-sshca","language":"Shell","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/jitesoft.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,"zenodo":null},"funding":{"patreon":"jitesoft","open_collective":"jitesoft-open-source","custom":["https://sponsus.org/u/jitesoft"]}},"created_at":"2019-09-03T11:49:35.000Z","updated_at":"2023-12-17T06:55:15.000Z","dependencies_parsed_at":"2023-03-09T23:01:19.851Z","dependency_job_id":null,"html_url":"https://github.com/jitesoft/docker-keybase-sshca","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jitesoft%2Fdocker-keybase-sshca","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jitesoft%2Fdocker-keybase-sshca/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jitesoft%2Fdocker-keybase-sshca/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jitesoft%2Fdocker-keybase-sshca/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jitesoft","download_url":"https://codeload.github.com/jitesoft/docker-keybase-sshca/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253171210,"owners_count":21865280,"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":["certificate-authority","docker","docker-image","dockerfile","hacktoberfest","jitesoft","keybase","keybase-ssh-ca","ssh"],"created_at":"2024-11-09T12:15:19.423Z","updated_at":"2025-05-09T00:37:16.525Z","avatar_url":"https://github.com/jitesoft.png","language":"Shell","funding_links":["https://patreon.com/jitesoft","https://opencollective.com/jitesoft-open-source","https://sponsus.org/u/jitesoft"],"categories":[],"sub_categories":[],"readme":"# Keybase-SSH-CA\n\n[![Docker Pulls](https://img.shields.io/docker/pulls/jitesoft/keybase-sshca.svg)](https://hub.docker.com/r/jitesoft/keybase-sshca)\n[![pipeline status](https://gitlab.com/jitesoft/dockerfiles/keybase-sshca/badges/master/pipeline.svg)](https://gitlab.com/jitesoft/dockerfiles/keybase-sshca/commits/master)\n[![Back project](https://img.shields.io/badge/Open%20Collective-Tip%20the%20devs!-blue.svg)](https://opencollective.com/jitesoft-open-source)\n\nThis image contains the [Keybase](https://keybase.io/) and [Keybase-sshca](https://github.com/keybase/bot-sshca) applications running on ubuntu linux.  \n\n## What is Keybase SSH CA?\n\nA bot!, a chat bot! Which you can use as a certificate authority to sign ssh keys for usage on your servers!  \nEasiest way to use it is via the `kssh` utility which is possible to download at the [official repository](https://github.com/keybase/bot-sshca).  \n\n## Tags\n\nTags are based on the keybase-sshca version.  \nAs of current releases, the versions contains part of the commit sha suffixed, every build will include that as a \ntag too: `1.0.0-7803a8d`\n\nKeybase-sshca is built from source and compiled for amd64 and arm64/aarch64.\n\n### Docker Hub\n\n* `jitesoft/keybase-sshca`\n    * `latest`, `1.1.0`\n    * `latest-alpine`, `1.1.0-alpine`\n\n### GitLab\n\n* `registry.gitlab.com/jitesoft/dockerfiles/keybase-sshca`\n    * `latest`, `1.1.0`\n* `registry.gitlab.com/jitesoft/dockerfiles/keybase-sshca/alpine`\n    * `latest`, `1.1.0`\n\n### Quay.io\n\n* `quay.io/jitesoft/keybase-sshca`\n    * `latest`, `1.1.0`\n    * `latest-alpine`, `1.1.0-alpine`\n  \nDockerfile can be found at [GitLab](https://gitlab.com/jitesoft/dockerfiles/keybase-sshca) and [GitHub](https://github.com/jitesoft/docker-keybase-sshca).\n\n### Image labels\n\nThis image follows the [Jitesoft image label specification 1.0.0](https://gitlab.com/snippets/1866155).\n\n## Usage\n\nFor full documentation, check the [Keybase SSH CA Bot documentation](https://keybase-ssh-ca-bot.readthedocs.io/en/latest/index.html).\n\nStartup of bot:\n\n```shell \ndocker run -v $(pwd):/home/keybase/certificates jitesoft/keybase-sshca:1.0.0 \n```\n\nTo fine-tune the container to work with your channels, a few environment variables are available:\n\n```dotenv\nTEAMS=\"list.of.teams,separated.by.a.comma\"\nCHAT_CHANNEL=\"list.of.teams#and-channel,separated.by.a.comma#channel\"\nKEYBASE_USERNAME=\"your-bot-username\"             # I recommend that you create a new bot for this.\nKEYBASE_PAPERKEY=\"Paperkey-for-bot\"              # Possible to generate quickly via the keybase cli. \nKEYBASE_USERNAME_PATH=\"path-to-username-in-file\" # File to use instead of above 'username' env variable. \nKEYBASE_PAPERKEY_PATH=\"path-to-paperkey-in-file\" # As above, but for the paperkey.\nCA_KEY_LOCATION=\"/home/keybase/ca-cert\"          # Location where the key file should be or will be if generated by this image.\n                                                 # Default is /home/keybase/ca-cert\nKEY_EXPIRATION=\"+12h\"                            # Expiration time (prefixed with + and sufixed with unit, such as d, h, m).\nKEYBASE_SSHCA_LOG_DIR=\"/home/keybase/.cache/keybase\" # Path to directory where the logs of the keybase-ssh-ca bot should be placed.\n                                                # defaults to /home/keybase/.cache/keybase\n                                                # Note: logs are also printed to stdout.\nSTRICT_LOGGING=\"false\"                          # Sets the logging to strict or not strict. (true or false)\nANNOUNCEMENT=\"\"                                 # A string/text that the bot will use to announce itself in a channel.\n                                                # The following placeholders are available: {USERNAME}, {CURRENT_TEAM}, {TEAMS}.\n```\n\nMost notable are the `KEYBASE_*` prefixed user and paperkey variables, which either filepath or env type are required to exist to allow the bot to connect.  \nThe Docker image will generate a set of `ecdsa` keys to use as ca keys in case you don't supply them yourself, and it might be worth to add a persistent volume for them\nso that they do not disappear after restart of the container.  \n\n## Licenses\n\nThis repository and the files therein are released under the [MIT](https://gitlab.com/jitesoft/dockerfiles/keybase/blob/master/LICENSE) license.  \nKeybase is released under the [BSD 3-Clause \"New\" or \"Revised\"](https://github.com/keybase/client/blob/master/LICENSE) license.  \nKeybase-sshca is released under the [BSD 3-Clause \"New\" or \"Revised\"](https://github.com/keybase/bot-sshca/blob/master/LICENSE) license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjitesoft%2Fdocker-keybase-sshca","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjitesoft%2Fdocker-keybase-sshca","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjitesoft%2Fdocker-keybase-sshca/lists"}