Getting started

  1. Install required tools
  2. Choose a training
  3. Start the pre-configured VirtualMachine
  4. Read the objectives and implement them
  5. Run admindojo check to verify your solution
  6. Track your progress at admindojo.org(optional)

Install required tools

  1. install VirtualBox
  2. install Vagrant
  3. install git
  4. clone the training-repository git clone https://github.com/admindojo/admindojo-trainings.git

(Requirements: Windows/Mac/Linux, 10-20GB SSD, 2GB RAM, internet)

Start training

  1. Open Powershell(Windows) or Terminal(Mac&Linux)
  2. Go into the cloned repository
  3. Go to a training directory
    • e.g. cd webserver-apache-basic-1-ub18
  4. Type vagrant up
    • Vagrant will now build the VM. The first run can take a while
  5. Type vagrant ssh
    • You're now inside the VM and can start the training
  6. Run admindojo for instructions

Track progress at admindojo.org

To track your progress online, you'll get a token after completing a training. Go to challenges, open a training and submit the token.

Nice to know

Starting and rebooting the VM differs from normal operation because admindōjō utilizes Vagrant:

  • Use vagrant ssh to login/jump into the VM
  • Exit the VM with cms+D or exit
  • To reboot the VM, please use the command vagrant reload from inside the training directory on your host
  • To shutdown the VM, please use the command vagrant halt from inside the training directory on your host

Username and password

Your user with sudo permission:

  • username: vagrant
  • password: vagrant

Reset/Delete VM

  • reset VM
    1. exit the VM with cmd+D or exit
    2. inside training directory: vagrant destroy (VM needs to be running)
    3. start again: vagrant up
  • delete VM
    1. exit the VM with cmd+D or exit
    2. inside training directory: vagrant destroy (VM needs to be running)

Update trainings/Download latest trainings

  1. Open Powershell(Windows) or Terminal(Mac&Linux)
  2. Change into cloned repository
  3. run git pull

For advanced users

In case you are familiar with vagrant and ssh you can SSH directly to your admindojo box(SSH could require changes to the Vagrantfile depending on the Box Version).

Since admindōjō uses real-world tools under the hood you're able to use their native functions: