Installation Guide
Install Athens
Open the Releases page.
Click on the Assets tab for the latest release.
Find the next section of this page appropriate for your operating system.
Windows
- Download
Athens-Setup-1.0.0-[VERSION].exe
. - Double-click it to run it.
- The installer will run and then launch Athens, at which point it should be available in your Start menu.
- At this point, you can delete the file you downloaded in step 1.
OS X
If your OS X computer contains an M1 chip (i.e. was purchased during or after November 10, 2020), you can download either Athens-1.0.0-[VERSION]-arm64-mac.zip
or Athens-1.0.0-[VERSION]-arm64.dmg
.
If your OS X computer contains an Intel chip (i.e. was purchased between January 2006 and early November 2020), you can download either Athens-1.0.0-[VERSION]-mac.zip
or Athens-1.0.0-[VERSION].dmg
.
If you download a .zip
file:
- Double-click it to have Archive Utility automatically extract it into the same folder.
- Move the extracted
Athens
application into yourApplications
folder.
If you download a .dmg
file:
- Double-click it to mount it.
- Find the mounted image on your desktop and double-click it to open it.
- Drag the contained
Athens
application into yourApplications
folder. - Right-click the mount on your desktop and select the
Eject
option.
At this point, you can delete whichever file you downloaded.
Linux
The Linux release is a standalone AppImage executable.
Download
Athens-1.0.0-[VERSION].AppImage
.Change permissions of the file to make it executable, e.g. run the following command in a terminal from the directory containing the file.
chmod a+x Athens-1.0.0-[VERSION].AppImage
Execute the file.
Post-installation
Finding where Athens stores your data
By default, Athens opens an initial knowledge graph that's stored in a local file called index.transit
, which is a datascript database at rest. The index.transit
file and every other file in the folder, minus the backup (.bkp
) files, make up the Athens database.
To find the location of this file for your operating system, click the Choose Database icon in the top-right corner of the Athens window.
The file location appears in the Open tab that's displayed by default.
Importing an existing database
If you've used Roam and want to bring your content into Athens, see documentation on [Athens import features].
Creating a new database
To create a new database in a different location, click the New tab, enter a database name, and click the Browse button to select a directory to house the database files.
Syncing your data between machines
If you need to edit your knowledge graph from multiple machines or on different networks, you have two choices:
- Use a file synchronization tool like Dropbox or OneDrive. While Athens warns you about updated blocks coming from these tools, you should take care not to edit the same database from multiple machines at the same time.
- The Athens backend is in the process of being refactored into the main Athens git repository (see this issue for details), but until that effort is completed, the existing archived backend can be used.
Updating Athens
Athens will automatically download new releases and use them when restarted. As such, it's a good idea to restart Athens periodically.
Note that there may be issues with this automatic update feature in Windows; see this issue for details.