Install rimstone

How to install RimStone

There are three ways to install RimStone, 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
./riminst.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 https://github.com/rimstone/rimstone.git
cd rimstone
./riminst.sh
. $HOME/.bashrc

Copied!

If there's a RimStone package installed on your system, from a package. First, install-package, then:

cp /usr/share/rimstone/rimstone.tar.gz .
tar xvfz rimstone.tar.gz
cd rimstone
./riminst.sh
. $HOME/.bashrc

Copied!

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

Notes about installation

- Permissions and install script
RimStone 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
RimStone itself does not require sudo as it installs in a local ".rimstone" 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 ./riminst.sh above):

./riminst.sh all

Copied!

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

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

sudo setenforce 0

Copied!

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

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

- Uninstall RimStone
Here's how to uninstall.

Try RimStone

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