de-intern-guide/docs/onboarding/setup-overview.mdx

29 lines
3.1 KiB
Text

---
sidebar_position: 1
---
# 🗺 Setup Overview
Before you start diving into awesome projects and working with your team, you'll need the right equipment 🛠💼.
Refer to the upcoming sections to help you install everything. For now, let's take a look at the cool tools you'll be setting up 🤘!
## 😎 Cool Tools!
| Software/Tool | Description |
| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [VirtualBox](https://www.virtualbox.org/) | VirtualBox is a virtualization software that allows you to run a virtual machine on your computer. Simply put, this program lets you have virtual computers inside your computer! |
| [Ubuntu](https://ubuntu.com/) | Ubuntu is a free and open-source operating system. It is a Linux distribution and is often useful for running on virtual machines. |
| [qsv](https://github.com/jqnatividad/qsv) | qsv (pronounced "Quicksilver") is a command line program for indexing, slicing, analyzing, filtering, enriching, validating & joining CSV files. Commands are simple, fast & composable. |
| [CKAN](https://ckan.org) | CKAN is an open-source DMS (data management system) for powering data hubs and data portals. CKAN makes it easy to publish, share, and use data. It powers hundreds of data portals worldwide. |
| [DataPusher+ with Docker](https://github.com/dathere/datapusher-plus-docker) | [DataPusher+](https://github.com/dathere/datapusher-plus) is standalone web service that pushes data into the CKAN DataStore fast & reliably. We'll be setting up a containerized version of DataPusher+ by using [Docker](https://www.docker.com/). |
## 🧩 Putting It All Together
We'll use VirtualBox to create a virtual machine (VM) running Ubuntu. On your VM you can use and contribute to qsv, CKAN (including CKAN extensions), DataPusher+, and much more! 🚀
:::info One more thing! 🎈
Though using a VM is not required and you can do development on your own setup, the guide will cover running an Ubuntu guest OS through a VM using VirtualBox on a Windows 10 host OS. If you're using a different setup (such as a different host OS), you may need to adjust your steps accordingly.
:::