You cannot select more than 25 topics
			Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
		
		
		
		
		
			|  443485a2d7 Co-authored-by: Mathias Fredriksson <mafredri@gmail.com> Co-authored-by: Muhammad Atif Ali <atif@coder.com> | 2 years ago | |
|---|---|---|
| .. | ||
| README.md | 2 years ago | |
| main.test.ts | 2 years ago | |
| main.tf | 2 years ago | |
| run.sh | 2 years ago | |
		
			
				
				README.md
			
		
		
			
			
		
	
	| display_name | description | icon | maintainer_github | verified | tags | |
|---|---|---|---|---|---|---|
| Dotfiles | Allow developers to optionally bring their own dotfiles repository to customize their shell and IDE settings! | ../.icons/dotfiles.svg | coder | true | 
 | 
Dotfiles
Allow developers to optionally bring their own dotfiles repository.
This will prompt the user for their dotfiles repository URL on template creation using a coder_parameter.
Under the hood, this module uses the coder dotfiles command.
module "dotfiles" {
  source   = "registry.coder.com/modules/dotfiles/coder"
  version  = "1.0.12"
  agent_id = coder_agent.example.id
}
Examples
Apply dotfiles as the current user
module "dotfiles" {
  source   = "registry.coder.com/modules/dotfiles/coder"
  version  = "1.0.0"
  agent_id = coder_agent.example.id
}
Apply dotfiles as another user (only works if sudo is passwordless)
module "dotfiles" {
  source   = "registry.coder.com/modules/dotfiles/coder"
  version  = "1.0.0"
  agent_id = coder_agent.example.id
  user     = "root"
}
Apply the same dotfiles as the current user and root (the root dotfiles can only be applied if sudo is passwordless)
module "dotfiles" {
  source   = "registry.coder.com/modules/dotfiles/coder"
  version  = "1.0.0"
  agent_id = coder_agent.example.id
}
module "dotfiles-root" {
  source       = "registry.coder.com/modules/dotfiles/coder"
  version      = "1.0.0"
  agent_id     = coder_agent.example.id
  user         = "root"
  dotfiles_uri = module.dotfiles.dotfiles_uri
}
Setting a default dotfiles repository
You can set a default dotfiles repository for all users by setting the default_dotfiles_uri variable:
module "dotfiles" {
  source               = "registry.coder.com/modules/dotfiles/coder"
  version              = "1.0.12"
  agent_id             = coder_agent.example.id
  default_dotfiles_uri = "https://github.com/coder/dotfiles"
}