How to Install Raneto on Void Linux

This tutorial will guide you through the installation of Raneto on Void Linux. Raneto is a free, open-source, and simple flat-file wiki system that runs on Node.js.

Prerequisites

Before you start with the installation, ensure that the following prerequisites are met:

• A non-root user account with sudo privileges
• Node.js and npm package manager installed

Step 1: Installing Raneto

1. First, you need to create a new directory where you will download the Raneto files:

   $ mkdir raneto
   

2. Change your current working directory to the created directory:

   $ cd raneto
   

3. Install Raneto using npm:

   $ npm install raneto
   

Step 2: Configuration

1. Create a new directory for your Raneto files:

   $ mkdir -p /var/www/raneto
   

2. Copy the default configuration file:

   $ cp -R ./node_modules/raneto/config.default/* /var/www/raneto/
   

3. Edit the configuration file:

   $ sudo nano /var/www/raneto/config.production.json
   

4. Configure the settings according to your needs.

   Here is an example of how the configuration file may look like:

   {
     "site_title": "My Wiki",
     "lang": "en_US",
     "articles_dir": "/var/www/raneto/content/",
     "table_of_contents": true
   }
   

5. Save and close the file.

6. To make the configuration file accessible to Raneto, you need to change the ownership of the directory:

   $ sudo chown -R www-data:www-data /var/www/raneto/
   

Step 3: Running Raneto

1. You can start Raneto by running the following command:

   $ node_modules/raneto/app.js
   

2. When Raneto is running, open a web browser and navigate to http://localhost:3000/ to access the Raneto wiki site.

3. You can stop the Raneto server by pressing Ctrl + C.

Step 4: Running Raneto as a Service

1. Create a new file for the systemd unit file:

   $ sudo nano /etc/systemd/system/raneto.service
   

2. Paste the following configuration:

   [Unit]
   Description=Raneto Wiki
   
   [Service]
   ExecStart=/usr/bin/node /path/to/raneto/node_modules/raneto/app.js
   Restart=always
   User=www-data
   Group=www-data
   Environment=NODE_ENV=production
   
   [Install]
   WantedBy=multi-user.target
   

3. Save and close the file.

4. Enable and start the systemd service:

   $ sudo systemctl enable raneto.service
   $ sudo systemctl start raneto.service
   

5. Verify that the service is running:

   $ sudo systemctl status raneto.service
   

   The output should show that the service is active and running.

Conclusion

You have installed and configured Raneto on your Void Linux system. You can now start creating your wiki content and make it accessible to your users.