Skip to content

setup.md

Latest commit

 

History

History
32 lines (29 loc) · 2.49 KB

setup.md

File metadata and controls

32 lines (29 loc) · 2.49 KB
Raw

Setting up the FarmData2 Development Environment

When the FarmData2 Development Environment is created for the first time it requires some more setup. Use the following steps to perform this setup.

Within the FarmData2 Development Environment:

  1. Open a terminal from the dock at the bottom of the window.
  2. Use the ls command and notice that there is a directory with the same name as your fork of FarmData2. This directory is a clone of your fork of FarmData2 that GitPod made when you created the workspace.
  3. cd into this directory.
  4. Run the following command: setup.bash
    • This script will install all the dependencies, configure the FarmData2 Development Environment for use and build the FarmData2 project. If you want to know exactly what the script is doing you can examine the source code in bin/setup.bash.
      1. When "Configuring git information" you will be prompted for your "Name" and "Email." Give the name and email that you want to have associated with your commits on GitHub.
      2. When "Authenticating with GitHub" the following is the recommended approach:
        1. Choose "HTTPS" as the preferred protocol git Operations on this host.
        2. Respond "Yes" to authenticating Git with your GitHub credentials.
        3. Choose "Paste an authentication token" when asked how you want to authenticate GitHub CLI.
        4. Copy your GitHub token to the Clipboard
        5. Paste it into the "NoVNC Clipboard" using the tool palate at the left of the window.
        6. Use "Ctrl-Shift-V" to paste the token into the terminal and press enter.
  5. Open the Mozilla Firefox web browser from the dock at the bottom of the Linux desktop.
  6. Visit the URL:
  7. You will see an "Access Denied" message.
  8. Log in to FarmOS by using the credentials:
    • Username: manager1
    • Password: farmdata2
  9. Check that the FarmData2, FD2 Examples and FD2 School menu options appear in the farmOS menu.
    • Depending on the size of the MozillaFirefox window the farmOS menu might appear on the left, or you might need to click the "more options" icon (☰) in the top left corner of the window to display it.
  10. Open the VSCodium IDE from the dock at the bottom of the Linux desktop.
    1. Open your FarmData2 folder
    2. Check "Trust the authors of all files in the parent folder fd2dev"
    3. Click "Yes, I trust the authors"