Use local tmp directory and enhance readme (#8)

* Use local tmp directory

* Enhance installation guide and add systemd service

* Apply suggestions

* Fix typo

* Drop start of systemd service as its done with --now
This commit is contained in:
Perflyst 2019-08-08 18:34:49 +02:00 committed by Zed
parent 0da26ab197
commit 105884ca4e
3 changed files with 44 additions and 6 deletions

1
.gitignore vendored
View file

@ -3,3 +3,4 @@ nitter
*.db *.db
/tests/__pycache__ /tests/__pycache__
/tests/geckodriver.log /tests/geckodriver.log
/tmp

View file

@ -13,16 +13,53 @@ Inspired by the [invidio.us](https://github.com/omarroth/invidious) project.
## Installation ## Installation
You need to install nim on your system: https://nim-lang.org/install.html
It is possible to install nim system wide or in the user directory you create below.
```bash ```bash
git clone https://github.com/zedeus/nitter # useradd -m nitter
cd nitter # su nitter
nimble build $ git clone https://github.com/zedeus/nitter
$ cd nitter
$ nimble build -d:release
$ mkdir ./tmp
``` ```
To run, `./nitter`. It's currently not possible to change any settings or things To run nitter, execute `./nitter`. It's currently not possible to change any settings or things
like the title, this will change as the project matures a bit. For now the focus like the title, this will change as the project matures a bit. For now the focus
is on implementing missing features. is on implementing missing features.
You should put nitter behind a reverse proxy with e.g. nginx or apache.
It is also possible to run nitter via systemd:
```bash
[Unit]
Description=Nitter (An alternative Twitter front-end)
After=syslog.target
After=network.target
[Service]
Type=simple
# set user and group
User=nitter
Group=nitter
# configure location
WorkingDirectory=/home/nitter/nitter
ExecStart=/home/nitter/nitter/nitter
Restart=always
RestartSec=15
[Install]
WantedBy=multi-user.target
```
Then enable and start
`systemctl enable --now nitter.service`
## Todo (roughly in this order) ## Todo (roughly in this order)
- Search (images/videos, hashtags, etc.) - Search (images/videos, hashtags, etc.)

View file

@ -5,5 +5,5 @@ title = "nitter"
staticDir = "./public" staticDir = "./public"
[Cache] [Cache]
directory = "/tmp/niter" directory = "./tmp"
profileMinutes = 10 # how long to cache profiles profileMinutes = 10 # how long to cache profiles