Tools Used

• GoPro MAX 360 Camera
• SD Card
• SD Card Reader
• Raspberry Pi 4
• Internet Connection

See also

• How to upload a video to Mapillary via Oracle Cloud Infrastructure using this configuration.

Installation & Configuration

1. Open terminal.
2. Create a hidden ssh directory and a directory to store your keys for this setup.
   • mkdir ~/.ssh && mkdir ~/.ssh/oracle_mapillary_keys
3. Open a web browser and navigate to Oracle Cloud Infrastructure.
4. Login to Oracle Cloud Infrastructure.
5. Navigate to Compute > Instances in the hamburger menu.
6. On the left panel, select compartment name you chose during signup if not automatically applied.
7. Select Create Instance from the center panel of the screen.
8. Fill in the following settings:
   • Name: “Mapillary”.
   • Placement: use default values.
   • Security: use default values.
   • Image & Shape:
     1. Click edit on the right hand side of Image & Shape panel.
     2. Under Shape click Change shape.
     3. Use the following settings:
        • Instance Type: use default values.
        • Shape Series: Specialty and previous generation.
        • Image: VM.Standard.E2.1.Micro
     4. Choose Select Shape on the bottom of the dialog box.
   • Primary VNIC Information: use default values.
   • Add SSH Keys: IMPORTANT: Download Private and Public keys.
   • Boot Volume: use default values.
   • Block Volumes: use default values.
   • Live Migration: use default values.
9. On the bottom of the page, select Create.
10. Wait for the status on the left to turn green and say “RUNNING”.
11. Under Instance Access, click copy or copy the public IP address provided.
12. Return to the terminal and move your downloaded keys to your specific folder created earlier, and change permission level for your private key.
    • mv ~/Downloads/[your private & public keys] ~/.ssh/oracle_mapillary_keys/ && chmod 600 ~/.ssh/oracle_mapillary_keys/[your private key (not .pub)]
13. Test your ssh connection to Oracle. When prompted to continue, type yes.
    • ssh -i ~/.ssh/oracle_mapillary_keys/[your private key (not .pub)] opc@[IP Address copied from Oracle]
14. Update pip and install mapillary tools. Limit to no cache due to low RAM on this configuration.
    • pip3 install –user –no-cache-dir –upgrade pip && pip3 install –user –no-cache-dir mapillary_tools
15. Add local bin to PATH.
    • echo ‘export PATH=$PATH:~/.local/bin’ >> ~/.bashrc source ~/.bashrc
16. Optionally: verify Mapillary is installed.
    • mapillaary_tools --version.
17. Authenticate your Mapillary account with your username, email, and password.
    • mapillary_tools authenticate
18. Create a Mapillary folder on your Oracle instance.
    • mkdir -p ~/mapillary