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:
parent
0da26ab197
commit
105884ca4e
3 changed files with 44 additions and 6 deletions
1
.gitignore
vendored
1
.gitignore
vendored
|
@ -3,3 +3,4 @@ nitter
|
||||||
*.db
|
*.db
|
||||||
/tests/__pycache__
|
/tests/__pycache__
|
||||||
/tests/geckodriver.log
|
/tests/geckodriver.log
|
||||||
|
/tmp
|
||||||
|
|
45
README.md
45
README.md
|
@ -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.)
|
||||||
|
|
|
@ -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
|
Loading…
Reference in a new issue