install.fairie/docs/CHEZMOI-INTRO.md
Brian Zalewski 725ebe988c Latest
2022-12-24 23:21:19 -05:00

3.7 KiB

User / Environment Variable Configuration

This script will automatically set up a handful of different configurations / integrations if you decide to add your information. The script will first check for environment variables and then show prompts to fill in the gaps if the system is not headless. Below you can find a description of what each piece of information is used for as well as the name of the environment variable you can specify to bypass the prompt.

Work Environment

Set to true if you are setting up a work environment where things like Tor should not be installed.

  • Environment variable: WORK_ENVIRONMENT

Restricted Environment

Set to true if you are setting up an environment that should not use sudo / administrator privileges. This is a WIP.

  • Environment variable: RESTRICTED_ENVIRONMENT

Software Group

The category you select for software group will determine which list of software should be installed. The lists are configurable by modifying ~/.local/share/chezmoi/software.yml.

  • Environment variable: SOFTWARE_GROUP

Name

Enter your full name as you would like it to appear in configuration files such as the Git configuration.

  • Environment variable: FULL_NAME

E-mail

Enter your primary e-mail address.

  • Environment variable: PRIMARY_EMAIL

Public GPG Key ID

If you have a public GPG key available on the Ubuntu or MIT keyservers, then you can enter it so that it is automatically imported.

  • Environment variable: KEYID

Timezone

Enter your timezone in the format of America/New_York. It should be available in the TZ database.

  • Environment variable: TIMEZONE

Domain

The domain address you would like to use for any part of the deployment that involves launching a publicly web service.

  • Environment variable: PUBLIC_SERVICES_DOMAIN

CloudFlare API Token

The API token is used to automatically configure various web services that rely on public DNS records.

  • Environment variable: CLOUDFLARE_API_TOKEN

GitHub Gist Token

Pass in a GitHub token with the gist scope to be able to use the gist CLI tool without having to authenticate.

  • Environment variable: GITHUB_GIST_TOKEN

GitHub Read-Only Token

Pass in a GitHub read-only token linked to your account to automatically save a backup of your GitHub repositories. For more information, see this link.

  • Environment variable: GITHUB_READ_TOKEN

GitLab Read-Only Token

Pass in a GitLab read-only token linked to your account to automatically save a backup of your GitLab repositories. For more information, see this link.

  • Environment variable: GITLAB_READ_TOKEN

G-mail Address

Add a G-mail address which you would like to use as the handler for outgoing SMTP mail.

  • Environment variable: GMAIL_ADDRESS

G-mail App Password

Add the app password to your G-mail address so that outgoing mail can be handled by G-mail.

  • Environment variable: GMAIL_APP_PASSWORD

Ngrok Authentication Token

Add your Ngrok authentication token so that the configuration file can be automatically generated.

  • Environment Variable: NGROK_AUTH_TOKEN

Slack API Token

Add your Slack API token so that slackterm can be automatically set up.

  • Environment Variable: SLACK_API_TOKEN

Tabby Configuration ID

Add your Tabby configuration ID to automatically sync Tabby settings.

  • Environment Variable: TABBY_CONFIG_ID

Tabby Sync Token

Add your Tabby sync token to automatically sync Tabby settings. This works in conjunction with the Tabby Configuration ID mentioned above.

  • Environment Variable: TABBY_SYNC_TOKEN