Differences

This shows you the differences between two versions of the page.

--- installation [2020/10/27 14:02] – dstillman
+++ installation [2024/11/18 23:32] (current) – [How do I install Zotero?] dstillman
@@ Line 3: / Line 3: @@
 ==== Where do I download Zotero? ====
-You can download Zotero on the [[/download/|Zotero download page]]. Be sure to also install a Zotero Connector for your browser.
+You can download Zotero on the [[/download/|Zotero download page]]. Be sure to also install the Zotero Connector for your browser.
 ==== How do I install Zotero? ====
@@ Line 20: / Line 19: @@
 === Linux ===
-Download the tarball, extract the contents and run ''zotero'' from that directory to start Zotero.
+== Official Tarball ==
-For Ubuntu, the tarball includes a .desktop file that can be used to add Zotero to the launcher. Move the extracted directory to a location of your choice (e.g., ''/opt/zotero''), run the ''set_launcher_icon'' script from a terminal to update the .desktop file for that location, and symlink ''zotero.desktop'' into ''~/.local/share/applications/'' (e.g., ''ln -s /opt/zotero/zotero.desktop ~/.local/share/applications/zotero.desktop''). Zotero should then appear either in your launcher or in the applications list when click the grid icon ("Show Applications"), from which you can drag it to the launcher.
+Download the tarball, extract the contents, and run ''zotero'' from that directory to start Zotero.
-Alternatively, Linux users may wish to use a package for their distro (e.g., [[https://github.com/retorquere/zotero-deb|zotero-deb]] for Debian/Ubuntu-based systems) rather than using the tarball directly. Note that such packages are built by third parties, and we can only provide support for the official tarball if you encounter package-specific problems.
+For Ubuntu, the tarball includes a .desktop file that can be used to add Zotero to the launcher:
+  - Move the extracted directory to a location of your choice (e.g., ''/opt/zotero'').
+  - Run the ''set_launcher_icon'' script from a terminal to update the .desktop file for that location. .desktop files require absolute paths for icons, so ''set_launcher_icon'' replaces the icon path with the current location of the icon based on where you've placed the directory.
+  - Symlink ''zotero.desktop'' into ''~/.local/share/applications/'' (e.g., ''ln -s /opt/zotero/zotero.desktop ~/.local/share/applications/zotero.desktop'')
+Zotero should then appear either in your launcher or in the applications list when you click the grid icon ("Show Applications"), from which you can drag it to the launcher.
+You may need to re-run ''set_launcher_icon'' after certain Zotero updates. If something isn't working, it may help to remove the current symlink (''~/.local/share/applications/zotero.desktop''), wait a few seconds for Zotero to disappear from the launcher, and recreate it.
+== Debian/Ubuntu-based Distros ==
+A longtime community member maintains [[https://github.com/retorquere/zotero-deb|zotero-deb]], a lightweight wrapper for the official tarball that uses ''apt'' for installation and updates. If you're not comfortable installing tarballs or are having trouble following the above instructions, this is what we recommend using.
+== Other Packages ==
+Unofficial packages are also available for various distros, but note that such packages are built by third parties, and we can only provide support for the official tarball and zotero-deb. In particular, third-party packages may be sandboxed, breaking various functionality.
+== Chromebook ==
 To set up Zotero on a Chromebook, see [[kb:installing_on_a_chromebook|Installing on a Chromebook]].
@@ Line 32: / Line 49: @@
 Zotero should update itself automatically by default, or you can go to the Help menu and select "Check for Updates…" to check for updates manually. You can also always manually install a new version of Zotero over your existing version without losing any data.
-If you're currently running Zotero 4.0 for Firefox and wish to upgrade to Zotero 5.0, you'll need to install Zotero 5.0 from the [[/download|download page]] along with the new Zotero Connector for Firefox. See [[/blog/a-unified-zotero-experience/|A Unified Zotero Experience]] for more information.
+==== Troubleshooting ====
+If you're running older software, check the [[system requirements]] to be sure Zotero is compatible with your system.
+If something still isn't working, [[getting_help#step_3post_to_the_zotero_forums_really_it_works|let us know in the Zotero Forums]].