{"id":22832563,"url":"https://github.com/waldner/keybase-kbfs-docker","last_synced_at":"2025-04-23T21:25:06.115Z","repository":{"id":92012172,"uuid":"151865654","full_name":"waldner/keybase-kbfs-docker","owner":"waldner","description":"Docker image for keybase's KBFS","archived":false,"fork":false,"pushed_at":"2024-10-06T11:30:22.000Z","size":23,"stargazers_count":14,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-30T03:41:15.274Z","etag":null,"topics":["docker","kbfs","keybase","keybase-filesystem"],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/waldner.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2018-10-06T17:41:10.000Z","updated_at":"2024-12-31T16:52:52.000Z","dependencies_parsed_at":"2024-12-12T21:08:04.630Z","dependency_job_id":"cb3a3c57-8d68-42de-afbc-305a26d65594","html_url":"https://github.com/waldner/keybase-kbfs-docker","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/waldner%2Fkeybase-kbfs-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waldner%2Fkeybase-kbfs-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waldner%2Fkeybase-kbfs-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waldner%2Fkeybase-kbfs-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/waldner","download_url":"https://codeload.github.com/waldner/keybase-kbfs-docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250515961,"owners_count":21443522,"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":["docker","kbfs","keybase","keybase-filesystem"],"created_at":"2024-12-12T21:08:01.132Z","updated_at":"2025-04-23T21:25:06.074Z","avatar_url":"https://github.com/waldner.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# keybase-kbfs-docker\nDocker image for keybase's KBFS\n\n### What's this?\n\nThis is a [Docker](https://www.docker.com/) image for [Keybase client](https://keybase.io) focused on getting access to [KBFS](https://keybase.io/docs/kbfs). The KBFS mount can optionally be seen from the host.\n\n### Getting started\n\n- Create an account on [Keybase](https://keybase.io)\n- Generate a _paper key_ using the keybase CLI (you should use another device to do this). The paper key is just a series of words, that counts as a device in Keybase, and can be used for the \"oneshot\" feature used by the docker container.\n- The recommended way to run the container is by using [docker-compose](https://docs.docker.com/compose/). But before, you must create an `.env` file with the following contents:\n\n\n```\n# where the KBFS is mounted inside the container.\nKEYBASE_KBFS_MOUNT=/kbfs\n\n# the UID of the user who will run the container.\nUID=1000\n\n# to have container's time in sync with the host\nTZ=your/timezone\n\nKEYBASE_USER=your_keybase_user\nKEYBASE_PAPERKEY=your keybase paper key\n```\n\nThe UID variable is used by the entrypoint script to do some trickery to match the UID of the user unnig docker with the UID of the user inside the container. In most cases you don't need to change this, but it may happen that your user has an ID that is not 1000, so you'll have to change that value in the `.env` file.\n\nAfter that, you can run `docker-compose up -d`. It uses the prebuilt image at [the Docker hub](https://hub.docker.com/r/waldner/keybase/). The KBFS is mounted at `${KEYBASE_KBFS_MOUNT}` (`/kbfs`) inside the container.\n\n\n### How to get the KBFS mount on the host\n\nCreate a file `docker-compose.override.yml` with the follwing contents:\n\n```\nservices:\n  keybase:\n    volumes:\n      - \"/home/you/kbfs:${KEYBASE_KBFS_MOUNT}:shared\"\n```\n\nWith this you'll have the KBFS exposed at `/home/you/kbfs` on the host.\n\n### Caveats\n\n- To use a FUSE mount inside the container, the device `/dev/fuse` is exposed to the container, which also needs to have the `SYS_ADMIN` capability (and needs the `apparmor:unconfined` security option under Ubuntu). If you're exporting the KBFS mount back to the host and the container crashes without cleaning up, you might have to manually umount (ie `fusermount -u /home/you/kbfs`) the host mount point.\n\n- If you try to do `ls /kbfs/private` you get the mostly unrelated error `ls: reading directory '/kbfs/private/': Input/output error`. This sort of makes sense, as the contents of that directory are, well, private, although the error message is highly misleading and might look like a genuine error (network or whatever). Turns out that inside `private/`, you can only access your own subdirectory, so you always have to specify at least that path (plus any further subpath you might want):\n\n```\n# this works, assuming your username is \"fonzie\":\n$ ls /kbfs/private/fonzie     # or /kbfs/private/fonzie/whatever\n```\n\nFurthermore, remember that the kbfs mount must always be accessed with the user with UID 1000, both inside and outside the container (inside the container it's the user `keybase`, which you can su in to from root).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaldner%2Fkeybase-kbfs-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaldner%2Fkeybase-kbfs-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaldner%2Fkeybase-kbfs-docker/lists"}