atom-fedora-20.adoc

Using Atom on Fedora 20

This guide walks you through the steps of building and launching the Atom text editor on Fedora 20.

Building Atom

1. Install prerequisite packages

   $ sudo yum -y install node npm libgnome-keyring-devel

2. Install Chrome (needed for libudev.so.0)

   $ sudo sh -c 'cat > /etc/yum.repos.d/google-chrome.repo <<EOS
   [google-chrome]
   name=google-chrome
   baseurl=http://dl.google.com/linux/chrome/rpm/stable/x86_64
   enabled=1
   gpgcheck=1
   gpgkey=https://dl-ssl.google.com/linux/linux_signing_key.pub
   EOS'
    sudo yum -y install google-chrome-stable

3. Upgrade npm locally (Fedora packages 1.3.6, but version 1.4 is required)

   $ cd ~
     npm install npm

4. Ensure the local npm bin location is on your PATH

   $ export PATH="$HOME/node_modules/.bin:$PATH"

5. Open a new terminal window to reset the path to npm

   $ npm --version
   # 1.4.10

6. Uninstall gyp package (which also removes npm and node-gyp) to avoid gyp / node-gyp conflicts

   $ sudo yum -y remove gyp

   Note	For more information about this problem, see issue #2029.

7. Clone the Atom repository and switch to it

   $ git clone https://github.com/atom/atom
     cd atom

8. Build Atom (writes to build and /tmp/atom-build)

   $ ./script/build

   Note	Disregard any compiler or npm warnings.

9. Make the atom binary executable

   $ chmod +x /tmp/atom-build/Atom/atom

10. (Optional) Reinstall the node-gyp package (if needed for system operations)

    $ sudo yum -y install node-gyp

Launching Atom

$ LD_LIBRARY_PATH=/opt/google/chrome ./atom.sh

Relocating the Atom installation

If you want to relocate the Atom installation outside of the /tmp directory, run the following commands:

$ mkdir -p ~/apps/atom/share
  mv /tmp/atom-build/Atom ~/apps/atom/share/atom
  cp atom.sh ~/apps/atom/share/

Now you can run Atom using the following command:

$ LD_LIBRARY_PATH=/opt/google/chrome ~/apps/atom/share/atom.sh

Write code!