OpenC3/cosmos

---
title: Host Install
---

## Installing COSMOS Directly onto a Host (No Containers)

Note: THIS IS NOT A RECOMMENDED CONFIGURATION.

COSMOS 5 is released as containers and intended to be run as containers. However, for various reasons someone might want to run COSMOS directly on a host. These instructions will walk through getting COSMOS 5 installed and running directly on RHEL 7 or Centos 7. This configuration will create a working install, but falls short of the ideal in that it does not setup the COSMOS processes as proper services on the host OS (that restart themselves on boot, and maintain themselves running in case of errors). Contributions that add that functionality are welcome.

Let's get started.

1. The starting assumption is that you have a fresh install of either RHEL 7 or Centos 7. You are running as a normal user that has sudo permissions, and has git installed.

2. Start by downloading the latest working version of COSMOS from Github

   ```bash
   cd ~
   git clone https://github.com/openc3/cosmos.git
   ```

3. Run the COSMOS installation script

   If you are feeling brave, you can run the one large installer script that installs everything in one step:

   ```bash
   cd cosmos/examples/hostinstall/centos7
   ./openc3_install.sh
   ```

   Or, you may want to break it down to the same steps that are in that script, and make sure each individual step is successful:

   ```bash
   cd cosmos/examples/hostinstall/centos7
   ./openc3_install_packages.sh
   ./openc3_install_ruby.sh
   ./openc3_install_redis.sh
   ./openc3_install_minio.sh
   ./openc3_install_traefik.sh
   ./openc3_install_openc3.sh
   ./openc3_start_services.sh
   ./openc3_first_init.sh
   ```

4. If all was successful, you should be able to open Firefox, and goto: http://localhost:2900. Congrats you have COSMOS running directly on a host.

5. As stated at the beginning, this is not currently a supported configuration. Contributions that help to improve it are welcome.