Jump to content

Wmf-laptop

From Wikitech

wmf-laptop is a Debian package which simplifies SSH access to Wikimedia production servers:

  • It ships README files and example configs for the initial setup of git/Gerrit and SSH with separate agents for production and Cloud VPS
  • It includes wmf-update-known-hosts-production, a tool which syncs SSH known_host data for production
  • it includes tunnelencabulator (https://github.com/cdanis/tunnelencabulator)
  • It includes pwstore (https://wikitech.wikimedia.org/wiki/Pwstore, only relevant for Wikimedia SRE members)
  • It also pulls in packages that you'll need as dependencies.

wmf-laptop can be used on any Debian version (and derived distros).

It's available on our internal repository. The source is in the operations/debs/wmf-sre-laptop repository. The package will generally work on all Debian-based distros (so also Ubuntu or Mint e.g.).

  • First of all you need to install the repository key for apt.wikimedia.org, it's documented here: APT repository#Security
  • Then create a file under /etc/apt/sources.list.d/ called something like wikimedia.list containing the following:
 deb http://apt.wikimedia.org/wikimedia bookworm-wikimedia component/wmf-laptop
  • Then apt install wmf-laptop it will pull in a few packages you'll need as well.
  • /usr/share/doc/wmf-laptop/README contains documentation on how to setup git, SSH and pwstore access (the latter only relevant for Wikimedia SRE staff).
# quick install steps
sudo wget -O /etc/apt/trusted.gpg.d/wikimedia-apt-key.asc "https://wikitech.wikimedia.org/w/index.php?title=APT_repository/Stretch-Key&action=raw"
echo "deb http://apt.wikimedia.org/wikimedia bookworm-wikimedia component/wmf-laptop" | sudo tee /etc/apt/sources.list.d/wmf-laptop.list
sudo apt update
sudo apt install wmf-laptop