obstack-org/obstack

ObStack

ObStack

ObStack is an open source tool allowing a user to fully dynamically configure data object types, and manage the objects and data as suited. Both object configuration and data can be fully managed by a web interface or API. This allows ObStack to be used as CMDB / Configuration manager, asset manager, content manager, deployment manager, a quick and simple management portal or whatever application that may seem fit.

For more information visit https://www.obstack.org.

Project goals

• Functionality
• Flexibility
• Simplicity
• Security
• Open Source

There are a lot of great open source tools available for CMDB, Asset management and so on, capable of creating complex systems and supplying advanced features. However, in some cases an advanced and complex system is not required, and all you need is a simple and straight forward tool. The goal of the ObStack project is to try and fill a gap between spreadsheet sharing and the available more advanced solutions, and providing an interface for other solutions as suited along the way.

Installation

As one of ObStack's goals the installation is easy to setup using a basic linux webserver setup with PostgreSQL, as described below.

Obstack also supplies a docker image and a docker-compose script for easy deployment.

Requirements

• Linux server
• Web server (Apache2, NGINX)
• PHP >= v7.4 with packages: pdo pdo_pgsql session mbstring json ldap
• PostgreSQL >= v11 with packages: contrib
   or: MySQL >= 5.7 / MariaDB >= v10.2 ^(*)

Basic example (AlmaLinux8/Rocky8)

Note:
The security and credentials used in this example is for test and/or demo purposes only. For other usage configure your security accordingly.

# Install packages
sudo dnf -y module disable php postgresql
sudo dnf -y module enable php:7.4 postgresql:12
sudo dnf -y install httpd php php-pdo php-pgsql postgresql-server postgresql-contrib git

# Setup Apache2
sudo setsebool -P httpd_can_network_connect_db on
sudo systemctl enable httpd && sudo systemctl start httpd
sudo firewall-cmd --permanent --zone=public --add-service=http
sudo firewall-cmd --permanent --zone=public --add-service=https
sudo firewall-cmd --reload

# Setup PostgreSQL
sudo postgresql-setup --initdb
sudo sed -i '/^# TYPE/a\\n# ObStack\nhost\tobstack\t\tobstack\t\t127.0.0.1/32\t\tmd5\nhost\tobstack\t\tobstack\t\t::1/128\t\t\tmd5' /var/lib/pgsql/data/pg_hba.conf
sudo systemctl enable postgresql && sudo systemctl start postgresql
sudo -u postgres bash -c "cd; createdb obstack; psql -c \"CREATE USER obstack WITH PASSWORD 'obstack'; GRANT CONNECT ON DATABASE obstack TO obstack;\""

# Setup ObStack
cd /var/lib
sudo git clone "https://github.com/obstack-org/obstack.git"
sudo -u postgres psql obstack </var/lib/obstack/resources/obstack-schema-pgsql-v1.2.0.sql
sudo -u postgres bash -c "cd; psql obstack -c \"GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO obstack; GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public TO obstack;\""
sudo ln -s /var/lib/obstack/webapp /var/www/html/obstack
sudo mkdir -pm 750 /etc/obstack
cp /var/lib/obstack/resources/obstack.conf /etc/obstack/
chown -R root:apache /etc/obstack

Now login to your new installation on http://yourserver/obstack with default authentication: admin/admin.

Documentation

Main documentation:

• General
  • Installation
  • Configuration
• API Reference
  • /auth
  • /objecttype
  • /valuemap

For the full documentation please visit https://www.obstack.org/docs/.