To get started with Atom, we'll need to get it on your system. This section will go over installing Atom on your system as well as the basics of how to build it from source.
Installing Atom should be fairly simple. Generally, you can go to https://atom.io and at the top of the page you should see a download button as shown here:
The button or buttons should be specific to your platform and the download package should be easily installable. However, let's go over them here in a bit of detail.
Atom follows the standard Mac zip installation process. You can either press the download button from the https://atom.io site or you can go to the Atom releases page to download the
atom-mac.zip file explicitly. Once you have that file, you can click on it to extract the application and then drag the new
Atom application into your "Applications" folder.
When you first open Atom, it will try to install the
apm commands for use in the terminal. In some cases, Atom might not be able to install these commands because it needs an administrator password. To check if Atom was able to install the
atom command, for example, open a terminal window and type
which atom. If the
atom command has been installed, you'll see something like this:
which atom /usr/local/bin/atom $
atom command wasn't installed, the
which command won't return anything:
which atom $
To install the
apm commands, run "Window: Install Shell Commands" from the Command Palette, which will prompt you for an administrator password.
Atom is available with a Windows installer that can be downloaded from https://atom.io or from Atom Releases named
AtomSetup.exe. This setup program will install Atom, add the
apm commands to your
PATH, create shortcuts on the desktop and in the start menu, add an "Open with Atom" context menu in the Explorer and make Atom available for association with files using "Open with...".
Atom can also be run in portable mode on Windows allowing it to be placed on a removable storage device where it will also store its settings, packages, cache, etc. so you can easily take it from machine to machine without needing to install anything.
To get started with Atom in portable mode:
atom-windows.zipfrom Atom Releases
atom-windows.zipto your removable storage device
.atomfolder to be alongside your Atom folder on your removable storage device
Now whenever you launch
atom.exe from your removable storage device it will operate in portable mode and store all its settings and packages in the
.atom folder on the device.
Note that there are some limitations to portable mode:
.atomfolder must be alongside the folder containing
atom.exe(not inside it)
.atomfolder must be writeable
ATOM_HOMEenvironment variable must not be set (this overrides portable behavior)
Atom is also available in an .MSI package from Atom Releases which can be deployed or installed on a machine. Any user signing in to that machine will find Atom installed for them automatically. (It may take a few seconds the first time they sign in for the icon to appear on the desktop).
Should the user uninstall Atom it will only affect themselves and it will not automatically reinstall when they next sign in. If eventually that individual wants to reinstall Atom again, they can delete the
To install Atom on Linux, you can download a Debian package or RPM package either from the main Atom website or from the Atom project releases page. These packages do not currently have auto-update features, so when you would like to upgrade to a new release of Atom, you will have to repeat this installation process.
To install Atom on Debian, Ubuntu, or related systems:
# Install Atom sudo dpkg -i atom-amd64.deb # Install Atom's dependencies if they are missing sudo apt-get -f install
To install Atom on CentOS, Oracle Linux, RedHat Enterprise Linux, Scientific Linux or related systems that use the yum package manager:
sudo yum install -y atom.x86_64.rpm
To download and install the latest release of Atom on Fedora or other systems that use the DNF package manager:
sudo dnf install -y atom.x86_64.rpm
To download and install the latest release of Atom on openSUSE or other systems that use the Zypp package manager:
sudo zypper in -y atom.x86_64.rpm
If you just want to build Atom from source, you can also do that. The Atom GitHub repository has detailed build instructions for Mac, Windows, Linux and FreeBSD.
If you are behind a firewall and seeing SSL errors when installing packages you can disable strict SSL by running:
apm config set strict-ssl false
If you are using a HTTP(S) proxy you can configure
apm to use it by running:
apm config set https-proxy YOUR_PROXY_ADDRESS
You can run
apm config get https-proxy to verify it has been set correctly.