{"id":20935747,"url":"https://github.com/ghostery/ghostery-browser-linux-support","last_synced_at":"2025-05-13T20:33:04.810Z","repository":{"id":41320707,"uuid":"446806347","full_name":"ghostery/ghostery-browser-linux-support","owner":"ghostery","description":"Ghostery Browser on Linux (installer and Linux-specific documentation)","archived":true,"fork":false,"pushed_at":"2024-12-06T12:46:42.000Z","size":298,"stargazers_count":9,"open_issues_count":0,"forks_count":2,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-02-19T07:17:37.990Z","etag":null,"topics":["ghostery","ghostery-browser","linux"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ghostery.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2022-01-11T12:11:14.000Z","updated_at":"2024-12-06T16:07:44.000Z","dependencies_parsed_at":"2023-09-29T10:46:57.402Z","dependency_job_id":null,"html_url":"https://github.com/ghostery/ghostery-browser-linux-support","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghostery%2Fghostery-browser-linux-support","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghostery%2Fghostery-browser-linux-support/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghostery%2Fghostery-browser-linux-support/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghostery%2Fghostery-browser-linux-support/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ghostery","download_url":"https://codeload.github.com/ghostery/ghostery-browser-linux-support/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254021428,"owners_count":22000916,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ghostery","ghostery-browser","linux"],"created_at":"2024-11-18T22:16:12.509Z","updated_at":"2025-05-13T20:33:04.801Z","avatar_url":"https://github.com/ghostery.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Ghostery Browser Linux Support\n\n:warning: **Important Notice: The project is no longer maintained**\n\nWe regret to inform you that the Ghostery Private Browser has reached its end of life and will no longer receive security updates. For your safety, we strongly recommend switching to a secure alternative like Firefox.\n\nFor more information, please refer to our blog post: [Sunsetting the Ghostery Private Browser](https://www.ghostery.com/blog/ghostery-private-browser-discontinued).\n\n---\n\ntl;dr: If you want to install [Ghostery Private Browser](https://www.ghostery.com/ghostery-private-browser) on Linux, here are your options:\n\nOn Arch-based distros such as Arch Linux, Manjaro, and EndeavourOS, [use the AUR package](#aur):\n\n```sh\nyay -S ghostery-browser-bin\nghostery \u0026\n```\n\nAlternatively, use the [Flatpak image](#flatpak). It is supported on all Linux distributions (assuming that `flatpak` is installed):\n\n```sh\nflatpak --user remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo\nflatpak --user install com.ghostery.browser\n\nflatpak --user run com.ghostery.browser  # to run it\n```\n\nAUR or Flatpak is recommended now, but you can also use the [install script](#installscript):\n\n```sh\ncurl https://raw.githubusercontent.com/ghostery/ghostery-browser-linux-support/main/install-ghostery.sh | bash\n```\n\nIt will install the browser in your local user directory.\n\n# Table of contents\n1. [Introduction](#introduction)\n1. [Flatpak](#flatpak)\n1. [AUR installation for Arch-based system (e.g. Arch Linux, Manjaro): ](#aur)\n    1. [(Optional) Firejail](#aur-firejail)\n1. [Install script for all distros (e.g. Debian, Ubuntu, Mint, Fedora)](#installscript)\n1. [Troubleshooting](#troubleshooting)\n    1. [Missing dependencies](#missing-dependencies)\n    1. [Broken fonts on OpenSUSE](#suse)\n1. [(dev only) Vagrant test setup](#vagrant)\n\n### Introduction \u003ca name=\"introduction\"\u003e\u003c/a\u003e\n\nThis is a meta project, which provides an install guide of the Ghostery\nBrowser for Linux in the form of an install script.\n\nThe sources of browser itself can be found in the main repository,\nwhich can be found here:\n[user-agent-desktop](https://github.com/ghostery/user-agent-desktop).\n\nIf you have generic questions about the Browser itself, please create Github\ntickets on the `user-agent-desktop` project. But if you run into Linux-specific\nproblems, or if you have difficulties with the installation, feel free to\nopen a ticket here (instead of `user-agent-desktop`).\n\n### Flatpak \u003ca name=\"flatpak\"\u003e\u003c/a\u003e\n\nFlatpak package: https://flathub.org/apps/com.ghostery.browser\n\nYou can install it using the following commands (the first one has to be used\nonly once if you never added the flathub repository).\n\n```sh\nflatpak --user remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo\nflatpak --user install com.ghostery.browser\n```\n\nIf flatpak is correctly integrated into your desktop environment, you will\nfind the Ghostery Private Browser in your applications menu. You can also\nstart it from the command line by using the simple command\n`com.ghostery.browser`.\n\nIn the contrary, if you did not integrate flatpak inside your desktop, you can\nstill run it from the command line by using the command:\n\n```sh\nflatpak --user run com.ghostery.browser\n```\n\nIf you want to contribute, more information on the Flatpak package can be found\nin its dedicated [README](flatpak/README.md).\n\n### AUR: Arch Based System (Arch Linux, Manjaro, ...) \u003ca name=\"aur\"\u003e\u003c/a\u003e\n\nIf you are on an Arch-based system, which uses `pacman` as the package manager,\nit is recommended to use the [AUR package](https://aur.archlinux.org/packages/ghostery-browser-bin/).\n\nFor a documentation how to use AUR, refer to the documentation of your distribution:\n\n* Arch: https://wiki.archlinux.org/title/Arch_User_Repository\n* Manjaro: https://wiki.manjaro.org/index.php/Arch_User_Repository\n\nFor instance, if you are using [`yay`](https://github.com/Jguer/yay):\n\n```sh\nyay -S ghostery-browser-bin\n```\n\nNow you can start it by running:\n\n```sh\nghostery\n```\n\n#### (Optional) Firejail Setup \u003ca name=\"aur-firejail\"\u003e\u003c/a\u003e\n\nThe AUR comes with a setup for [Firejail](https://firejail.wordpress.com/).\nIf you want to use it, follow the post-install instructions:\n\n```sh\nsudo pacman -S firejail\nfirejail ghostery\n```\n\nIf you want, you can make it permanent:\n\n```sh\nsudo ln -s /usr/bin/firejail /usr/local/bin/ghostery\n```\n\nNow running `ghostery` will have the same effect as running\n`/usr/bin/firejail /usr/bin/ghostery`.\n\n### Generic Install Script \u003ca name=\"installscript\"\u003e\u003c/a\u003e\n\nIn this repository, you will find `install-ghostery.sh`, which automates\nthe steps to download the latest binary build and install it for your\nlocal user (in `~/.local/opt` and `~/.local/bin`).\n\nBy default, this script will download and install the english version of the\nbrowser. But you can pass a lang code as argument to download another version\nof it (currently, only fr, de and en-US versions are available):\n`./install-ghostery.sh de`\n\nOnce the installation finishes, you should be able to start the browser\nby executing: `ghostery` (or as a fallback: `~/.local/bin/ghostery`).\n\nIf want to undo the changes made by the installer, you can execute:\n\n```sh\nrm -rf ~/bin/ghostery ~/.local/bin/ghostery ~/.local/opt/ghostery/Ghostery ~/.local/share/applications/ghostery-private-browser.desktop\n```\n\n### Troubleshooting \u003ca name=\"troubleshooting\"\u003e\u003c/a\u003e\n\n#### Missing dependencies \u003ca name=\"missing-dependencies\"\u003e\u003c/a\u003e\n\nIt is possible that the Ghostery Browser will not start because dependencies\nare missing. As it is a fork of Firefox, it should typically work if you install\nFirefox to get all required dependencies:\n\n```sh\nsudo apt-get install firefox      # Ubuntu / Mint\nsudo apt-get install firefox-esr  # Debian\nsudo yum install -y firefox       # Fedora\n```\n\nIn addition, the installer itself requires `bzip2`, and either `wget` or `curl` to be present.\n\n*For Arch/Manjaro Users*: this section only applies when you used the install script.\nIf you are using the AUR, it should automatically install all dependencies. If not,\nplease report it as bug on the\n[AUR page](https://aur.archlinux.org/packages/ghostery-browser-bin/),\n(and please include the error message).\n\n#### OpenSUSE \u003ca name=\"suse\"\u003e\u003c/a\u003e\n\nCurrently, OpenSUSE is not well supported. Starting with OpenSUSE 15.3, the\nbrowser is able to start, but there  an issue with the fonts.\nIn older versions (15.2 or earlier), it will not start because the glibc\nlibrary is too old (needs to be 2.28).\n\n### Vagrant Test Setup \u003ca name=\"vagrant\"\u003e\u003c/a\u003e\n\nThe rest of the document targets developers: it explains the included Vagrant setup, which can be used to test the installation on various Linux distributions. It includes a ssh setup with X11 forwarding, so you can start the browser by logging in.\n\nYou should install [Vagrant](https://www.vagrantup.com/) and [VirtualBox](https://www.virtualbox.org/). As a quick check, you can try to bring up a Ubuntu machine:\n\n```\nvagrant up ubuntu20.04\n```\n\nIt should finish the installation without errors. Once you are done, you can destroy it again:\n\n```\nvagrant destroy ubuntu20.04\n```\n\nFor more details, read the instructions in the Vagrantfile.\nBe careful when starting all machines at the same time (`vagrant up`), as it will require a lot of memory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghostery%2Fghostery-browser-linux-support","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fghostery%2Fghostery-browser-linux-support","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghostery%2Fghostery-browser-linux-support/lists"}