Install rimstone

How to install Golf

There are three ways to install Golf, pick one that works for you:

From a zipped file (.tar.gz):

wget "https://github.com/rimstone/rimstone/archive/refs/heads/main.tar.gz" -O main.tar.gz
tar xvfz main.tar.gz
cd rimstone-main
./gginst.sh
. $HOME/.bashrc

Copied!

If you use git, from its official GitHub repo (depth is 1 for performance and to save space):

git clone --depth 1 git clone --depth 1 https://github.com/rimstone/rimstone.git
cd rimstone
./gginst.sh
. $HOME/.bashrc

Copied!

If there's a Golf package installed on your system, from a package. First, install-package, then:
```
cp /usr/share/golf/golf.tar.gz .
tar xvfz golf.tar.gz
cd golf
./gginst.sh
. $HOME/.bashrc
```
Copied!

Note that $HOME/.bashrc is run at the end so you can use Golf in the current session without re-logging.

Notes about installation

- Permissions and install script
Golf is installed in a home directory (either in a separate user account or in your own home directory). Minimum permissions (required and set by the installation) for home directory are 711 (allowing access to specific sockets but no read, write or directory listing permissions).

- sudo privilege
Golf itself does not require sudo as it installs in a local ".golf" folder. You may however need sudo privilege to install standard Open Source toolkit libraries (such as MariaDB, SQLite, PostgreSQL, XML, Regex, Curl, OpenSSL etc), base libraries (such as gcc, make etc.; and only if not installed already, which they usually are), or SELinux support (if you use it). They are system-wide by nature and require sudo.

- Installing toolkit libraries
The default installation (above) will ask you if you'd like to install the above toolkit packages, You can install them if and when you need them, or you can install them now; you will need sudo privilege to do that. If you'd like to install all base and toolkit packages automatically now, then use the following (instead of just ./gginst.sh above):

./gginst.sh all

Copied!

- SELinux
If you have SELinux enabled then you'll need to install SELinux support for Golf. This requires sudo privilege because it involves setting Operating System permissions for Golf. This will be done automatically during the installation.

If you don't want or need SELinux support, you can set permissive mode before installing Golf with:

sudo setenforce 0

Copied!

in which case you won't need to install SELinux support.

- Upgrading/downgrading Golf
To either upgrade or downgrade Golf, first uninstall and then install (see above). Look for release notes for any given version at Golf blog for more information about any changes that may affect your Golf application(s).

- Uninstall Golf
Here's how to uninstall.

Try Golf

Go to 123-hello-world for your Hello World.