https://github.com/bpmct/coder-home-directory

https://github.com/bpmct/coder-home-directory

Last synced: 9 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/bpmct/coder-home-directory
• Owner: bpmct
• Created: 2021-05-26T21:03:50.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2021-06-11T14:21:32.000Z (over 3 years ago)
• Last Synced: 2024-10-27T03:46:34.628Z (about 2 months ago)
• Language: Dockerfile
• Size: 18.6 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# coder-home-dir

In Coder on Kubernetes, an image's `/home/` directory is not used, as it is replaced by a Persistant Volume Claim so that the developer doesn't loose their files on rebuilds. Everything else in the filesystem is ephemeral and relies on the image as a source-of-truth. [See the docs](https://coder.com/docs/workspaces/personalization#persistent-home)

This is an example project that copies over an initial home directory from another folder. [See video](https://kapwi.ng/c/UkP3xaVA)

See the [.coder/](.coder/) folder for a sample image and corresponding template to copy the initial files.

The coder.yaml specifies a [configure step](https://coder.com/docs/workspaces/workspaces-as-code/templates#workspaceconfigure) that copies over the files for the initial home directory. This can also be done inside the image with a [configure script](https://coder.com/docs/images/configure). The method you choose to use depends on a few factors, such as whether an image is being used for multiple projects or just one.

An individual developer can also further customize their home directory with a [dotfiles repo or a personalize script](https://coder.com/docs/workspaces/personalization).

This is tested on Coder 1.19