Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Self-hosted Nunux Keeper

Your personal content curation service.

This project is an automated setup to configure and run a self-hosted instance of Nunux Keeper.



The installation is fully automated. Simply run the following commands on a Docker host:

git clone
cd keeper-docker
make deploy

This command will setup the following services:

Container's persistent data are located into the ./var directory. If you want to make a fresh installation from scratch don't forget to destroy this directory.


Uninstallation is as simple:

make undeploy


Configuration is located into the ./etc directory. Please check *.env files in order to see what parameters can you change to fit your needs. Beware that some parameters can break this automatic setup and should not be modified.

By default the application is configured to be hosted on http://localhost. If you want to change this you can edit the .env file.


Once started, Yous can access to those URL:

What is missing?

There is some missing parts not very useful for doing content curation. But you may be interested in:

  • Nunux Keeper Portal: The official Nunux Keeper web portal.
  • Nunux Keeper CLI: The CLI
  • Metrics production: Nunux Keeper is able to produce metrics to any StatsD collector. Then you can aggregate and visualize those metrics with some great tools like InfluxDB and Grafana.
  • Object Storage: Nunux Keeper is able to use a S3 compatible object storage (like Minio) to store documents attachments.
  • And a lot of operational stuff: monitoring, alerting, backups, etc.


If you have trouble to start Elasticsearch and you have the following message into your logs:

make logs service=elasticsearch

max virtual memory areas vm.max_map_count [65530] is too low, increase to atleast [262144]

You have to increase this system property and restart some services:

sudo sysctl -w vm.max_map_count=262144
make restart service=elasticsearch
make restart service=keeper-core-api
make restart service=keeper-job-worker

NUNUX Keeper

Copyright (c) 2016 Nicolas CARLIER (

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see