3. Configure¶
Goal: write config/config.conf and the 1Password items that prep-airdrop.sh reads.
Do all steps on the dev Mac, in the root of your clone.
Steps¶
-
Copy the template:
-
Sign in to 1Password and find your vault ID:
-
In
config/config.conf, set the server name and the vault: -
In that vault, create these Login items. The item titles must match the
ONEPASSWORD_*_ITEMvalues in your config. Change the values or the titles so that they agree.ONEPASSWORD_OPERATOR_ITEM: the operator password. If the item does not exist,prep-airdrop.shcreates it with a random password.ONEPASSWORD_PLEX_NAS_ITEM: the NAS username and password. Put the NAS hostname in the item's first URL field.ONEPASSWORD_APPLEID_ITEM: the Apple Account for the server. Mark this item as a favorite.prep-airdrop.shsearches only favorite Login items for it.ONEPASSWORD_TIMEMACHINE_ITEM(optional): the Time Machine share username and password, with the share URL in the first URL field.ONEPASSWORD_OPENSUBTITLES_ITEM(optional): the OpenSubtitles account for FileBot.
-
Set the NAS keys. The export path that
showmount -eprinted in the prerequisites check must be/<NAS_VOLUME>/<NAS_SHARE_NAME>: -
Set the alert address:
-
Set the LAN keys, even if you do not install Transmission or Caddy now:
-
If you want Transmission later, create a PIA Login item and set
ONEPASSWORD_PIA_ITEMto its title. SetPIA_VPN_REGIONto a region near you that supports port forwarding.prep-airdrop.shcopies the PIA credentials only when this key is set, andpodman-transmission-setup.shstops without them. - Leave the remote access keys empty for now: the Cloudflare keys,
EXTERNAL_HOSTNAME,BASICAUTH_*andHOME_LINK*. - Optional: edit the Homebrew lists,
config/formulae.txtandconfig/casks.txt. Put one formula or cask on each line.setup-package-installation.shskips blank lines and lines that start with#. Do not remove an entry that a component needs. For example,podman-transmission-setup.shneedstimeoutfromcoreutils.
The configuration keys reference describes every key.
Set every key in config/config.conf, not in your shell. prep-airdrop.sh, first-boot.sh and each app setup script source the file, so a key in the file replaces a value that you exported. This includes FILEBOT_LICENSE_FILE, the DROPBOX_* keys, USE_ITERM2 and TERMINAL_PROFILE_FILE.
Check¶
-
The file has no syntax errors and has your values:
-
1Password finds each item. Run this for each item title:
-
The Apple item is a favorite. This command prints its ID:
More than one server¶
SERVER_NAME names the package folder (~/<server name>-setup, lowercased) and the keychain services in the package, so each server needs its own value. Keep one config file for each server, and copy the right one into place before you run prep-airdrop.sh:
Give each server its own 1Password items, or point the ONEPASSWORD_*_ITEM keys at shared ones. To give a server a network name that differs from SERVER_NAME, set HOSTNAME_OVERRIDE.
Keep a copy of your config¶
Git ignores config/config.conf, so a fresh clone does not have it. Keep a copy in a private place, for example a private repository or a 1Password secure note. With that file and the 1Password items, you can build the package again and set up a new or rebuilt server from the start. Keep a backup of the dev Mac SSH key too: the package installs it on the server.
Next: Build the setup package