# Install Wagtail on MacOS
## Install Homebrew
First, install Homebrew, which is a package manager for macOS. Open Terminal and paste the following command:
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
## Install Python and Pip
Wagtail requires Python. Install it using Homebrew:
```bash
brew install python3
```
## Create a Virtual Environment
Create a directory for your Wagtail project and navigate into it:
```bash
mkdir my_wagtail_project
cd my_wagtail_project
```
Now, create a virtual environment:
```bash
python3 -m venv .venv
```
Activate the virtual environment:
```bash
source .venv/bin/activate
```
## Install Wagtail
Install Wagtail using pip:
```bash
pip install wagtail
```
## Create a Wagtail Project
Create a new Wagtail project:
```bash
wagtail start blog .
```
Navigate into your new Wagtail site:
```bash
cd blog
```
## Install Dependencies
Install the required packages:
```bash
pip install -r requirements.txt
```
## Initialize Database
Initialize the database (it uses SQLite by default):
```bash
./manage.py migrate
```
## Create an Admin User
Create an admin user to manage the CMS:
```bash
./manage.py createsuperuser
```
Follow the prompts to create a user.
## Run Development Server
Run the development server:
```bash
./manage.py runserver
```
You should see output that says the development server is running. Open your web browser and go to `http://127.0.0.1:8000/` to see your new Wagtail site.
# Install Wagtail on Windows
## Install Python and Pip
1. **Download Python**: Go to the [official Python website](https://www.python.org/downloads/windows/) and download the installer.
2. **Install Python**: Run the installer. Make sure to check the box that says "Add Python to PATH" during installation.
## Open Command Prompt
Open a Command Prompt window. You can do this by searching for "cmd" in the Start menu.
## Create a Virtual Environment
1. Create a new directory for your Wagtail project and navigate into it:
```cmd
mkdir my_wagtail_project
cd my_wagtail_project
```
2. Create a virtual environment:
```cmd
python -m venv venv
```
3. Activate the virtual environment:
```cmd
.\venv\Scripts\activate
```
## Install Wagtail
Install Wagtail using pip:
```cmd
pip install wagtail
```
## Create a Wagtail Project
1. Create a new Wagtail project:
```cmd
wagtail start mysite
```
2. Navigate into your new Wagtail site:
```cmd
cd mysite
```
## Install Dependencies
Install the required packages:
```cmd
pip install -r requirements.txt
```
## Initialize Database
Initialize the database (SQLite by default):
```cmd
python manage.py migrate
```
## Create an Admin User
Create an admin user for the CMS:
```cmd
python manage.py createsuperuser
```
Follow the prompts to create your user.
## Run Development Server
Run the development server:
```cmd
python manage.py runserver
```
Your development server should start. Open your web browser and go to `http://127.0.0.1:8000/` to see your new Wagtail site.
---
And that's it! You should have a working Wagtail CMS on your Windows machine. To access the admin interface, just go to `http://127.0.0.1:8000/admin` and log in with the superuser credentials.