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.

Download the latest application-custom.yml file from master

In

/Applications/GapsAsJar/application-custom.yml

change the following:

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

and

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

Launch the browser to http://localhost:8484/ and configure.

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