Validating Atom's installation and build instructions for Ubuntu


#1

As I promised @faddah, I created a VM to test Atom’s installation and build instructions for Ubuntu. This is what I found. I did my best to document every step of the way so that if there is some miscommunication or misunderstanding it can be found quickly and corrected.

  • Brand new Ubuntu 14.04 installed in a VM
  • Customizations
    • Switched to Dvorak keyboard layout (doubtful that this has an impact on the test other than it is the preferred keyboard layout of the tester)
  • Shut down VM and snapshot taken

Installation

Instructions

  1. Download atom-amd64.deb from the Atom releases page.
  2. Run sudo dpkg --install atom-amd64.deb on the downloaded package.
  3. Launch Atom using the installed atom command.

Experience

  1. Boot up
  2. Log in
  3. Launch Firefox
  4. Download https://github.com/atom/atom/releases/download/v0.141.0/atom-amd64.deb
  5. Open Terminal
  6. cd ~/Downloads
  7. sudo dpkg --install atom-amd64.deb
  8. atom
  9. Take Screenshot

Cleanup

  1. Shut down VM

  2. Snapshot taken

  3. Original snapshot restored

  4. Start VM

  5. Open Terminal

  6. Execute atom command

    Atom command failed as expected

Build

Instructions

  1. sudo apt-get install build-essential git libgnome-keyring-dev fakeroot

  2. Instructions for Node.js

    curl -sL https://deb.nodesource.com/setup | sudo bash -
    sudo apt-get install -y nodejs
    
  3. Clone the Atom repository:

    git clone https://github.com/atom/atom
    cd atom
    
  4. Checkout the latest Atom release:

    git fetch
    git checkout $(git describe --tags `git rev-list --tags --max-count=1`)
    
  5. Build Atom:

    script/build
    

    This will create the atom application at $TMPDIR/atom-build/Atom.

  6. Install the atom and apm commands to /usr/local/bin by executing:

    sudo script/grunt install
    

    To use the newly installed Atom, quit and restart all running Atom instances.

Experience

  1. Launch VM

  2. Log in

  3. Open Terminal

  4. sudo apt-get install build-essential git libgnome-keyring-dev fakeroot

  5. curl -sL https://deb.nodesource.com/setup | sudo bash - → Curl wasn’t installed, install using recommended command

  6. sudo apt-get install curl

  7. curl -sL https://deb.nodesource.com/setup | sudo bash -

  8. sudo apt-get install -y nodejs

  9. Create Source directory — Not explicitly necessary, but I like things clean

    mkdir Source
    cd Source
    
  10. Clone the Atom repository:

    git clone https://github.com/atom/atom
    cd atom
    
  11. Checkout the latest Atom release:

    git fetch
    git checkout $(git describe --tags `git rev-list --tags --max-count=1`)
    

    Got warning that I was in DETACHED HEAD state.

  12. Build Atom:

    script/build
    

    Done, without errors.

  13. Install the atom and apm commands to /usr/local/bin by executing:

    sudo script/grunt install
    

    Done, without errors.

  14. Execute atom command

  15. Take Screenshot

Conclusion

Given a clean install and faithful execution of the installation or build instructions. Atom works as expected. Improvements can still be made, but should probably be placed in an “advanced” or “unvalidated options” section or category.


Need help - ubuntu linux 14.04 LTS w/ xfce4 Atom build error - grunt file expecting Node in another directory
Cannot run atom from Bash (Windows 10)
#2

Thanks for the detailed instructions. I installed Atom over the weekend myself on a new Elementary OS Luna installation, which is based on Ubuntu 12.04. I had no problems. I just want to mention that here is a node.js ppa available, if you are in to that kind of thing.

Slightly off topic, do you know if Atom was submitted to Ubuntu’s repos so that we can use apt-get or a package manager?


#3

As I stated here:

There currently is no official Atom PPA. You can subscribe to this Issue for updates though:


#4

Thanks. A launchpad account was set up here: https://launchpad.net/~atomeditor . I will bookmark for later.