Unfetter Discover web application and container resources. Visit unfetter.io for more information about Unfetter projects.
We no longer support deployment on Windows systems. It is still possible with alterations, but we are focusing more on automated deployment through Ansible and scripts. And Windows Docker just works differently
Unfetter Discover is built up from multiple docker containers that are available on Docker Hub (https://hub.docker.com/u/unfetter/). All source code is in the unfetter-discover GitHub organization (https://github.com/unfetter-discover). We use Ansible (https://www.ansible.com/) for configuration and deployment for production use.
Its quick and simple to deploy a demo version of Unfetter with a single command. By Demo, we mean there is no user access controls.
mkdir unfetter-discover cd unfetter-discover git clone [email protected]:unfetter-discover/unfetter cd unfetter docker-compose up
It will take few minutes for the Docker images to download and build. Navigate to Unfetter Discover with Chrome or Firefox at https://localhost/
For production use, you will need to use ansible playbooks to configure the User Access Control. We tried to use Ansible variables to control the creation and generation of Unfetter.
mkdir unfetter-discover cd unfetter-discover git clone [email protected]:unfetter-discover/unfetter cd unfetter cd ansible
Investigate the hosts.ini file. There a number of host types availabe. Each host type has a different set of variables in the ansible group_vars. For most cases, under
[deployed] there shoudl be
Open the file unfetter/ansible/group_vars/production.yml. Change any variables that are necessary. The variables are currently set to support local deployment. To build onto a remote system, change to ansible_connection, ansible_host and ansible_ssh_private_key_file are necessary.
For a UAC version of Unfetter, you can use GitHub or GitLab out of the box. You can change the Autentication services in the file
unfetter-discover/unfetter/ansible/group_vars/uac.yml. To deploy so Unfetter Discover is accessible by others, you will need to change ui_domain and api_domain to point to the proper domain such as
You will need to make sure that there is an OAuth App for Unfetter Discover that is approved for use. When you build Unfetter, you will need to know the ClientID and the Client Secret. Look at Unfetter UAC Configuration for more instructions
To deploy, just run
Ansible will pull all the docker images from Docker Hub. You will be asked to enter your ClientID, Client Secret, and passwords.
Go to Unfetter at https://localhost/
You can find out more about our playbooks at ###TODO###