Ivory is an open-source project designed to simplify and visualize work with Postgres clusters. Initially, this tool was developed to ease the life of developers who maintain Postgres. But I hope it will help manage and troubleshoot Postgres clusters for both developers and database administrators.
Ivory allows you to use it as a local tool in your personal computer or as a standalone tool in a separate virtual machine for collaborative usage, and helps you:
- keep all of your clusters in one place
- provides UI for all main features of patroni
- view and edit cluster config
- simply execute and save template requests for troubleshooting
- check and clean bloat
- Start the docker container
- Docker Hub
docker run -p 80:80 --restart always aelsergeev/ivory - GitHub Container repository
docker run -p 80:80 --restart always ghcr.io/veegres/ivory
- Docker Hub
- Go to http://localhost:80
- Do the initial configuration (Ivory will guide you)
- Add your first cluster (by providing name and instances)
- Start monitoring :)
Unfortunately, Ivory doesn't guaranty backward compatability between minor and major releases, path releases are questionable, but usually they contain only bug fixes and some small improvements. You can always check in the security page backward compatibility between versions. Hence, we recommend to install it from scratch for minor and major releases. There is some plans to introduce import/export to simplify this process. How to migrate data between containers with different version? You can find below.
All Ivory data is located inside /opt/data directory. Ivory has a docker volume, it means that you won't
lose it if your container are going to be rebooted. But you need to consider mount this directory to your
local disk if you want to save the data between different containers
--mount type=bind,source=YOUR_LOCAL_PATH,target=/opt/data, or you can mount volume of the
old container to the new one by docker flag --volumes-from
Ivory can work with or without authentication. It will ask you to configure it in the initial start. Right now Ivory supports only Basic authentication with general username and password (maybe in the future support will be added for such things like ldap / sso) Usually you don't want to use authentication when you work with Ivory locally, but it is recommended to use it if you use it in some VMs.
If you're interested in contributing to the Ivory project, consider these options:
