Dotfiles for Debian servers
Charles Reid b32d524b44 fix order to alphabetical in 3 days ago
attic move cloud init to attic 3 days ago
crontab restart the charlesreid1pod service, since mw is hanging 3 weeks ago
dotfiles fix order to alphabetical in 3 days ago
motd add motd install script 10 months ago
services sudo systemctl 7 months ago
tasks add user charles to group docker 5 months ago
LICENSE Adding MIT license 1 year ago update readme for recent changes to tasks and scripts 10 months ago update todo with blackbeard_scripts note 7 months ago
memo add materials for generating databot private key, memo for what to fill in. 9 months ago

Debian Server Dotfiles

Repository containing dotfiles and scripts for bootstrapping from a fresh bare-metal cloud node to a fully-configured node.

This hard-codes the user charles so it should be edited before general use.


This repo has the following components:

  • tasks to run on boot
  • dotfiles (and scripts) to install on boot

The user is also provided with:

  • crontabs
  • startup services

Quick Start

The quickest way to get started with this repo is to use the scripts in cloud_init.

This directory contains user_data_machinename, a one-liner pipe-to-bash that will:

  • bootstrap the entire repository from scratch
  • run the sudo tasks as sudo
  • switch to the regular user
  • run the regular user tasks as regular user

This gives you a fully hands-free configuration.

You should create a new user_data script for each new machine.

Link to dotfile instructions

The tasks/ Directory

The entrypoint for everything is the tasks/ directory.

tasks/ script should be run as sudo to run all sudo tasks.

tasks/ script should be run as charles to run all regular user tasks.

The task scripts are path-independent and can be run from anywhere.

They automatically detect the location of the script to determine the location of neighboring task scripts that need to be initiated. script

The script runs the tasks in the following order:

  • system tasks
  • install tasks
  • secrets tasks
  • deployment tasks
  • clone tasks

Run with the hostname as the only argument:

$ /path/to/dotfiles/tasks/ <hostname> script

The script runs the tasks in the following order:

  • system tasks
  • install tasks
  • secrets tasks
  • deployment tasks
  • clone tasks

Run without an argument:

$ /path/to/dotfiles/tasks/ 

The dotfiles/ Directory

This directory contains a set of dotfiles to install to set up the machine.

Run the script to copy these dotfiles into the home directory.

$ cd dotfiles
$ ./    # ask confirmation
$ ./ -f # do not ask confirmation

NOTE: This is run by the main tasks scripts. It should be manually re-run anytime your dotfiles change.

NOTE: On running the bootstrap script, any changes to your dotfiles in your home directory will be wiped out, so make sure you save any changes (or, make them to the dotfiles in the repository).

The crontab/ Directory

Contains regular user and sudo crontab files for various hosts.

Install by editing your crontab, crontab -e.

See crontab/

The services/ Directory

Contains startup services that can be installed.

  • dockerpod-charlesreid1.service - runs docker-compose pod running site

See services/

The motd/ Directory

Contains a special message of the day to display at login for each machine.

See motd/