- Installing CoPilot from a pre-built image
- Building CoPilot from source
Installing CoPilot from a pre-built image
Download latest release image
You can download the copilot 1.0 release image here: copilot-1.0-bbb.img.tar.gz
Decompress image file
There are a few ways to decompress the latest image file.
One option is to install 7-Zip, which has a nice graphical user interface. 7-Zip can also be used to unpack many other formats and to create tar files (amongst others).
- Download and install 7-Zip from 7-zip.org.
- Once it is installed if you double click on the copilot image file (copilot-1.0-bbb.img.tar.gz) 7-Zip should automatically start.
- If it does not automatically start you should be able to right-click on the copilot image file and choose the “extract here” option.
If you are on linux, OSX, or have MinGW/MSYS or Cygwin installed you can unpack the copilot image using the tar command.
tar -zxvf copilot-1.0-bbb.img.tar.gz
Write image to SD card
Once you have the image uncompressed you will need to write it to a micro SD card. Please follow the *very well written Raspberry-Pi SD card guides below based on your system.
When the installer exits you can remove the SD card and Follow the configuration instructions for running CoPilot.
Building CoPilot from source
Building CoPilot from source requires a linux device.
You will need to install Virtual Box. You can find Virtual Box’s downloads here.
You will need to install Vagrant. You can find Vagrant’s install instructions here.
You will need to install Git. You can find Git’s install instructions here.
On debian you can just run the following.
sudo apt-get install git-core
Start the installation by running the following commands.
git clone https://github.com/OpenInternet/copilot-install cd copilot-install ./install.sh
This will take you into the interactive command line installer.
Choose a custom copilot repository (optional)
Installing CoPilot... What admin password would you like CoPilot to use? Do not use the following characters "\$@ Password: Are you using a custom CoPilot Repository? [y/n]
If you answer y to this you will be able to choose a url to a git repository to pull your custom version of Copilot from. If you choose n it will use the default Copilot repository.
Here is an example of me providing the url to the primary Copilot git repo.
[y/n] y What URL should we use to download CoPilot? URL: https://github.com/OpenInternet/copilot.git
Choose a custom copilot plugin repository (optional)
Are you using custom plugins? [y/n]
If you answer y to this you will be able to choose a url to a git repository to pull your custom Copilot plugins. If you choose n it will use the default Copilot plugin repository.
Here is an example of me providing the url to the primary Copilot plugin git repo.
[y/n] y What URL should we use for getting the plugins? URL: https://github.com/OpenInternet/copilot-plugins.git
Here is an example of me telling copilot to use the master branch of the Copilot plugin repo.
What branch should we use in the plugin repo? (default 'master') Branch: master
Installation takes a long time. Depending upon your device it can take as long as an hour.
At the end of a process the installer will ask you if you want to install the image you have created onto an SD card.
Completed Installation Process... Would you like to install CoPilot directly onto a SD card? [y/n]
If you answer y to this it will write the image to the chosen SD card. To do this you will need to get the device name of the SD card. The example below is me writing my latest image to an SD card.
[y/n] y What is the path to your SD cards device Device Path: /dev/mmcblk0 Starting Install... This will take a while. [sudo] password for user:
When the installer exits you can remove the SD card and Follow the setup instructions for running CoPilot.