Introduction
BookWyrm is an open-source, federated book reading platform that allows users to discover, read, and discuss books. This guide will walk you through the process of installing BookWyrm on Debian 12.
Prerequisites
Before you begin, ensure you have:
- A Debian 12 server or desktop system
- Root or sudo privileges
- Python 3.7 or later installed
- Git installed
- A domain name pointing to your server (optional)
Step 1: Install Dependencies
Update the package index and install required dependencies:
sudo apt update
sudo apt install -y python3-pip python3-venv git build-essential libpq-dev python3-dev
Step 2: Clone BookWyrm Repository
Clone the BookWyrm repository from GitHub:
git clone https://github.com/bookwyrm-social/bookwyrm.git
cd bookwyrm
Step 3: Set Up Virtual Environment
Create a virtual environment for BookWyrm:
python3 -m venv venv
source venv/bin/activate
Step 4: Install Python Dependencies
Install Python dependencies using pip:
pip install -r requirements.txt
Step 5: Configure BookWyrm
Create a local settings file and set up the database:
cp bookwyrm/settings/local.py.example bookwyrm/settings/local.py
python manage.py migrate
python manage.py collectstatic
Step 6: Create Superuser
Create a superuser for the BookWyrm instance:
python manage.py createsuperuser
Step 7: Run BookWyrm
Run the BookWyrm development server:
python manage.py runserver 0.0.0.0:8000
Step 8: Access BookWyrm
Access BookWyrm by navigating to your server's IP address or domain name in a web browser, followed by port 8000 (e.g., http://your_domain_or_ip:8000
).
Conclusion
Congratulations! You have successfully installed BookWyrm on Debian 12. You can now start using BookWyrm to discover, read, and discuss books.