Prerequisites
- PHP 8.0 or higher - MySQL 5.7+ or MariaDB 10.3+ - A web server (Apache or Nginx) - At least 100 MB of storage space
Installation
1. Upload files
Download the latest release and extract it to your web directory:
```bash unzip owp-web-app-latest.zip -d /var/www/webapp ```
2. Set up the database
Create a database for the web app:
```sql CREATE DATABASE owp_web CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'owp_web_user'@'localhost' IDENTIFIED BY 'your_password'; GRANT ALL PRIVILEGES ON owp_web.* TO 'owp_web_user'@'localhost'; FLUSH PRIVILEGES; ```
3. Configuration
Copy the example configuration and customize it:
```bash cp config.example.php config.php ```
Enter the database credentials and your domain.
4. Configure web server
Make sure your web server points to the `public` directory. Enable URL rewriting for clean URLs.
5. Run setup
Open your domain in the browser and follow the installation wizard. It will guide you through database setup, admin account creation, and basic settings.
Publishing stories
Create a new book
Navigate to "Books" in the dashboard and click "New Book". Enter a title, description, and optionally a cover image.
Add chapters
Within a book project, you can create chapters and edit them in the integrated editor. The editor supports Markdown and a visual formatting toolbar.
Publish
Set individual chapters or the entire book to "Published" so readers can access them. You can switch between draft and published at any time.
Import from the desktop app
Export your book from the desktop app as EPUB or Markdown and import it via "Books > Import" in the web app. The chapter structure is automatically preserved.