Prerequisites
Before installing the sync server, make sure the following requirements are met:
- PHP 8.0 or higher - MySQL 5.7+ or MariaDB 10.3+ - A web server (Apache or Nginx) - A custom domain or subdomain (e.g., `sync.mydomain.com`) - SSL certificate (recommended, e.g., via Let's Encrypt)
Installation
1. Upload files
Download the latest release from the download page and extract the files to your server's web directory:
```bash unzip owp-sync-server-latest.zip -d /var/www/sync ```
2. Set up the database
Create a new database and user for the sync server:
```sql CREATE DATABASE owp_sync CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'owp_user'@'localhost' IDENTIFIED BY 'your_secure_password'; GRANT ALL PRIVILEGES ON owp_sync.* TO 'owp_user'@'localhost'; FLUSH PRIVILEGES; ```
3. Configure settings
Copy the example configuration and update the database credentials:
```bash cp config.example.php config.php ```
Edit `config.php` and enter your database details:
```php define('DB_HOST', 'localhost'); define('DB_NAME', 'owp_sync'); define('DB_USER', 'owp_user'); define('DB_PASS', 'your_secure_password'); ```
4. Configure your domain
Point your domain or subdomain to the installation directory. For Apache, create a VirtualHost:
```apache <VirtualHost *:443> ServerName sync.mydomain.com DocumentRoot /var/www/sync/public SSLEngine on SSLCertificateFile /etc/letsencrypt/live/sync.mydomain.com/fullchain.pem SSLCertificateKeyFile /etc/letsencrypt/live/sync.mydomain.com/privkey.pem </VirtualHost> ```
5. Run setup
Open `https://sync.mydomain.com/setup` in your browser. The installation wizard will automatically create all required database tables and set up an admin user.
Next steps
After installation, you can connect the desktop app and BuchNotizApp to the server. See the articles on Sync Configuration and Setting Up the Mobile App.