Skip to content

Development

Docker

Ubuntu Server Image

The ubuntu-server image may be used to help develop the repo.

task venv
docker run -it --rm --entrypoint /bin/bash -u ubuntu -w /home/ubuntu nicholaswilde/ubuntu-server:22.10

The default username and password for the ubuntu-server image is as follows:

Username Password
ubuntu ubuntu

Note

At the time of this writing, the ubuntu-server image only has tags for 20.10.

Official Ubuntu Image

The official Ubuntu image may also be used to test the repo.

docker run -it --rm --entrypoint /bin/bash ubuntu:22.10
From inside Docker
(
  export DEBIAN_FRONTEND=noninteractive
  apt update
  apt install -y ubuntu-server sudo
  adduser ubuntu
  echo "ubuntu:ubuntu" | chpasswd
  usermod -aG sudo ubuntu
  su ubuntu
  cd ~
)

Note

The above changes are lost once the docker container is exited.

MkDocs & MkDocs Material

An MkDocs server may be used to serve the dotfiles2 site. MkDocs Material is also required to render the server properly.

task serve
mkdocs serve