Home
build details

Show: section status errors & todos local changes recent changes last change in-page changes feedback controls

Laptop Setup

Modified 2018-10-02 by Andrea Censi

Andrea Censi

previous task next (5 of 33) index
task

The following was marked as "special-par-assigned".

Andrea Censi

File book/opmanual_duckiebot/atoms_17_operation_manual_duckiebot/0_5_0_laptop.md.

File book/opmanual_duckiebot/atoms_17_operation_manual_duckiebot/0_5_0_laptop.md
in repo duckietown/docs-opmanual_duckiebot branch master18 commit 9a5d09dc
last modified by Liam Paull on 2019-02-27 18:53:41

Created by function create_notes_from_elements in module mcdp_docs.task_markers.

This page is for the DB18 configuration used in classes in 2018.

For last year’s instructions, see here.

A laptop with free disk space.

Internet connection.

About 10 minutes.

A laptop ready to be used for Duckietown.

Minimal Laptop Requirements

Modified 2018-09-27 by Andrea Censi

These installation steps make sure that you have a minimal “sane” environment, which includes:

  1. Git and Git LFS;
  2. Docker;
  3. The Duckietown Shell.

Native installation vs virtual machines

Modified 2018-10-17 by Aleksandar Petrov

Having Ubuntu installed natively on your laptop is recommended but not strictly required.

If you are running Ubuntu in a VM make sure that you are using a Bridged network adapter (for example VirtualBox uses NAT by default). This allows you to be on the same subnetwork as your Duckiebot.

Sometimes when running a VMware machine in a Mac OS host, it is neccessary to have two network adapters: Share with my Mac for connecting to the internet and Bridged Networking for connecting to the Duckiebot.

TODO: give some pointers for VM.

previous task next (6 of 33) index
task

The following was marked as "todo".

TODO: give some pointers for VM.

File book/opmanual_duckiebot/atoms_17_operation_manual_duckiebot/0_5_0_laptop.md.

File book/opmanual_duckiebot/atoms_17_operation_manual_duckiebot/0_5_0_laptop.md
in repo duckietown/docs-opmanual_duckiebot branch master18 commit 9a5d09dc
last modified by Liam Paull on 2019-02-27 18:53:41

Created by function create_notes_from_elements in module mcdp_docs.task_markers.

Setup for Ubuntu 18

Modified 2018-09-27 by Andrea Censi

System installation

Modified 2018-09-27 by Andrea Censi

Install Ubuntu 18.

For instructions, see for example this online tutorial.

Basic dependencies

Modified 2018-10-04 by Russell Buchanan

Installs pip, git, git-lfs, curl, wget:

laptop $ sudo apt install -y python-pip git git-lfs curl wget

Docker

Modified 2019-02-27 by Liam Paull

Install Docker by following the instructions here.

Adds user to “docker” group:

laptop $ sudo adduser `whoami` docker

you need to log out and in for the group change take effect.

Duckietown Shell

Modified 2019-02-25 by Liam Paull

To install the Duckietown shell, use:

laptop $ pip install --user --no-cache-dir -U duckietown-shell

Edit the file ~/.profile and add the line:

export PATH=~/.local/bin:$PATH

do not use sudo pip to install the Duckietown Shell.

for Mac users this path will be different, probably something like ~/Library/Python/2.7/bin

Log out and in. This command should succeed:

laptop $ dts version

Setting up Mac OS X

Modified 2018-09-27 by Andrea Censi

Assigned to: Liam

this configuration is not officially supported.

Basic dependencies

Modified 2018-09-27 by Andrea Censi

You will need to find the instructions for git, git-lfs.

Quartz

Modified 2018-09-27 by liampaull

You will also need the latest version of XQuartz.

You can install using brew as follows:

laptop $ brew cask install xquartz

Or, download from here and follow the instructions.

After installing XQuartz, run it in the command line with:

laptop $ open -a XQuartz

Go to “Preferences” and in the security tab make sure that the checkbox next to “Allow” connections from network clients is set.

It is also recommended that you add the following lines to your .bashrc file:

export IP=$(ifconfig en0 | grep inet | awk '$1=="inet" {print $2}')
xhost +$IP

These will find your IP and then allow incoming connections to it in order to be able to popup windows from within docker containers.

Alternatively, you can run them each time before you want to use X11 forwarding.

Docker

Modified 2018-09-27 by liampaull

Follow these instructions

Duckietown Shell

Modified 2018-09-27 by Andrea Censi

To install the Duckietown shell, use:

laptop $ pip install --user --no-cache-dir -U duckietown-shell

Edit the file ~/.profile and add the line:

export PATH=~/.local/bin:$PATH

do not use sudo pip to install the Duckietown Shell.

Log out and in. This command should succeed:

laptop $ dts version

Setup for Ubuntu 16.04

Modified 2018-09-27 by Andrea Censi

It is suggested to use Ubuntu 18.

System installation

Modified 2018-09-27 by Andrea Censi

Install Ubuntu 16.04.3.

For instructions, see for example this online tutorial.

On the choice of username: During the installation, create a user for yourself with a username different from ubuntu, which is the default. Otherwise, you may get confused later.

Basic dependencies

Modified 2018-09-27 by Andrea Censi

Installs pip, git, git-lfs, docker, duckietown-shell:

laptop $ sudo apt-get install software-properties-common  curl
laptop $ sudo add-apt-repository ppa:git-core/ppa
laptop $ curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash
laptop $ sudo apt-get install -y python-pip git git-lfs

Docker

Modified 2018-09-27 by Andrea Censi

laptop $ curl -fsSL https://get.docker.com | sudo bash
laptop $ sudo usermod -aG docker `whoami`

you need to log in and out to have the group change take effect.

Duckietown Shell

Modified 2018-09-27 by Andrea Censi

Install the Duckietown Shell using:

laptop $ pip install --no-cache-dir -U --user duckietown-shell

Edit the file ~/.profile and add the line:

export PATH=~/.local/bin:$PATH

do not use sudo pip to install the Duckietown Shell.

Log out and in. This command should succeed:

laptop $ dts version
Because of mathjax bug

No questions found. You can ask a question on the website.