Configuring IMPS

Configure database settings and IMPS directories in the imps_config.toml file located in the root of your IMPS install.

imps_config.toml

## DATABASE CONNECTION
[database]
host = 127.0.0.1
name = box_db
user = box_user
password = box_pass

## DIRECTORIES
imps_ip = 127.0.0.1
imps_dir = /var/www/
item_image_dir = /static/images/items/
backup_dir = static/backup

## PASSWORD
[password]
password = imps

The Control Panel

The IMPS control panel allows you to see various IMPS settings and to perform some management tasks that don't otherwise fit into the overall IMPS interface.

The control panel contains four tabs:

Settings

You can add, delete, and modify categories using the Categories button. If you rename a category, all items assigned to that category will be assigned to the renamed category. If you delete a category, all items assigned to that category will be assigned to the "Uncategorized" category instead. The "Uncategorized" category itself can't be renamed or deleted.

You can add, delete, and modify locations using the Locations button. If you rename a location, all boxes assigned to that location will be assigned to the renamed location. If you delete a location, all boxes assigned to that location will be assigned to the "Unspecified" location instead. The "Unspecified" location itself can't be renamed or deleted.

The Views button lets you choose which columns (photo, date, category, box number, and the information mouse-over column) are shown in the desktop list views, and how many items are shown per page in the inventory, category, and search-result lists (25, 50, or 100). These are per-browser preferences, so they can be set differently on each device you use IMPS from.

Backups

IMPS can backup your items (the tables from the database) and the photos associated with them. The Backups tab provides buttons to create these backups and to download them. IMPS automatically keeps the 5 most recent backups of each kind (database and photos) and deletes older ones once that limit is exceeded.

Cleanup

When you delete a box, you can delete all the items in the box from the database, reassign all the items to a new box, or "orphan" the items, which means they have no box assigned to them. While these items will still show in the search, inventory, and category views, this tool provides an easy way to see all these items in one place. Clicking Show orphaned items will show a list of all items which are not assigned to a box.

IMPS is designed to remove item photos when items are deleted or to delete the old item photo when a new one is uploaded. However, the control panel contains a tool to check for photos that are not linked to an item and delete them. While rare, this can sometimes occur if there is a database connection problem when editing or deleting an item.

Server

This tab shows a read-only view of the IMPS configuration from the imps_config.toml file.