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 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 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 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
Atom stores configuration and state in a
.atom directory usually located in your home directory (
%userprofile% on Windows). You can however run Atom in portable mode where both the app and the configuration are stored together such as on a removable storage device.
To setup Atom in portable mode download the zip/tar.gz package for your system and extract it to your removable storage.
Then create a
.atom directory alongside the directory that contains atom.exe, for example:
Then create a
.atom directory alongside the Atom.app application, for example:
Then create a
.atom directory alongside the directory that contains the Atom binary, for example:
.atomdirectory must be writeable
.atomdirectory to your portable device
.atomdirectory - just create a subdirectory called
ATOM_HOMEenvironment variable to point wherever you want (you can write a .sh or .cmd script to temporarily set it and launch it from that)
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.