Differences

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

--- installation [2017/11/16 07:31] – dstillman
+++ installation [2023/02/15 13:57] (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 11: / Line 10: @@
 Open the .dmg you downloaded and drag Zotero to the Applications folder. You can then run Zotero from Spotlight, Launchpad, or the Applications folder and add it to your Dock like any other program.
+After installing Zotero, you can eject and delete the .dmg file.
 === Windows ===
@@ Line 18: / Line 19: @@
 === Linux ===
-Linux users may wish to use a package for their distro rather than using the tarball directly. If you download the tarball, unzip it and run ''zotero'' from that directory to start Zotero.
+== Official Tarball ==
-Alternatively, on Ubuntu, move the directory to a location of your choice, run the bundled ''set_launcher_icon'' script (which will update the included desktop file with the full path to the bundled Zotero icon), and then double-click ''Zotero'' (which may display as ''zotero.desktop'' initially). You can also symlink ''zotero.desktop'' to ''~/.local/share/applications/'' to add it to your 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 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 ==
+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]].
 ==== How do I upgrade to a new version? ====
-Zotero should be updated automatically by default, or you can go to the Help menu and select "Check for Updates…" to check manually. You can also always manually install a new version of Zotero over your existing version without losing any data.
+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 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.
+If something still isn't working, [[getting_help#step_3post_to_the_zotero_forums_really_it_works|let us know in the Zotero Forums]].