How to Install Wallabag on Fedora CoreOS Latest

Wallabag is an open-source self-hosted bookmarking app that allows users to save web content for later reading without any ads or limitations. It can be installed on various operating systems, including Fedora CoreOS. This tutorial will guide you on how to install Wallabag on your Fedora CoreOS latest.

Step 1: Install Docker & Docker Compose

Before installing Wallabag, you need to install Docker and Docker Compose. Follow the steps below to install them on your Fedora CoreOS:

1. Open a terminal window by pressing CTRL+ALT+T or searching for the Terminal app in the applications menu.

2. To install Docker, run the following command:

$ sudo curl -L "https://get.docker.com" -o /usr/local/bin/docker && sudo chmod +x /usr/local/bin/docker

3. Verify that Docker is installed correctly by running the following command:

$ sudo docker --version

4. The output should show you the version of the installed Docker, like below:

Docker version 20.10.3, build 48d30b5

5. Install Docker Compose using the following command:

$ sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && sudo chmod +x /usr/local/bin/docker-compose

6. Verify that Docker Compose is installed correctly by running the following command:

$ sudo docker-compose --version

7. The output should show you the version of the installed Docker Compose, like below:

docker-compose version 1.29.2, build unknown

Step 2: Install Wallabag

After installing Docker and Docker Compose, you can proceed with installing Wallabag on your Fedora CoreOS. Follow the steps below:

1. Create a new directory where you will store Wallabag's data and configuration files. Run the following command:

$ sudo mkdir -p /opt/wallabag/{config,data}

2. Change the ownership of the newly created directory to the current user:

$ sudo chown -R $USER:$USER /opt/wallabag/{config,data}

3. Create a new file docker-compose.yml using the following command:

$ nano docker-compose.yml

4. Paste the following content into the file and save:

version: "3.8"
services:
  wallabag:
    image: wallabag/wallabag
    container_name: wallabag
    environment:
      - SENTRY_RELEASE=2.4
      - APP_ENV=prod
      - APP_SECRET=GenerateYourOwnSecretKeyHere
      - SYMFONY_ENV=prod
      - PUID=$(id -u)
      - PGID=$(id -g)
      - WALLABAG_URL=http://localhost:8080
      - MAILER_URL=null://localhost
      - WALLABAG_ADMIN_LOGIN=admin
      - WALLABAG_ADMIN_PASSWORD=GenerateYourOwnAdminPasswordHere
      - TZ=UTC
    ports:
      - "8080:80"
    volumes:
      - /opt/wallabag/data:/var/www/wallabag/data
      - /opt/wallabag/config:/var/www/wallabag/config
    restart: always

5. In the APP_SECRET environment variable, generate your own secret key by running the following command:

$ openssl rand -hex 32

6. In the WALLABAG_ADMIN_PASSWORD environment variable, generate your own password by running the following command:

$ openssl rand -base64 12

7. Save the changes using the key combination CTRL+X, Y, and ENTER.

8. Start the Wallabag Docker container by running the following command:

$ sudo docker-compose up -d

9. Wait for the Docker container to start and check if it is running successfully by running the following command:

$ sudo docker ps -a

10. The output should show you the Wallabag Docker container with a status of Up, like below:

CONTAINER ID   IMAGE                        COMMAND                  CREATED          STATUS          PORTS                         NAMES
f742116b7520   wallabag/wallabag:latest    "/entrypoint.sh php-…"   50 seconds ago   Up 49 seconds   0.0.0.0:8080->80/tcp, 443/tcp   wallabag

11. Access Wallabag by opening your web browser and entering the following URL:

http://localhost:8080/

12. You should see the Wallabag login page. Enter the username admin and the password you generated in Step 6.

13. Follow the on-screen instructions to set up your Wallabag account.

Conclusion

In this tutorial, you have learned how to install Wallabag on your Fedora CoreOS latest by installing Docker and Docker Compose, creating a new directory for Wallabag's data and configuration files, and starting a Wallabag Docker container using Docker Compose. You have also learned how to generate your own secret key and admin password using the openssl command.