mv12star/shitter repository overview

⁠Shitter - a Nitter fork⁠

A free and open source alternative Twitter front-end focused on privacy and performance.
Inspired by the Invidious project.

Page for the Docker image: https://hub.docker.com/r/mv12star/shitter⁠

⁠NOTE: The published image is multi-arch — mv12star/shitter:latest runs natively on amd64/armv7/arm64.

⁠Docker Compose

compose.yml⁠

Using docker-compose to run both Nitter and Redis as different containers: Change redisHost from localhost to nitter-redis in nitter.conf, then run:

docker-compose up -d

Note the Docker commands mount nitter.conf (and sessions.jsonl for docker-compose) from the directory you run them in. If a mounted file doesn't exist, Docker silently creates a directory in its place and the container fails with not a directory: Are you trying to mount a directory onto a file. Remove that directory and create the file as shown above.

⁠Docker CLI

To run Nitter with Docker, you'll need to install and run Redis separately before you can run the container. See below for how to also run Redis using Docker.

First create your config file. The Docker commands mount it into the container, so it has to exist on the host beforehand. If you've cloned the repo:

cp nitter.example.conf nitter.conf

If you're using the prebuilt image without a local clone, download nitter.example.conf⁠ and save it as nitter.conf instead.

To build and run Nitter in Docker:

docker build -t nitter:latest .
docker run -v $(pwd)/nitter.conf:/src/nitter.conf -d --network host nitter:latest

A prebuilt Docker image is provided as well:

docker run -v $(pwd)/nitter.conf:/src/nitter.conf -d --network host mv12star/shitter:latest