How to Install SWAG on Void Linux

SWAG (Secure Web Application Gateway) is an application that provides SSL/TLS encryption for web applications. In this tutorial, we will guide you through the steps to install SWAG on Void Linux.

Prerequisites

Before installing SWAG, you need to have Void Linux installed on your system. You can download the latest version of Void Linux from the official website.

Step 1: Installing Docker

The first step to installing SWAG is to install Docker on your system. Docker is a containerization engine that allows you to run applications in containers without affecting the host system. Here's how to install Docker on Void Linux:

1. Open the terminal and run the following command to update the package list:

   sudo xbps-install -S

2. Install Docker by running the following command (you may be prompted to enter your password):

   sudo xbps-install -S docker

3. Start the Docker service by running the following command:

   sudo ln -s /etc/sv/docker /var/service

4. Verify the installation by running the following command:

   sudo docker run hello-world

   This command will download a sample Docker image and run a container. If everything is working correctly, you will see a message indicating that Docker is running.

Step 2: Installing SWAG

After installing Docker, you can now proceed with installing SWAG on your system. Here's how to do it:

1. Open the terminal and create a directory for SWAG by running the following command:

   mkdir swag

2. Navigate to the newly created directory by running the following command:

   cd swag

3. Download the SWAG Docker image by running the following command:

   sudo docker pull linuxserver/swag

   This command will download the latest SWAG image from Docker Hub.

4. Create a configuration file for SWAG by running the following command:

   touch docker-compose.yml
   nano docker-compose.yml
   

5. Paste the following configuration into the file:

   version: "3"
   services:
     swag:
       image: linuxserver/swag
       container_name: swag
       cap_add:
         - NET_ADMIN
       environment:
         '-e PUID=1000'
         '-e PGID=1000'
         '-e TZ=Europe/London'
         '-e URL=example.com'
         '-e SUBDOMAINS=www,'
         '-e VALIDATION=http'
         '-e AUTO_INSTALL_CERTS=true'
         '-e STAGING=false'
         '-e ONLY_SUBDOMAINS=true'
         '-e [email protected]'
       volumes:
         - ./config:/config
         - /etc/localtime:/etc/localtime:ro
       ports:
         - '80:80'
         - '443:443'
       restart: unless-stopped
   

   Note: Modify the environment variables accordingly to fit your configuration.

6. Press CTRL + O to save the changes and CTRL + X to exit Nano.

7. Run the following command to start the SWAG container:

   sudo docker-compose up -d

   This command will start the container in detached mode, allowing you to use the terminal while the container is running.

Step 3: Accessing SWAG

After installing and running SWAG, you can access it by opening a web browser and entering the URL specified in the environment variables of the docker-compose.yml file. For example, if your URL is example.com, you can access SWAG by entering https://example.com.

Conclusion

In this tutorial, we have shown you how to install SWAG on Void Linux. With SWAG, you can provide SSL/TLS encryption for your web applications, making them secure and safe to use.