Running in Linux Mac without Docker

Installing

Note: To run on Linux/Mac, Gaps requires Java 11. OpenJDK 11 can be downloaded here or Oracle Java here

Download the latest release of Gaps as a Jar, found on the releases page.

Extract the zip file where you want to run Gaps.

On Linux

Create and change the folder permissions so that Gaps can read, write, and delete in it.

Run ./startOnLinuxAndMac.sh -f {storageFolder} 

For help run

Run ./startOnLinuxAndMac.sh -h 

Open your preferred browser and navigate to http://localhost:8484

On Mac

Download the latest application-custom.yml file from master

In

/Applications/GapsAsJar/application-custom.yml

change the following:

storageFolder: /Applications/GapsAsJar/data #Change to folder that gaps has permission to read, write, and delete in.

in

~/Library/LaunchAgents

create the file:

org.user.gaps.plist

with the following content:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
	<key>EnvironmentVariables</key>
    	<dict>
        	<key>PATH</key>
        	<string>/Library/Java/Home/bin:$PATH</string>
    	</dict>
		<key>WorkingDirectory</key>
    	<string>/Applications/GapsAsJar</string>
        <key>Label</key>
        <string>org.user.gaps.plist</string>
        <key>ProgramArguments</key>
          <array>
            <string>/usr/bin/java</string>
            <string>-Dspring.config.location=classpath:file:application-custom.yml</string>
            <string>-Dspring.profiles.active=custom</string>
            <string>-jar</string>
            <string>gaps.jar</string>
         </array>
        <key>RunAtLoad</key>
            <true/>
        <key>KeepAlive</key>
            <true/>
        <key>StandardErrorPath</key>
            <string>logs/gaps-launchd.log</string>
        <key>StandardOutPath</key>
            <string>logs/gaps-launchd.log</string>
    </dict>
</plist>

Save it then start Gaps with

# launchctl load org.user.gaps.plist

Open your preferred browser and navigate to http://localhost:8484