Differences

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

--- installation [2022/08/13 04:11] – [Where do I download Zotero?] dstillman
+++ installation [2023/02/15 13:57] (current) – [How do I install Zotero?] dstillman
@@ Line 4: / Line 4: @@
 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.
+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.
 == Debian/Ubuntu-based Distros ==
-A longtime community member maintains [[https://github.com/retorquere/zotero-deb|zotero-deb]], a lightweight wrapper for the official tarball.
+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 having trouble following the above instructions, this is what we recommend using.
 == Other Packages ==
@@ Line 39: / Line 46: @@
 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.
+==== 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]].