This tutorial will guide you through the process of installing WBO on the latest version of Debian. WBO is a web-based annotation tool that enables users to markup and annotate PDF files.
Before we begin, make sure that your system is up-to-date by running the following command as the root user:
apt-get update && apt-get upgrade -y
Also, make sure that you have installed the following dependencies:
First, you need to download WBO from GitHub. You can do this by running the following command:
git clone https://github.com/lovasoa/whitebophir.git
This will download the WBO code in the current directory.
Once you have downloaded the WBO code, navigate to the whitebophir
directory and install the required PHP packages by running the following command:
composer install
Next, we need to create a virtual host to serve the WBO application. To do this, open the following file using your preferred text editor:
/etc/apache2/sites-available/000-default.conf
Add the following lines before the </VirtualHost>
tag:
Alias /wbo /path/to/whitebophir/web
<Directory /path/to/whitebophir/web>
AllowOverride All
Order Allow,Deny
Allow from All
Require all granted
</Directory>
Replace /path/to/whitebophir
with the actual path where you downloaded WBO in step 1.
Save and close the file.
Now, we need to enable the virtual host by running the following command:
a2ensite 000-default.conf
Restart the Apache server by running:
systemctl restart apache2
Before we can use WBO, we need to create a MySQL database. Connect to your MySQL server and run the following commands:
CREATE DATABASE wbo;
GRANT ALL PRIVILEGES ON wbo.* TO 'wbo_user'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
Replace 'password'
with a strong password of your choice.
Next, we need to configure WBO by creating the app/config/parameters.yml
file. Navigate to the app/config
directory and copy the parameters.yml.dist
file to parameters.yml
:
cd whitebophir/app/config
cp parameters.yml.dist parameters.yml
Open the parameters.yml
file using your preferred text editor, and change the database settings as follows:
database_host: localhost
database_port: null
database_name: wbo
database_user: wbo_user
database_password: password
Replace 'password'
with the MySQL password you set in step 5.
Now, we need to populate the WBO database with the required tables by running the following command:
php bin/console doctrine:schema:update --force
Finally, open your web browser and navigate to http://localhost/wbo
. You should see the WBO annotation tool.
Congratulations! You have successfully installed WBO on Debian Latest. You can now use WBO to annotate and markup your PDF files.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
Alternatively, for the best virtual desktop, try Shells!