Skip to main content

Incognito

Access the world wide web! Incognito is a dynamic web proxy service stylized as a search engine.

Setup

Deployment

Terminal

Prerequisites:

  • Node & npm
  • Git
  1. Clone the repo:
git clone https://github.com/titaniumnetwork-dev/incognito && cd incognito
  1. Install all of the dependencies:
npm i
  1. Create a .env file
cp .env.example .env
  1. Modify the .env file to you liking (docs here)
nano .env
  1. Build the frontend:
npm run build
  1. Start the server
npm start

You can run npm run bstart to build and start together


Games

  • By default, games are reverse proxied by the server
    • Game assets are located here
  • To turn off Games, and access to them see #environment

Docker

Normal Docker

Prerequisites:

  • Git
  • Docker
  1. Clone the repo (skip if using prebuilt image):
git clone https://github.com/titaniumnetwork/incognito && cd incognito
  1. Create an .env file (if using prebuilt image, copy the example from the repo):
cp .env.example .env
  1. Modify the .env file to your liking (docs here)
nano .env
  1. Build the docker image (skip if using prebuilt):
docker build --build-arg BARE_SERVER_OPTION=true GAMES_LINK=true RAMMERHEAD_OPTION=true -t incog:latest

For info on the build arg check here

  1. Run the docker images:

    • Prebuilt:
    docker run --env-file ./.env motortruck1221/incognito:latest
    • Image you built yourself:
    docker run --env-file ./.env incog:latest

Docker Compose

Prerequisites:

  • Git
  • Docker w/compose
  1. Clone the repo (skip if using prebuilt image):
git clone https://github.com/titaniumnetwork-dev/incognito
  1. Create an .env file (if using prebuilt image, copy the example from the repo):
cp .env.example .env
  1. Modify the .env file to your liking (docs on that here]
nano .env
  1. Build the docker image (skip if using prebuilt):
docker compose -f ./docker-compose.build.yml build
  1. Run the docker image:

    • Prebuilt:
    docker compose up
    • Image you built yourself:
    docker compose -f ./docker-compose.build.yml up

Environment

  • There are a couple of environment variables for incognito. Most of the time, the defaults are fine, but there are instances where you may not want certain options enabled or certain things running.
VariableDescriptionDefault
MASQREnables (true)/Disables (false) Masqr (most people don't want this)false
BARE_SERVER_ENABLEDEnables (true)/Disables (false) the integrated bare server. Use this if you already have a server (e.g., reverse proxy) or don't want users accessing it.true
PORTThe port that the server listens on IGNORED IN THE DOCKER ENVIRONMENTS8080
GAMESDisable (false)/Enable (true) the reverse proxy for Gamestrue
RAMMERHEAD_SERVER_ENABLEDDisable (false)/Enabled (true) the integrated Rammerhead servertrue
SITEYour websites domain (eg: https://example.com)http://localhost:8080
BARE_SERVER_OPTIONEnables (true)/Disables (false) the option to use a bare server in the frontend. THIS IS A BUILD TIME ONLY VARIABLEtrue
GAMES_LINKEnables (true)/Disables (false) access to the games page BUILD TIME ONLYtrue
RAMMERHEAD_OPTIONEnabled (true)/Disables (false) the option to use Rammerhead in the frontend. BUILD TIME ONLYtrue