add server setup docs

Author: splitbrain

README.md

@@ -1,4 +1,5 @@
 # ![Meh Logo](meh.svg) Meh…
+
 ## …another comment system
 
 Meh…
@@ -16,43 +17,62 @@ Meh…
 
 Meh is a commenting system with a client-server architecture:
 
-- **Server Component**: A PHP backend that handles comment storage (in SQLite), moderation, and API endpoints. It can be installed on your own server and supports multiple sites from a single installation.
+- **Server Component**: A PHP backend that handles comment storage (in SQLite), moderation, and API endpoints. It can be
+  installed on your own server and supports multiple sites from a single installation.
 
-- **Client Components**: A set of web components (custom HTML elements) that can be embedded in any website to display and submit comments. These components communicate with the server via a REST API.
+- **Client Components**: A set of web components (custom HTML elements) that can be embedded in any website to display
+  and submit comments. These components communicate with the server via a REST API.
 
-## Devel Quick Start
+## Quick Start
 
-You can use this to get a development environment up and running quickly. This is not suitable for production use. But should answer all your questions about how Meh works.
+A quick and dirty way to get started is to use the built-in PHP server on your local machine.
 
-    cd backend
-    composer install
-    cd ../frontend
-    npm install
-    npm run build
-    cd ..
-    cp .env.example .env
-    $EDITOR .env
-    ./meh migrate
-    php -s localhost:8000 -t public
+```bash
+cd backend
+composer install
+cd ../frontend
+npm install
+npm run build
+cd ..
+cp .env.example .env
+$EDITOR .env
+./meh migrate
+php -s localhost:8000 -t public
+```
 
-You can then use `http://localhost:8000/` as the base URL for all components.
+You can now browse this documentation at `http://localhost:8000`. It will also serve the Meh components and the API.
 
-## Server Setup
+In your blog, add the following to your HTML:
+
+```html
+<!-- Add a comment form -->
+<script type="module" src="http://localhost:8000/meh/meh.esm.js"></script>
+
+<meh-form>
+    <meh-mastodon></meh-mastodon>
+    <meh-login></meh-login>
+</meh-form>
+<meh-comments></meh-comments>
+```
 
+This should give you a rough idea how Meh works. For a production setup, you should point your web server at the public.
+
+More details on how to set up the server can be found in the [Server Setup](doc/server.md) section.
+
+## Server Setup
 
 * [Command Line Tool](doc/cli.md)
-* [Database Setup and Upgrade](doc/migrate.md) 
+* [Database Setup and Upgrade](doc/migrate.md)
 * [Configuration](doc/config.md)
 * [Multi-site Support](doc/multisite.md)
 * [Mastodon Integration](doc/mastodon.md)
 * [Email Notifications](doc/smtp.md)
 * [Gravatar Integration](doc/gravatar.md)
 * [Importing from Disqus](doc/disqus.md)
 
-
 ## Client Setup and Usage (on your blog)
 
 * [Component Setup](doc/components.md)
-  * [Styling Components](doc/styling.md)
+    * [Styling Components](doc/styling.md)
 * [Comment Moderation](doc/moderation.md)
 * [Customizing Translations](doc/translations.md)

doc/server.md

@@ -0,0 +1,97 @@
+# Server Setup
+
+There are different ways to get Meh up and running. You can use Docker, Docker Compose, or set it up manually on your server.
+
+## Using Docker
+
+Meh is available as a Docker image for easy deployment. It's based on the official PHP image and includes everything you need to run Meh.
+
+Images are available on the [GitHub Container Registry (GHCR)](https://github.com/splitbrain/meh/pkgs/container/meh) and [Docker Hub](https://hub.docker.com/r/splitbrain/meh).
+
+To start the container use:
+
+```bash
+docker run --name meh -p 8080:80 -v meh-data:/app/data splitbrain/meh:latest
+```
+
+To run the [command line tool](cli.md) use:
+
+```bash
+docker exec meh /app/meh
+```
+
+Use the [command line tool](cli.md) to [initialize the database](migrate.md) and configure your installation. [Configuration](configuration.md) can also be done via environment variables.
+
+
+## Using Docker Compose
+
+Docker Compose makes it easy to define and manage your Meh deployment configuration. Here's a minimal example:
+
+```yaml
+services:
+  meh:
+    image: splitbrain/meh:latest
+    ports:
+      - "8080:80"
+    volumes:
+      - ./data:/app/data
+    restart: unless-stopped
+```
+
+Start the container with:
+
+```bash
+docker-compose up -d
+```
+
+To run the [command line tool](cli.md) use:
+
+```bash
+docker-compose exec meh /app/meh
+```
+
+Use the [command line tool](cli.md) to [initialize the database](migrate.md) and configure your installation. [Configuration](configuration.md) can also be done via environment variables.
+
+## Manual Setup
+
+Of course, you can run the whole thing the classical way.
+
+### Requirements
+
+- PHP 8.1 or higher
+- SQLite extension for PHP
+- Composer (for installation)
+- Node.js and npm (for building the frontend)
+- Web server (Apache, Nginx, etc.)
+
+### Installation Steps
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/splitbrain/meh.git
+   cd meh
+   ```
+
+2. Install backend dependencies:
+   ```bash
+   cd backend
+   composer install --no-dev
+   cd ..
+   ```
+
+3. Build the frontend:
+   ```bash
+   cd frontend
+   npm install
+   npm run build
+   cd ..
+   ```
+
+4. Point your web server to the `public` directory
+
+Use the [command line tool](cli.md) to [initialize the database](migrate.md) and configure your installation. [Configuration](configuration.md) can also be done via environment variables.
+
+
+### URL Rewriting
+
+Meh requires URL rewriting to work correctly. There's a `.htaccess` file included that handles this for Apache. For other web servers, you need to configure URL rewriting manually.