Interchange

Interchange is a web application server, electronic catalog and database display system.

Features include:

• online ordering
• real-time payment processing integration
• high-level database access and retrieval with SQL support
• product categorizing, merchandising, and discounting
• basic customer relationship management
• dynamic content presentation
• content management
• internationalization and localization support
• real-time tax and shipping hooks
• reporting
• web-based administration

Licensed under GPLv2. This program is offered without warranty of any kind. See file LICENSE for redistribution terms.

Copyright © 2002-2026 Interchange Development Group
Copyright © 1996-2002 Red Hat, Inc.
Originally based on Vend 0.2 and 0.3, copyright 1995-96 by Andrew M. Wilcox.

Comprehensive developer documentation lives in docs/: guides covering architecture, configuration, ITL templating, databases, ordering, payment, and administration, a catalog-building tutorial, and reference pages for every configuration directive, tag, filter, widget, order check, pragma, and payment module. Start at docs/README.md.

More information is in the following files:

Notes on using Interchange when installed from RPM packages.

Notes on using Interchange when installed from Debian packages.

How to run the demo catalog in a Docker container.

How to track ongoing development of Interchange.

Changes per specified version family.

Instructions on how to upgrade from an earlier Interchange version.

Older documentation sets (the Akopia-era manuals and the xmldocs project) predate docs/ and are superseded by it; where they disagree with docs/ or with the code, trust the code. Project news, mailing lists, and a live demo are at the Interchange home on the web:

https://www.interchangecommerce.org/

Major files and directories in the distribution:

Script to create a Makefile, used for installation. Run ./configure for usage instructions.

The distribution files, exclusive of executable files and modules. Includes:

• code/ - Usertags and other customizable code
• interchange.cfg.dist - Distribution-default interchange.cfg
• lib/ - Back-end administrative interface
• src/ - C and Perl code for CGI link programs
• strap/ - Demo catalog skeleton, used by makecat

Various helper scripts and addons.

OS-specific configuration settings.

The library modules needed to run Interchange.

Script that adjusts paths in scripts/ for installation into bin/.

The executable files, relocated to bin/ in the install directory.

The installation test script.

Interchange requires Perl 5.16.3 or later, on a Unix-like operating system. It is primarily used on various Linux distributions, and has also been used on FreeBSD, OpenBSD, macOS, and other Unix variants.

Interchange requires some extra Perl modules to be installed on your system. Unless you are installing from distribution-specific packages (Red Hat, Debian, etc.) the quick way to install the necessary support is to run from the Interchange source directory:

cpanm --installdeps .

Alternatively, you can run:

perl -MCPAN -e 'install Bundle::Interchange'

If you would like to use a specific installation of Perl, invoke Perl with an absolute path to the perl binary, such as

/usr/local/bin/perl -MCPAN -e 'install Bundle::Interchange'

You can install Interchange as root for a multi-user system-wide setup, or as an unprivileged user who will be the only one modifying Interchange files.

Get the source by cloning the Git repository. Versioned release tarballs are no longer produced regularly, so the repository is the authoritative source for current Interchange. Clone somewhere other than ~/interchange, which is the default install directory — see README-DEVELOPMENT.md for notes on tracking development.

Here is the quick installation summary:

git clone https://github.com/interchange/interchange.git
cd interchange
perl Makefile.PL
make
make test
make install

If you would like to use a specific version of Perl, simply invoke with an absolute path to the perl binary, such as:

/usr/local/bin/perl Makefile.PL

The build procedure asks where you’d like to install Interchange and the name of the user account that will own the installation.

The Interchange server doesn’t do much if it isn’t servicing one or more actual catalogs, so you next need to make your first Interchange catalog, as described in the next section.

There is a demo catalog skeleton called strap included.

To build your own catalog from the demo, go to the directory where you installed Interchange (default is "interchange" in your home directory, /usr/local/interchange for root installations, or /usr/lib/interchange for RPM installations) and run:

bin/makecat

Follow the prompts and after restarting the Interchange server you should be able to access the new instance of the demo catalog.

Please note that some functionality (notably the reporting features) may not be available if you are not using an SQL database such as MySQL, PostgreSQL, or SQLite.

Try a live demo at: https://www.interchangecommerce.org/i/dev/demo