
Light, self-hosted open source applicant tracking system for simple company hiring.
Install Docker and Docker Compose and make sure the Docker server is running by using the command
docker info
Download the repository, you can do this via git or by downloading the zip file.
Prepare values for sensitive variables:
SECRET_KEY_BASE - a secret key for the application, example: "462d54c7b15dcc1924e797d0b28e6d"
POSTGRES_USER - a username for the PostgreSQL database, example: "postgres"
POSTGRES_PASSWORD - a password for the PostgreSQL database, example: "password"
Navigate to the project directory and start the application:
SECRET_KEY_BASE=<value> \
POSTGRES_USER=<value> \
POSTGRES_PASSWORD=<value> \
docker compose up -d
Open http://<your_server_ip>:3000/register and create an account.
To stop the running containers, use the following command:
docker compose stop
To remove the created images, containers and volumes, use the following commands:
docker compose down --volumes
docker rmi freeats-web
docker rmi postgres:15
This app currently supports only PostgreSQL.
Prepare values for sensitive variables:
SECRET_KEY_BASE - a secret key for the application, example: "462d54c7b15dcc1924e797d0b28e6d"
DATABASE_URL - a URL to the PostgreSQL database, example: "postgres://postgres:password@localhost:5432/freeats"
Navigate to the project directory and start the application:
DATABASE_URL=<database_url> \
SECRET_KEY_BASE=<value> \
docker compose -f app_with_external_db.yml up -d
To stop the running containers, use the following command:
docker compose -f app_with_external_db.yml stop
To remove the created images, containers and volumes, use the following commands:
docker compose -f app_with_external_db.yml down --volumes
docker rmi freeats-web
If you have an unstable internet connection, there may be errors. If this happens, restart the command that failed.
If you get the error address already in use, it is most likely
because port 5432 is being used by local PostgreSQL service.
It can be checked using command:
sudo lsof -i :5432
Local PostgreSQL service then can be stopped:
sudo systemctl stop postgresql
More details on stackoverflow.
If files with root permissions were created during the process, you can change them using the command
chmod -R 777 <file or directory name>