In this guide you will learn how to set up the necessary requirements to self-host a Forem.
This guide is for self-host instances on MacOS.
In this step you’ll check to see if you have git installed on your machine. If it is not installed you will walk through the steps to install.
Go to your terminal on Mac.
- If it is not installed, download the latest version of Git for your Mac. here.
To confirm that your installation was successful type:
Note: Your version of Git may be different than in the example.
In this step you will install Homebrew, the package manager for MacOS. Many of the self-host requirements can be added with Homebrew after it is installed.
In your terminal see if Homebrew is already installed by typing:
If you see this error
brew: command not found you can install Homebrew with the following command in your terminal:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Note: this script will explain what it is doing and pause before it does it.
Make sure to watch your terminal for any instructions.
Homebrew may take a few minutes to install fully.
In this step you will check to see if Python is installed on your machine. If it is not installed you will walk through the steps to install it.
First, in your terminal check for Python with:
or check for pip3 with:
If you don't have Python 3 installed already, you can use Homebrew to install it.
In your terminal type the following command to install python:
brew install python3
Check that Python was installed correctly with:
Check that pip3 was also installed with:
Butane is a tool that consumes a Butane Config and produces an Ignition Config, which is a JSON document that can be given to a Fedora CoreOS machine when it first boots. In this step you will use Homebrew to install butane on your machine.
In your terminal type:
brew install butane
Check that Butane was installed correctly with:
Pwgen generates passwords that are secure and easy to memorize. In this step you will install pwgen with Homebrew. This will be used in the Quick Start guide to generate an Ansible Vault password.
In your terminal type:
brew install pwgen
You have now installed all of the requirements you need to start setting up a self-host instance of Forem.
Note: Ansible will be installed for you when you work through the Quick Start guide.
Please visit our Quick Start Guide to finish installing Forem.