About Your Company Name Here | Sign In

   Browse projects

rBuilder for Users

Download and Install Complete Distributions

You can download and install a complete Conary-based system from the published releases of an rBuilder project. These releases may be referred to as distributions or software appliances depending on the nature of the project. Conary-based Linux distributions, such as rPath Linux, are available for free from rBuilder Online.

Use the Search text box at the top of the rBuilder web interface to find a project that has the release you want. Click the View Releases link in the Project Resources menu to see a list of the project's published releases, which are each fully installable Conary-based systems representing distributions or software appliances.

The release information displays the type of downloads available, such as raw hard disk images or installable CD/DVDs. Click the linked name of the release, and click Download to download for the image. For installable CD/DVD images, copy the images onto the appropriate media and use it to install your system.

Download and Install Individual Packages

If you are currently using a Conary-based system, and you are looking for software already packaged for Conary, find available packages in rBuilder and install them from their original project repositories.

Use the Search text box at the top of the rBuilder web interface to find a package that has the software you want. Click Browse Repository to navigate the list of individual packages in the project, each of which can be installed on an existing Conary-based system.

Click the linked package name in the Repository Browser to view package information, and locate the project label as part of the Version string listed in this information. The project label for a package with a version of /projectname.rpath.org@rpl:devel/1.1-1-1 is projectname.rpath.org@rpl:devel. As the root user of your Conary-based system, use the following command to install the package from rBuilder, replacing <package> with the package name and <project_label> with the project label: 

[user@host ~]# conary update <package>=<project_label>

Keep Software Updated

Keep your distributions and installed software packages updated using conary update. This command used with an installed package name will tell Conary to update the system to the latest version of that package in the rBuilder project's repository. As the root user on the Conary-based system, run the following command to update a package by name: 

[user@host ~]# conary update <package_name>

Use this command to update your entire system at one time:

[user@host ~]# conary updateall

Use the Conary QuickReference to reference this and other tasks used to maintain your Conary-based system.

Follow or Join a Project

While a Conary update for installed packages is automated, eliminating the need to visit a project in rBuilder, you may choose to watch the project in rBuilder or follow discussions in a project's mailing lists. rBuilder users can create a watch list available on the right side of each rBuilder page, and registered and unregistered users alike can subscribe to mailing lists and RSS feeds for the project.

As an rBuilder user, you may also wish to join a project to help out with testing, documentation, design, or to participate as a developer.

Create Your Own Project

rBuilder gives you the opportunity to create a new rBuilder project. Use your project to develop your own distributions using existing rBuilder packages or for incorporating new packaged software. Instructions for joining, participating in, and creating an rBuilder project is available in rBuilder's online documentation, and an introduction to packaging your own software for a project is available in the New Package Tutorial.

For detailed instructions on these rBuilder operations and more, see the rBuilder documentation at wiki.rpath.com.